Trueears registers system-wide hotkeys using Tauri’s global-shortcut plugin. These shortcuts are active as long as Trueears is running — even if the app window is minimized or not focused.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/devv-shayan/Trueears/llms.txt
Use this file to discover all available pages before exploring further.
Shortcuts reference
| Action | Windows / Linux | macOS |
|---|---|---|
| Start / stop recording | Ctrl+Shift+K | Cmd+Shift+K |
| Open Settings | Ctrl+Shift+S | Cmd+Shift+S |
| Cancel recording | Escape | Escape |
Escape to cancel recording is only registered while a recording is in progress. It is automatically unregistered when you are not recording, so it does not interfere with other applications.How global shortcuts work
When Trueears starts, it registersCtrl+Shift+K and Ctrl+Shift+S with the operating system via Tauri’s global-shortcut plugin. The OS intercepts these key combinations at the system level and routes them to Trueears regardless of which application has focus.
This means you can start a dictation session without switching away from your editor, chat window, or any other app — simply press the hotkey and start speaking.
- Windows / Linux
- macOS
Global shortcuts are registered through the Windows API (Win32) on Windows and through X11 on most Linux desktops.Wayland note: On Wayland compositors, Tauri uses the XDG Desktop Portal for shortcut registration. Support depends on your compositor and portal version. If shortcuts are not working on Wayland, check that
xdg-desktop-portal is installed and running.Troubleshooting hotkey conflicts
If a hotkey does not respond:Check for conflicts
Other applications may have claimed the same key combination. Common culprits include screen capture tools, password managers, and gaming overlays. Temporarily close other apps and test whether the shortcut works.
Check process elevation
If the foreground application is running with administrator or elevated privileges and Trueears is not, the OS may block hotkey delivery. Try running Trueears as administrator (Windows) or check the app’s sandbox permissions (macOS).
Verify Trueears is running
Confirm Trueears is active by checking the system tray for its icon. If the process has crashed, global shortcuts will not work.