// troubleshooting guide · keypirinha

Keypirinha Hotkey Not Working

Status
Workaround available
platforms:
Windows
updated:
November 16, 2026
reports:
4
Method
how we research
Share

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

  1. FIX 1Check your hotkey setting

    1. 01Open the launcher (or right-click the tray icon) and run Keypirinha: Configure Application
    2. 02In the User file, confirm [app] has hotkey_run = Alt+Space (or your key)
    3. 03Save; changes apply automatically
    Did this fix it?
  2. FIX 2Find the app holding the key

    1. 01Quit PowerToys or check whether PowerToys Run also uses Alt+Space
    2. 02Run Hotkey Detective (github.com/ITachiLab/hotkey-detective) and press the hotkey to see which process owns it
    3. 03Change or disable the hotkey in that app
    Did this fix it?
  3. FIX 3Try the default hotkey

    1. 01Press Ctrl+Win+K
    2. 02If it works, the problem is your custom key, so pick a different combination
    Did this fix it?
  4. FIX 4Switch keyboard layout before launching

    1. 01Quit Keypirinha
    2. 02Switch to an English/Latin layout
    3. 03Start Keypirinha again so the custom hotkey parses
    Did this fix it?
  5. FIX 5Proxy the hotkey through AutoHotkey

    1. 01Install AutoHotkey
    2. 02Write a script that binds your hotkey and runs keypirinha.exe (it brings up the launch box)
    3. 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

Watch Keypirinha Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Keypirinha errors

All 11 Keypirinha errors and fixes →