// troubleshooting guide · keypirinha
Keypirinha Hotkey Not Working
- Status
- Workaround available
- platforms:
- Windows
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · keypirinha/hotkey-not-working5 FIXES
// quick answer
If Alt+Space or your custom hotkey does nothing, another app is usually holding the key at OS level. Find it with Hotkey Detective, check hotkey_run in your config, or let AutoHotkey trigger Keypirinha.
Most likely fix: Check your hotkey setting
How to fix it
// try these in order, the most common fix is first
FIX 1Check your hotkey setting
- 01Open the launcher (or right-click the tray icon) and run Keypirinha: Configure Application
- 02In the User file, confirm [app] has hotkey_run = Alt+Space (or your key)
- 03Save; changes apply automatically
Did this fix it?FIX 2Find the app holding the key
- 01Quit PowerToys or check whether PowerToys Run also uses Alt+Space
- 02Run Hotkey Detective (github.com/ITachiLab/hotkey-detective) and press the hotkey to see which process owns it
- 03Change or disable the hotkey in that app
Did this fix it?FIX 3Try the default hotkey
- 01Press Ctrl+Win+K
- 02If it works, the problem is your custom key, so pick a different combination
Did this fix it?FIX 4Switch keyboard layout before launching
- 01Quit Keypirinha
- 02Switch to an English/Latin layout
- 03Start Keypirinha again so the custom hotkey parses
Did this fix it?FIX 5Proxy the hotkey through AutoHotkey
- 01Install AutoHotkey
- 02Write a script that binds your hotkey and runs keypirinha.exe (it brings up the launch box)
- 03Set hotkey_run to an unused combination so the two don't clash
Did this fix it?
SANDBOX · keypirinha RUNS IN YOUR BROWSER
Try it: a launcher with snippets and clipboard history
A hands-on Keypirinha-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Pressing the launch hotkey does nothing while Keypirinha is running in the tray, or Keypirinha shows 'Malformed Run hotkey ... Please reconfigure'.
Why it happens
- C-01Another app (PowerToys Run, a window manager, etc.) registered the same hotkey
- C-02hotkey_run was changed or overwritten in Keypirinha.ini
- C-03Windows 11 upgrade changed hotkey behavior
- C-04Keypirinha started while a non-Latin keyboard layout was active
- C-05Right Alt (AltGr) used as the hotkey
// this guide also covers
- keypirinha hotkey not working
- keypirinha alt space not working
- keypirinha malformed run hotkey
- keypirinha change hotkey
Still not working?
If Keypirinha keeps failing, you're not alone. See every Keypirinha problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us