Portable Data

Packaged Windows and Linux builds keep ASR Pro data beside the executable in asrpro-data/. macOS does the same when the app is outside a normal Applications folder.

TL;DR Portable Concept
Move the executable folder along with its sibling asrpro-data/ folder, and the application immediately carries models, text transcripts, preferences, and local databases with it.

Intent

ASR Pro is local-first. The app should be easily movable without scattering private transcription state or metadata across hidden operating system folders.

Goal Result
Keep models local Whisper model downloads stay under the app-owned local data folders.
Keep history local Transcript history, audio logs, session state, and Chromium local storage are stored in dedicated app paths.
Keep config local App parameters, window placement coordinates, startup launch preference, and editor paths stay in config/.
Predictable migration Moving the binary executable together with asrpro-data/ preserves all runtime data.

Data Folder Rules

Depending on the platform and runtime mode, ASR Pro resolves the root storage directory based on the executable's relative path:

Platform and Location Data Folder
Windows Packaged App Folder containing ASR Pro.exe plus sibling asrpro-data/
Windows Portable .exe Folder resolved from PORTABLE_EXECUTABLE_DIR plus sibling asrpro-data/
Linux Packaged App Folder containing the binary executable plus sibling asrpro-data/
macOS (Installed in Applications folder) Standard application support path: ~/Library/Application Support/ASR Pro/data/
macOS (Opened outside Applications folder) Folder containing ASR Pro.app plus sibling asrpro-data/
Development Workspace Local project directory at tmp/app-data/

What Lives Inside

The folders nested within the root data path hold specific dependencies and resources:

Folder Contents
asrpro-data/models/whisper/ Downloaded Whisper model binaries (e.g. ggml-base.en.bin).
asrpro-data/transcripts/ Flat text exports of completed transcripts.
asrpro-data/config/ JSON configuration files for preferences, hotkeys, and defaults.
asrpro-data/user-data/ Electron configuration and database files storing history.
asrpro-data/session/ Chromium session data, cookie jars, and caching.
asrpro-data/logs/ Standard output/error console log files.
asrpro-data/cache/ Native dependency compiler logs and temp files.

Move Checklist

Follow these steps to safely migrate your ASR Pro executable and data folder to a new drive, directory, or machine:

1
Close ASR Pro Fully quit the application from the desktop menu bar, system tray icon, or standard Window menu.
2
Move Directories Together Copy or move the main executable directory and the sibling asrpro-data/ folder together to the new destination.
3
Relaunch Application Launch ASR Pro from the new executable location. The app will resolve local paths relative to the new parent folder.
4
Refresh Startup Launch (Optional) If you configure ASR Pro to run at login, toggle the "Launch at startup" switch off and on under Configuration so the operating system updates the executable destination.