Microsoft Store
Signed, automatic updates, no security warning. The most convenient way to install WhisPaste.
Same app and core features as the free GitHub version; updates come through the store.
Mac App Store
Signed and reviewed by Apple, with automatic updates. The most convenient way to install WhisPaste on macOS.
Same app and core features as the free GitHub version; updates come through the store. The Mac App Store build leaves out two macOS-internal fallbacks (AppleScript-based pasting and the permission repair tool).
Linux
Direct download, no terminal required: make the AppImage executable and run it.
If it does not start, install libfuse2 (on Ubuntu 24.04: libfuse2t64) or run it with --appimage-extract-and-run. Right-click the file → Properties → Permissions → "Allow executing", then double-click to run.
Or the .deb package (Debian/Ubuntu)Which Linux file do I need? AppImage, .deb and tar.gz explained →Build from source instead?
WhisPaste is a Flutter app. Building from source needs Flutter and the speech-engine build step from BUILD.md.
Build from source instead?
WhisPaste is a Flutter app. Building from source needs Flutter and the speech-engine build step from BUILD.md.
WhisPaste is a Flutter app. Building it on Linux needs Flutter, plus one speech-engine build step for on-device Whisper.
Install Flutter
Follow the official Flutter install guide at flutter.dev. On most distributions a snap works well: `sudo snap install flutter --classic`. Run `flutter doctor` to verify the setup.
Clone the repository
Run `git clone https://github.com/whispaste/whispaste.git` in a terminal and change into the directory: `cd whispaste`.
Build and run
Run `flutter run -d linux` to build and launch WhisPaste. On-device Whisper also needs the speech-engine step `scripts/build-libwhisper-linux.sh` (see BUILD.md). Parakeet and cloud work without it.
Free from GitHub
Download the latest public release directly. Open source, transparent, and always free.
Important: SmartScreen warning
When downloading from GitHub, Windows may show security warnings. This is normal for new open-source software:
Important: SmartScreen warning
When downloading from GitHub, Windows may show security warnings. This is normal for new open-source software:
Browser blocks the download
Chrome or Edge may show "not commonly downloaded". Click the arrow (↑) or "…" menu next to the download bar, then select "Keep".
SmartScreen warning appears
When you run the installer, Windows may show "Windows protected your PC". Click "More info", then "Run anyway".
Install and run WhisPaste
Follow the installer steps. WhisPaste will be ready in seconds.
macOS
Download the latest macOS release directly from GitHub. Apple Silicon only (Intel Macs not supported).
After downloading, open the DMG and drag WhisPaste to your Applications folder.
If macOS blocks the app
Current DMGs are signed and notarized, so this should not happen. With an older download or a copy you built yourself, macOS may say "Apple cannot check it for malicious software."
If macOS blocks the app
Current DMGs are signed and notarized, so this should not happen. With an older download or a copy you built yourself, macOS may say "Apple cannot check it for malicious software."
Open Privacy & Security settings
Go to Apple menu → System Settings → Privacy & Security. Scroll down to the Security section.
Click "Open Anyway"
You will see a message about WhisPaste. Click "Open Anyway". This button is available for about one hour after the first launch attempt.
Confirm and enter your password
Click "Open Anyway" again in the confirmation dialog, then enter your Mac login password when prompted.
Why can this happen?
Releases are signed and notarized by Apple in the GitHub Actions build. Older downloads and self-built copies are not, and macOS shows this warning for any app it cannot verify. It does not mean the app is unsafe: the full source code is public.
Package managers
For power users: install and update WhisPaste straight from the terminal.
Package managers
For power users: install and update WhisPaste straight from the terminal.
Your package manager installs WhisPaste in a few commands and also takes care of later updates (scoop update whispaste, brew upgrade).
Windows
Never used this before?
If this program isn't installed on your computer yet, the official guide below shows you how to set it up. Official setup guide
macOS
Never used this before?
If this program isn't installed on your computer yet, the official guide below shows you how to set it up. Official setup guide
Speech service not starting?
Create a diagnostics report with our tool and send it to us. It helps us pinpoint the problem fast.
Speech service not starting?
Create a diagnostics report with our tool and send it to us. It helps us pinpoint the problem fast.
Download the diagnostics tool
Pick the build for your system below.
Run it
On Windows double-click the .exe; on macOS open the .dmg and double-click WhisPaste-Diagnose.app. It writes a report to your Desktop.
Send us the report
Attach the generated ZIP file from your Desktop to an email so we can read the speech-service environment and the model-load test result.
Send the report tocontact@whispaste.de
Why the warning?
Microsoft SmartScreen warns about any new software that hasn't built download reputation, regardless of whether it's safe. WhisPaste is fully open source and every release is built transparently through GitHub Actions.