Installation
Install Yap on Apple Silicon Macs, Windows x64, or Linux with the right package, runtime files, and desktop dependencies.
Download
The latest stable release is 0.5.0, including the Models Library. Use the download chooser for the installer and matching setup instructions. See release status for changes.
| Platform | Package | Compatibility |
|---|---|---|
| macOS | Yap-0.5.0-macOS.dmg | Apple Silicon (arm64), macOS 11 or later |
| Windows | Yap-0.5.0-Windows-Setup.exe | Windows 10/11, x64 |
| Windows portable | Yap-0.5.0-Windows-Portable.zip | Extract the whole archive; keep the runtime files |
| Linux, Ubuntu 22.04 family | ubuntu22.AppImage or ubuntu22.deb | x64; WebKitGTK 4.0 |
| Linux, Ubuntu 24.04 family | ubuntu24.AppImage or ubuntu24.deb | x64; WebKitGTK 4.1 |
The macOS release workflow builds arm64, not a universal binary. An Intel Mac cannot run this ARM build through Rosetta. Intel users need a separately built and tested Intel app and matching transcription runtime. Older release text claiming Intel support through Rosetta is incorrect.
macOS Installation
0.5.0 macOS releases are signed and notarized. Install with Homebrew:
brew install --cask applauselab/tap/yap
Or use the DMG:
- Download and open the DMG.
- Drag Yap to Applications, then launch it from there.
- If macOS blocks this downloaded app, review its source and use System Settings → Privacy & Security → Open Anyway for Yap.
- Complete the setup flow and grant Microphone and Accessibility permissions.
Release packages bundle PortAudio and the local Whisper runtime. Homebrew is for source builds, not a prerequisite for installing the DMG. Model files are downloaded separately.
Windows Installation
Installer
Run Yap-0.5.0-Windows-Setup.exe, follow the wizard, and launch Yap from the Start menu. Yap uses the Microsoft Edge WebView2 runtime; if the interface cannot open, check that WebView2 is installed.
Portable ZIP
- Extract all files into a permanent folder.
- Keep
Yap.exe,portaudio.dll, and thebindirectory together. - Run the extracted
Yap.exe, not the copy inside the ZIP.
Moving only the executable breaks its runtime dependencies. Portable means no installer; settings and recordings still live under %APPDATA%\yap, not next to the executable.
Enable microphone access for desktop apps in Windows privacy settings. See Windows permissions.
Linux Installation
Choose the package matching your distribution’s WebKitGTK version, rather than assuming every .deb works on every Debian derivative. Ubuntu 22.04 packages use libwebkit2gtk-4.0-37; Ubuntu 24.04 packages use libwebkit2gtk-4.1-0. Both also depend on GTK 3, PortAudio, and libgomp1.
AppImage
For Ubuntu 24.04, from your download directory:
chmod +x Yap-0.5.0-Linux-ubuntu24.AppImage
./Yap-0.5.0-Linux-ubuntu24.AppImage
Use the ubuntu22 filename on Ubuntu 22.04. If FUSE is unavailable, install your distribution’s FUSE 2 compatibility package or use the .deb instead. An AppImage still needs compatible system GTK/WebKit libraries.
Debian/Ubuntu (.deb)
Use apt so it can resolve package dependencies:
sudo apt install ./Yap-0.5.0-Linux-ubuntu24.deb
Launch Yap from your applications menu or run yap.
Desktop integration
The Linux global-hotkey implementation uses X11. Native Wayland support is not implemented; XWayland does not guarantee hotkeys or pasting into native Wayland apps. Use an X11 session for this workflow.
On Ubuntu/Debian, install the clipboard and paste helpers if absent:
sudo apt install xclip xdotool
If a terminal does not accept the simulated Ctrl+V, paste manually using its own shortcut.
Runtime and hardware
Local inference needs a compatible CPU and enough memory for the selected model. Start with Tiny or Base; downloads range from about 78 MB to 3.1 GB and runtime memory is additional. The bundled Windows/Linux x64 local runtimes require AVX2. See release status.
Continue with the quick start. For launch errors or missing libraries, use troubleshooting.