| Platform | Status | Notes |
|---|
| Windows | Full support | NSIS and MSI installers available |
| Linux | In progress | Build from source; some features limited |
| macOS | Coming soon | Not yet available |
Window detection (used for context-aware App Profiles) is currently Windows-only. On other platforms, Trueears will transcribe without app-specific formatting.
Install Trueears
Download binary
Build from source
The easiest way to get Trueears on Windows is to download the latest installer from GitHub Releases.Steps:
- Go to the latest release page
- Download the installer for your preference:
Trueears_<version>_x64-setup.exe — NSIS installer (recommended)Trueears_<version>_x64_en-US.msi — MSI installer
- Run the installer and follow the prompts
- Launch Trueears from the Start Menu or desktop shortcut
The installer bundles a WebView2 bootstrapper, so Trueears works even on systems where WebView2 is not pre-installed.
Ctrl+Shift+S to open Settings and enter your Groq API key to start dictating. Prerequisites
| Requirement | Version | Notes |
|---|
| Node.js | v18+ | nodejs.org |
| Rust | Latest stable | rustup.rs |
| Visual Studio Build Tools | 2019+ | Windows only — includes Windows SDK |
Install Rust
winget install Rustlang.Rustup
Clone and install
git clone https://github.com/devv-shayan/Trueears.git
cd Trueears
npm install
Copy environment file
Build for production
This runs node scripts/sync-version.js then tauri build internally. The first build will take several minutes as Rust compiles all dependencies.Locate the output
After a successful build, installers are in:backend/target/release/bundle/
├── nsis/
│ └── Trueears_<version>_x64-setup.exe # Windows NSIS installer
└── msi/
└── Trueears_<version>_x64_en-US.msi # Windows MSI installer
To build a specific installer format only, run cd backend && tauri build --target nsis (or msi).
Environment variables
The workspace root .env is the centralized config for the frontend, backend, and payment service. Copy .env.example and fill in the values relevant to your setup:
# Auth server / backend
API_URL=https://trueears-backend.vercel.app
GOOGLE_CLIENT_ID=your_google_client_id
JWT_SECRET=change_me
# Payment service
PAYMENT_API_HOST=127.0.0.1
PAYMENT_API_PORT=3002
PAYMENT_DATABASE_URL=postgresql://user:pass@ep-example-123456-pooler.us-east-2.aws.neon.tech/neondb?sslmode=require&channel_binding=require
PAYMENT_REQUIRE_NEON=true
LEMONSQUEEZY_API_KEY=replace_with_real_key
LEMONSQUEEZY_STORE_ID=replace_with_store_id
LEMONSQUEEZY_WEBHOOK_SECRET=replace_with_webhook_secret
LEMONSQUEEZY_VARIANT_ID_BASIC=replace_with_basic_variant_id
LEMONSQUEEZY_VARIANT_ID_PRO=replace_with_pro_variant_id
IS_PRODUCTION=false
LEMONSQUEEZY_TEST_MODE=true
PAYMENT_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000,tauri://localhost
# Frontend
VITE_PAYMENT_SERVICE_URL=http://127.0.0.1:3002
VITE_LEMONSQUEEZY_VARIANT_ID_BASIC=
VITE_LEMONSQUEEZY_VARIANT_ID_PRO=
The Groq API key used for transcription is stored securely inside the app via @tauri-apps/plugin-store, not in .env. Configure it from Settings > Transcription after launch.
