Data and File Paths

Data & File Paths

TypeWhisper for Linux keeps all of its state under your user-local application data directory. This page lists where each kind of data lives so you can find your settings, logs, plugins, and audio, and so you know what to copy when moving to a new machine.

Base path

TypeWhisper stores its Linux data under the user-local application data directory exposed by .NET:

• Base path: ~/.local/share/TypeWhisper on typical Linux setups

Everything below is relative to that base path unless otherwise noted.

What lives where

Path	Contents
settings.json	Your app settings (the JSON document edited through the settings UI).
Data/typewhisper.db	The local database, including transcription history.
Logs/	Application log files.
Plugins/	Installed and bundled plugins. See Plugins.
Audio/	Session audio captures (WAV).
Models/	Downloaded local transcription models. Excluded from settings backup (re-downloadable).
PluginData/	Per-plugin editable collections, stored under PluginData/<plugin-id>/.

Plugins are loaded from the user plugin directory at ~/.local/share/TypeWhisper/Plugins/ on typical Linux setups. Plugins that own user-editable collections (for example Webhook and Script) keep their entries under PluginData/<plugin-id>/ so those entries survive plugin reinstalls.

Other files outside the base path

A few integration files live under your XDG config and runtime directories rather than the app data directory:

Path	Purpose
~/.config/autostart/typewhisper.desktop	XDG autostart entry that launches TypeWhisper on login.
Control socket under $XDG_RUNTIME_DIR	Unix socket used for single-instance enforcement. When XDG_RUNTIME_DIR is unavailable, TypeWhisper falls back to a 0700 per-UID directory at /tmp/typewhisper-$UID. A second launch hands its CLI command off to the already-running instance over this socket instead of starting a new window.
~/.local/share/typewhisper/launcher-backups/	Backups of any non-owned user .desktop launcher files that the browser URL-detection integration patches, so the integration can be removed cleanly without losing your customizations.
~/.config/environment.d/typewhisper-accessibility.conf	Written by the Enable browser URL detection flow on Wayland; sets MOZ_ENABLE_ACCESSIBILITY=1 and GTK_MODULES=gail:atk-bridge for Firefox-family browsers.

Session audio cleanup

Session audio files are cleaned up on startup and shutdown. This means History retains the transcribed text without keeping WAV captures around indefinitely. If you want to keep a recording, use the Recorder page, which can save longer WAV captures (and an optional transcript sidecar text file) deliberately.

Related pages

• Backup & restore — what to copy to preserve your setup
• Plugins — how plugins are deployed and where their data is stored
• Troubleshooting — where to look when something is not working

---

Changelog

Date	Change
2026-06-17	Initial version.
2026-06-17	Added Models/ row (backup-excluded); refined control-socket /tmp fallback to /tmp/typewhisper-$UID.