Skip to content

Reset isoboard settings to the defaults

To reset isoboard, quit the app, move config.toml out of its folder and open the app again. isoboard creates a fresh file with the defaults and runs setup again. The reset keeps your History, downloaded models and saved Keychain items. This page is written for macOS.

Reset when isoboard shows one of these errors and you cannot fix the file by hand:

  • could not parse config <path>: ...
  • unsupported config version N; expected 1
  • unknown field followed by a name, which means the file has a setting that isoboard does not know
  • active profile "..." does not exist
  • duplicate profile name "..."
  • processing must contain at least one profile

isoboard keeps using the last valid configuration while the file on disk is invalid. At startup with an invalid file it runs with the defaults and does not overwrite your file. The error stays visible until the file is valid again. See the configuration file reference for what each value accepts.

Settings from early pre-release builds can also stop loading. isoboard does not migrate those older files.

  1. Quit isoboard. Choose Quit isoboard in the menu bar.
  2. In Finder, open the Go menu, choose Go to Folder and paste ~/Library/Application Support/app.isoboard/.
  3. Move config.toml to your Desktop as a backup. Move only this one file.
  4. Open isoboard again. It creates a new config.toml and opens the setup guide.
  5. Finish setup. See your first capture.

An empty config.toml is also a valid reset.

Reset Kept
Profiles, including Additional Rules and model choices History
Capture and open shortcuts Downloaded local models
Display mode (Basic, Advanced, Debug), Play sounds and overlay position Your license and evaluation records
Provider connections API keys in the Keychain, which are no longer connected

The provider connections live in config.toml, so after a reset you enter your API keys again on the Providers tab. Connecting a provider creates its starting Profiles again. The old Keychain items stay until you delete them. See uninstall isoboard.

Do not delete the other files in the folder to reset settings. They hold History, models and license data. Moving only config.toml leaves them untouched.

  1. Quit isoboard.
  2. Open config.toml in a text editor.
  3. Delete the [capture] and [shortcuts] sections, including any [[capture.bindings]] entries.
  4. Save the file and open isoboard. It loads the default shortcuts.

The defaults are ⌘ Cmd + ⇧ Shift + 2 for capture and ⌘ Cmd + ⌥ Option + Z for Open isoboard window. See keyboard shortcuts.

If setup is complete and you only want to see it again, open the Settings tab and select Restart initial setup below About. This changes no settings.

A settings reset does not touch macOS permissions. See fix capture and permission problems.

Does resetting delete my History?

No. History lives in its own database next to the configuration file. Moving config.toml does not touch it. See History.

Do I lose my downloaded isOCR model?

No. Models sit in a models folder beside config.toml, and a reset leaves them. After the reset, choose the model in a Profile again. See local models.