Settings reference

Open, change and save#

Open Settings from the status bar or tray controls. Most edits are kept in a draft until you click Save. Cancel discards the ordinary pending settings edits. Actions such as downloading or deleting models, clearing history, forgetting a key and confirming Delete my data act separately; they are not undone by cancelling the settings window.

If Save is disabled, read the validation message under a numeric field. Invalid values are not silently clamped to an allowed number. Guided first-run setup is different: it saves each choice as you make it so the following step can use that choice.

Enlarge image ↗

The eight settings pages#

Main defaults#

Existing installations can retain migrated choices instead of these fresh-install defaults. Check the saved controls on your own PC.

Numeric ranges#

The recording limit is displayed in minutes and stored in seconds. Decimal input follows the current Windows culture, with an invariant-number fallback. A number outside its range shows a specific error before you can save.

Vocabulary JSON format#

A standalone vocabulary export uses three lists. Replacements have From and To; snippets have Trigger and Text. This example is a vocabulary file, not a complete settings file:

{
  "Spellings": [
    "TawkType",
    "HR",
    "API"
  ],
  "Replacements": [
    {
      "From": "see sharp",
      "To": "C#"
    }
  ],
  "Snippets": [
    {
      "Trigger": "project link",
      "Text": "https://example.com/project"
    },
    {
      "Trigger": "my signature",
      "Text": "Alex Morgan\nCustomer Support"
    }
  ]
}

The importer accepts property names without case sensitivity. Empty or incomplete entries are filtered; a file with none of the three populated lists is rejected. Import replaces the main vocabulary draft and requires Save to retain it. It does not merge mode-specific terms or change cloud permission.

Editing the settings file#

settings.json is a readable JSON representation of the application settings, with enum names stored as strings. Prefer the Settings window because it validates values and applies the change to the running app.

If you deliberately edit the file, close TawkType first and keep a backup. Malformed JSON can cause the app to load defaults. The current implementation does not provide a full transactional recovery and merge system for competing settings writes.

Do not place an API key in this file. The supported paths are the protected key field or the separate environment variable described in key storage.