Skip to content
Searching: All docs

Start typing to search the docs.

User Data Folder

Supervertaler Workbench keeps your termbases, translation memories, prompt library, settings, and projects in a single user data folder. This folder is shared with Supervertaler for Trados, so both programs read and write the same terminology, TMs, and prompts without duplicating files.

Folder location

By default the folder lives in your home directory:

Windows: C:\Users\<YourName>\Supervertaler\
macOS / Linux: ~/Supervertaler/

You can choose a different location during first-run setup. The chosen path is recorded in a small pointer file in your user configuration directory, which both programs read so they always agree on where the data lives:

Windows: %APPDATA%\Supervertaler\config.json
macOS: ~/Library/Application Support/Supervertaler/config.json
Linux: ~/.config/Supervertaler/config.json

Folder structure

Supervertaler/
│
├── prompt_library/ Shared
│ ├── domain_expertise/
│ ├── project_prompts/
│ └── style_guides/
│
├── settings/ Shared
│ └── api-keys.json API keys (see Setting Up API Keys)
│
├── resources/ Shared
│ ├── supervertaler.db
│ ├── termbases/
│ ├── tms/
│ ├── non_translatables/
│ └── segmentation_rules/
│
├── snippet_library/ Workbench up to v1.10.373: Clipboard Manager snippets
├── text_conversion_library/ Workbench up to v1.10.373: Clipboard Manager text conversions
├── find_replace_sets/ Workbench: saved Find & Replace sets
├── vosk-models/ Workbench: speech models for Voice
│
├── workbench/ Supervertaler Workbench only
│ ├── settings/
│ │ ├── settings.json
│ │ ├── themes.json
│ │ ├── shortcuts.json
│ │ └── ...
│ ├── dictionaries/
│ ├── projects/
│ ├── backups/
│ ├── logs/
│ ├── ai_assistant/
│ ├── voice_scripts/
│ ├── superbrowser_profiles/
│ └── web_cache/
│
└── trados/ Supervertaler for Trados only
├── settings/
├── projects/
└── batch_backups/

Shared resources

The prompt library and resources folders are shared between both programs. A prompt you create or edit in Workbench is immediately available in the Trados plugin, and vice versa. The SQLite database (supervertaler.db) holds your termbases and translation memories – Workbench has full read-write access to it.

Program-specific folders

Each program stores its own settings, projects, and runtime data in a dedicated subfolder (workbench/ or trados/), so the two never interfere with each other. Workbench’s workbench/ subfolder holds your settings/, custom spellcheck dictionaries/ (including custom_words.txt), saved projects/, versioned project backups/ (see Backup), the diagnostic log (logs/supervertaler.log), AI assistant data, voice scripts, the SuperBrowser logins and a web cache.

A few Workbench libraries sit at the top level of the data folder: find_replace_sets/ (saved Find & Replace sets) and vosk-models/ (the speech models Voice downloads on first use). snippet_library/ and text_conversion_library/ hold the snippets and text conversions of the Clipboard Manager, which Workbench had until v1.10.373. Workbench no longer uses them but leaves them where they are, so you can copy what you need into Supervertaler Sidekick.

Settings files

Almost all of Workbench’s settings are in one file, workbench/settings/settings.json, with four sections: api_keys, general, ui and features. A few things have a small file of their own in the same folder:

FileHolds
themes.jsonYour custom colour themes
shortcuts.jsonYour keyboard shortcut changes
recent_projects.jsonThe recent projects list
find_replace_history.jsonFind & Replace search history
superlookup_history.jsonSuperLookup search history (older versions kept it in the shared settings/ folder; it is read from there once)
voice_commands.jsonYour voice commands

Older versions kept settings in separate files (such as general_settings.json and api_keys.txt). They are merged into settings.json automatically at startup and renamed with a .migrated extension.

Automatic migration

If you’re updating from an older version, Workbench reorganises the folder automatically on its next startup. No manual action is required – your settings and data are preserved.

🤖 These docs are AI-readable: llms.txt · full · Workbench only