Skip to content

sprawf/hotkeys

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Hotkeys

Rewrite any text, in any app, instantly. No copy-paste. No switching windows. Just a hotkey.

Select text anywhere → press Alt+Shift+W → AI rewrites it and pastes it back. Done.
Works in Gmail, Notion, Slack, Word, VS Code, Discord — every app on your computer.

Windows Windows v1 Mac License Python


What is this?

Most AI writing tools make you open a browser tab, paste your text, wait, copy the result, switch back, and paste again. That's 7 steps — every single time.

Hotkeys does it in 1 step — without ever leaving whatever you're writing in.

It sits quietly in your system tray and gives you three superpowers:

✍️ AI Text Refiner Select any text, press a hotkey — it's rewritten and pasted back in under a second
⌨️ Custom Prompt Hotkeys Write any instruction, assign it F1–F12, fire it from any app instantly
🎙️ Voice to Text Hold a hotkey, speak, your words appear wherever your cursor is — fully offline

The Prompt Library

All your prompts in one place. Click any card to activate it, drag to reorder, right-click for options:

Prompt Library


The Prompt Library — make it yours

The library ships with 16 ready-to-use prompts. Each one is a single instruction that gets applied to whatever text you've selected.

Hotkey Prompt What it does
F1 Refine Fixes grammar, spelling, and clarity — same meaning, natural tone
F2 Improve & Expand Makes your text more articulate, detailed, and expressive
F3 Translate Translates in place (default: Arabic — change it to anything)
F4 System Prompt Reformats text into a clean, deployable AI system prompt
F5 Simplify Strips jargon and complexity — immediately understandable
F6 Technical Depth Adds precision and implementation detail for expert readers
F7 Expand Develops underdeveloped ideas without going off-topic
F8 Professional Rewrites in polished, formal language at the same length
F9 Ask Claude Turns vague thoughts into a sharp, specific AI prompt
F10 Pirate Rewrites with nautical flair — same meaning, more swagger
F11 ELI5 Explains anything as if the reader is five years old
F12 Tweet Compresses the sharpest idea into one punchy tweet
Brutally Honest Says exactly what's meant, no softening, no padding
Story Hook Turns any idea into a gripping opening line
Devil's Advocate Argues the exact opposite with equal conviction
Haiku Distils the core idea into a 5-7-5 haiku

These are just the starting point. Hit + Add to write your own.

The only limit is your imagination. Want a prompt that rewrites emails in your exact voice? Converts meeting notes into action items? Translates to your language? Summarises legal contracts in plain English? Turns rough ideas into job postings?

Add it in 10 seconds and it works everywhere, instantly.

Tip: Press any hotkey to see a floating sticky note preview. Edit the prompt on the fly before it fires, then press the key again to apply.


How to install

⊞ Windows — one click, no setup

  1. Download Hotkeys-v2.0-win64.zip
  2. Extract the zip — you'll get a Hotkeys folder
  3. Open the folder and double-click Hotkeys.exe
  4. The ⚡ icon appears in your taskbar tray — you're done

No Python. No pip. No installing anything. It just works.

Download v1.0 (legacy)


🍎 Mac — automated installer

  1. Download install_mac.command
  2. Right-click → Open → click Open again (Mac security prompt)
  3. A terminal window installs everything automatically (~10 min, 600 MB models)
  4. Grant keyboard permission when prompted (one-time, 30 seconds)
  5. Double-click Hotkeys.command on your Desktop — done

How to use it

Refine any text (AI rewrite)

  1. Select text in any app
  2. Press Alt + Shift + W
  3. Wait ~0.5 seconds — the text is rewritten and pasted back

Use a prompt from the library

  1. Select text in any app
  2. Press the prompt's hotkey (e.g. F5 for Simplify)
  3. A sticky note appears — read the prompt, edit it if you want
  4. Press the same key again to fire it

Add your own prompt

  1. Press Alt + Shift + E to open the Prompt Library
  2. Click + Add
  3. Give it a name and write your instruction
  4. (Optional) Assign a hotkey via right-click → Assign hotkey
  5. Click Save — available everywhere immediately

Dictate text (voice to text)

  1. Place your cursor where you want the text
  2. Press Ctrl + Enter to start recording
  3. Speak naturally
  4. Press Ctrl + Enter again to stop — your words appear instantly

Settings

Everything is configurable. Open the library (Alt+Shift+E) and click the gear icon, or right-click the tray icon.

  • AI Provider — switch between Cerebras and Groq, enter your API key
  • Hotkeys — change any global shortcut
  • Voice model — choose small (fast) or large (accurate), pick your microphone
  • Transcription — language, beam size, custom vocabulary
  • Autostart — launch automatically with Windows
  • Push-to-talk — hold to record, release to transcribe

All default hotkeys

Action Shortcut
Refine selected text with AI Alt + Shift + W
Open Prompt Library Alt + Shift + E
Fire prompt 1–12 F1F12
Start / stop voice recording Ctrl + Enter
Cancel recording Escape

All hotkeys are customisable in Settings. Per-prompt hotkeys are assigned per prompt via right-click → Assign hotkey.


AI Providers — both free

Hotkeys uses Cerebras or Groq to rewrite your text. Both are completely free and take 2 minutes to set up.

Provider Speed Free tier Sign up
Cerebras ~0.3 s ✅ Yes cerebras.ai
Groq ~0.5 s ✅ Yes console.groq.com

Sign up → copy your API key → paste it into Settings → done.

Voice-to-text works without any API key — it runs fully offline on your device.


Privacy

  • 🔒 Voice is transcribed locally — the Whisper model runs on your computer, nothing is sent anywhere
  • 🌐 Text refinement goes to Cerebras or Groq — same as any AI assistant you already use
  • 🚫 No analytics, no telemetry, no account required

Feature list

Feature Notes
✍️ AI text refiner Works in any app, any text field
📚 Prompt library 16 built-in prompts, unlimited custom ones
⌨️ Per-prompt hotkeys Assign F1–F12 to any prompt; fires from any app
🗒️ Sticky note popup Preview and edit a prompt before it fires
🔤 Live spell check Misspellings underlined in red as you type
🔍 Prompt search Find prompts instantly as you type
🔄 Drag to reorder Organise prompts by drag and drop
🎙️ Voice to text Fully offline, no data sent anywhere
🔇 Noise reduction Works in noisy environments
🚀 Push-to-talk Hold to record, release to transcribe
📋 Transcription history Browse and copy past recordings
Instant paste Output types directly where your cursor is
🖥️ System tray Zero UI clutter, always available

Running from source

git clone https://github.com/sprawf/hotkeys.git
cd hotkeys

# Windows
python -m venv venv
venv\Scripts\pip install -r requirements.txt
venv\Scripts\python main.py

# Mac / Linux
python3 -m venv venv
venv/bin/pip install -r requirements_mac.txt
venv/bin/python3 main.py

Tech stack

Component Library
UI CustomTkinter + tkinter
Speech-to-text faster-whisper (runs offline)
Voice activity detection Silero VAD
AI text refinement Cerebras / Groq API
Spell check pyspellchecker
Global hotkeys keyboard
System tray pystray
Packaging PyInstaller

License

MIT — free to use, fork, and build on.


If this saved you time, consider leaving a ⭐ — it helps others find it.