Installation

Current Platform Support

The current external launch target is the Windows desktop app.

| Platform | Current status | |---|---| | Windows 10 22H2+ / Windows 11 x64 | Current launch target | | macOS | Future platform; no signed, notarized distribution yet | | Linux | Future platform; no official package yet | | Android / iOS | Future app tracks; not current product entries |

Install on Windows

  1. Download VoSonar-0.3.0-setup.exe or the newer version shown on the Download page.
  2. Run the installer.
  3. Let the installer prepare runtime assets.
  4. Start VoSonar after installation completes.

Per-user install path:

%LOCALAPPDATA%\Programs\VoSonar\VoSonar.exe

User data path:

%APPDATA%\VoSonar\

This directory stores the local database, device identity, first-run state, settings, history, and local Rust Core storage/encryption files.

What the Installer Does

The current Windows installer is not the old MSI-oriented documentation flow. It:

  • Extracts and verifies the embedded core setup.
  • Checks local ASR, punctuation, VAD models, and ffmpeg.
  • Downloads missing runtime assets and writes %APPDATA%\VoSonar\runtime-assets-ready.json after verification.
  • Installs the main app and launches the first-run flow.

If asset download or SHA256 verification fails, download the installer again or retry on a stable network.

Update Checks

VoSonar uses prompted updates, not silent auto-updates.

The app reads an HTTPS release manifest containing version, download URL, SHA256, and installer size. Downloaded Windows installers are stored in:

%LOCALAPPDATA%\VoSonarUpdates\

VoSonar starts the installer and exits only after SHA256 verification passes.

Common Installation Issues

Windows Blocks an Unknown Publisher

Confirm that the installer came from the official VoSonar download page and verify the file name, version, and SHA256. Code-signing and download-distribution status should follow the download page and release acceptance record.

The Recording Engine Is Not Ready

This usually means the native library, models, or audio device are unavailable. Restart the app first. If the problem remains, check whether the installer completed runtime asset preparation.

Where Are the macOS and Linux Installers?

There are no official macOS or Linux installers in the current release. Old references to DMG, Deb, or AppImage packages do not represent current deliverables.