Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyprcore.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Advanced panel is for power users and people troubleshooting specific issues. Defaults work for most setups.

​
Paste behavior

  • Paste delay. Milliseconds Hyprcore waits between focusing the target app and simulating the paste keystroke. Increase if you’re seeing transcripts paste into the wrong app, or characters drop on slower machines. Default: 50 ms.
  • Clipboard handling. When pasting via clipboard:
    • Restore previous clipboard (default). Hyprcore copies the transcript, simulates Cmd-V, then restores whatever was in your clipboard before.
    • Don’t modify clipboard. The transcript stays in your clipboard for re-pasting. Useful when you want to dictate once and paste in many places.
  • Auto-submit key. After pasting, Hyprcore can simulate an additional key—Enter, Tab, etc. Useful for chat apps where the workflow is “type message → press Enter”. Default: none.

​
Models

  • Model unload timeout. Speech models stay loaded in memory after a transcription so the next one is fast. After the timeout, they’re unloaded to free RAM. Default: 60 seconds. Increase if you dictate frequently and have RAM to spare; decrease if you’re tight on memory.

​
Debug

  • Debug mode. Enables verbose logging to a file at ~/Library/Application Support/ai.hyprcore.desktop/logs/. Toggle from Settings or pass --debug on launch.
  • Keyboard implementation. Switch between Tauri’s built-in shortcut system and Hyprcore’s custom HandyKeys implementation. HandyKeys is the default and handles edge cases better; switch to Tauri only when troubleshooting a specific shortcut bug. Restart required.
  • Open log directory. Reveals the logs folder in Finder.
  • Open app data directory. Reveals ~/Library/Application Support/ai.hyprcore.desktop/ in Finder.

​
Recording retention

  • Dictation history retention. How long to keep dictation entries before auto-deleting. Days, weeks, months, or never.
  • Meeting recording retention. How long to keep meeting audio/video files. Transcripts are kept regardless. Default: never.

​
Debug mode

Debug mode enables an in-app debug menu and verbose logging. Open it with:
  • macOS: ⌘⇧D
  • Windows / Linux: Ctrl+Shift+D
The debug menu shows current state—loaded models, recording status, app data directory, version—and exposes commands not in the regular UI (force-reset, simulate errors, dump state). Most users never need it, but it’s the first thing to share when filing a bug report.

​
CLI flags

For full reference see Shortcuts → CLI and signals. 
hyprcore --start-hidden            # no main window on launch
hyprcore --no-tray                 # no menu bar icon
hyprcore --debug                   # verbose logging
hyprcore --toggle-transcription    # toggle dictation
hyprcore --toggle-post-process     # toggle dictation with post-processing
hyprcore --cancel                  # cancel current operation
hyprcore --help                    # show all flags
On macOS, the binary path inside the app bundle is /Applications/Hyprcore.app/Contents/MacOS/hyprcore.

​
Reset

Settings → Advanced → Reset everything is a nuclear option. It clears settings, deletes models, and prompts you to re-onboard. Your meetings, notes, and dictation history are not deleted—only Hyprcore’s own state. If you want to delete everything, quit Hyprcore and: 
rm -rf ~/Library/Application\ Support/ai.hyprcore.desktop/