Skip to content

Backup and Restore

Chris Smashe edited this page Jun 17, 2026 · 4 revisions

Backup & Restore

TypeWhisper supports backing up and restoring your settings, so you can save your configuration and bring it back later or move it to another machine.

What it does

Settings backup and restore is a built-in feature of the Linux branch. It lets you capture your TypeWhisper configuration and restore it when needed.

The Back Up and Restore buttons live on the About page, in the Settings Backup card. Back Up opens a file-save dialog; Restore opens a file-open dialog. Both buttons are disabled while a backup or restore is running.

The Settings Backup card on the About page, with Back Up and Restore buttons

What's in a backup

A backup is a ZIP archive containing a typewhisper-backup.json manifest plus your data. Restoring a zip that is not a TypeWhisper backup (missing the manifest) is rejected.

Included:

  • settings.json, settings.json.bak, and linux-preferences.json
  • The Data/ and PluginData/ directories

Excluded: the Models, Audio, and Logs directories, and plugin binaries.

Restore writes the root files and the Data/ and PluginData/ directories back, and also restores the Plugins/ directory — an asymmetry with backup, which does not capture plugin binaries.

Note: after a restore, some restored settings may require an app restart to take effect.

Where your data lives

Knowing where TypeWhisper keeps its files is useful both for backups and for understanding what a restore affects. TypeWhisper stores its Linux data under the user-local application data directory, with settings.json holding your configuration.

For the full list of paths — settings, database, logs, plugins, audio, and plugin data — see Data and file paths.

Related pages


Changelog

Date Change
2026-06-17 Initial version.
2026-06-17 Added Settings Backup screenshot.
2026-06-17 Documented backup contents (included/excluded), the ZIP/manifest format, the Plugins restore asymmetry, the restart caveat, and that the buttons live on the About page.

Clone this wiki locally