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.

Hyprcore registers global shortcuts with macOS, so they fire from anywhere on your system—even when Hyprcore isn’t focused.

​
Configure your shortcut

Open Settings → Dictation. You’ll see two main bindings:
BindingWhat it does
Toggle dictationStart or stop a normal dictation session.
Toggle with post-processingSame as above, but always runs the post-processing template after the transcript.
Click the field, press your desired combination, and Hyprcore registers it. Common picks:
  • ⌘⇧Space (Cmd-Shift-Space)
  • ⌥Space (Option-Space)
  • F5 (if your function row is set to standard function keys)
  • ⌃` (Control-backtick)
Avoid ⌘Space. macOS reserves it for Spotlight, and Hyprcore can’t claim system-reserved combinations.

​
Toggle vs push-to-talk

In Settings → Dictation, toggle Push to talk to switch modes:
  • Push-to-talk on. Hold the shortcut to record. Release to transcribe. Best for quick interjections—a single sentence into Slack, a short search query.
  • Push-to-talk off (toggle). Press once to start, press again to stop. Best for longer, hands-free dictation—drafting a paragraph, narrating a doc.
You can use both bindings at once if you map them to different shortcuts. For example, ⌘⇧Space for quick toggles and the Globe key for hold-to-talk.

​
Paste behavior

Once Hyprcore has the transcript, it pastes into whichever app was focused when you started recording. Settings → Dictation → Paste method controls how:
MethodUse it when
Cmd-V (clipboard)Default. Copies the text to the clipboard, then simulates Cmd-V.
Direct typingThe target app blocks paste—some terminals and password fields. Slower for long text.
Shift-InsertCross-platform fallback.
Cmd-Shift-V (paste without formatting)Useful when target apps are aggressive about styling.
NoneHyprcore stops at “transcript saved.” Copy from history yourself.
Clipboard handling. By default, Hyprcore restores whatever you had copied before. Toggle Don’t modify clipboard in Advanced settings if you’d rather have the transcript stay in the clipboard for re-pasting.

​
Cancel a recording

Two ways to cancel before transcription runs:
  • Press Esc while the overlay is visible.
  • Map a third shortcut to Cancel in Settings.
A canceled recording is discarded—no transcript, no history entry, no audio file kept.

​
CLI and signals

Hyprcore exposes the same actions via the CLI and Unix signals, useful for window manager macros or scripts: 
hyprcore --toggle-transcription
hyprcore --toggle-post-process
hyprcore --cancel

pkill -USR2 -n hyprcore   # toggle dictation
pkill -USR1 -n hyprcore   # toggle dictation with post-processing
On macOS, when Hyprcore is installed as an app bundle, invoke the binary directly: 
/Applications/Hyprcore.app/Contents/MacOS/hyprcore --toggle-transcription
This is the recommended way to drive Hyprcore from BetterTouchTool, Karabiner-Elements, Stream Deck, or shell scripts.