Startup Launch

Set up ASR Pro to launch automatically at system login. Turning it on registers your current binary executable path, so you can easily repair the startup hook if you move your app.

TL;DR Startup Logic

ASR Pro registers with the system autostart registry, keeps the state in your local app config, and automatically rewrites the path hook if you re-toggle it from a new location.

Intent

The startup launch toggle makes auto-starting convenient for normal users while remaining easily repairable when running portable, local-first setups.

Behavior	Detail
Toggle On	Registers the current executable binary for startup at user login.
Toggle Off	Removes the saved autostart hook from the operating system.
Re-toggle on move	Overwrites and updates the system startup target with the new location.
Saved configuration	Preferences are written to `asrpro-data/config/app-settings.json`.

Where to Find It

You can toggle autostart directly from the app chrome interface:

Screen Tab	Section	Control Row
Configuration	Application	Launch at startup (with path verification indicator)

The toggle row inside the app displays the specific binary executable path that ASR Pro resolved.

Platform Behavior

ASR Pro uses standard Electron API wrappers to communicate with OS-specific startup autostart registries:

Operating System	Mechanism
Windows	Electron Registry launch key helper. Portable builds hook into the environment variable `PORTABLE_EXECUTABLE_FILE`.
macOS	Native Login Items registry binding to target the bundled `.app` container.
Linux	Writes standard autostart entry files to user configuration directories.

On Linux, ASR Pro writes an autostart desktop entry to $XDG_CONFIG_HOME/autostart/asrpro.desktop if the environment variable is set; otherwise, it defaults to ~/.config/autostart/asrpro.desktop.

Moving the App

If you relocate the application folder on your disk, follow this simple procedure to fix the startup shortcut:

Relocation Scenario	How to Repair
Windows folder moved	Run `ASR Pro.exe` from its new path, then toggle Launch at startup off and on again.
Linux executable moved	Run the binary from the new directory, then toggle Launch at startup off and on again.
macOS app relocated	Launch the relocated `ASR Pro.app` container, then toggle Launch at startup off and on again.
Startup points at an old file	Simply toggle off, then toggle on inside the running instance. The latest toggle rewrites the system link.

Boundaries

To keep the application sandboxed and transparent, ASR Pro limits its configuration footprints:

This does

Launches ASR Pro silently in the background at system boot.
Automatically corrects shortcut records when enabled from a new path.
Persists setting state directly inside your portable config file.

This does not

Sync transcription history or Whisper models between directories.
Physically move or mirror the asrpro-data/ directory itself.
Alter operating system security configurations or administrative credentials.