Developer Tool · last scan Nov 2026
AutoHotkey Problems & Issues
Free, open-source scripting language for Windows hotkeys, hotstrings and automation
VERDICT TRY WITH CAUTION
66/100
Try with caution
- signals
- 13
- sources
- 44
- known errors
- 10
// answer first
Should you use AutoHotkey?
Try with cautionAutoHotkey works for some teams, but users report recurring problems (score 66/100). Most reported issues: AutoHotkey v1 scripts not working after installing v2; AutoHotkey hotkeys not working in admin windows; Antivirus flags AutoHotkey or compiled .exe as a virus. Not a good fit for: Non-technical users wanting point-and-click macros; Competitive online gamers; Mac or Linux users. Users most often switch to Microsoft PowerToys, Alfred, Raycast.
Top problems
- AutoHotkey v1 scripts not working after installing v2
- AutoHotkey hotkeys not working in admin windows
- Antivirus flags AutoHotkey or compiled .exe as a virus
Good for
- Windows power users and sysadmins
- Developers comfortable scripting
- Accessibility and keyboard remapping needs
Avoid if you are
- Non-technical users wanting point-and-click macros
- Competitive online gamers
- Mac or Linux users
Common alternatives:
Microsoft PowerToys,
Alfred,
Raycast
score breakdown
- Pricing
- 100Pricing score 100 of 100
- Usability
- 45Usability score 45 of 100
- Performance
- 82Performance score 82 of 100
- Support
- 60Support score 60 of 100
- Reliability
- 66Reliability score 66 of 100
- Onboarding
- 40Onboarding score 40 of 100
- Security
- 48Security score 48 of 100
- Integrations
- 75Integrations score 75 of 100
// score breakdown, 0-100
- Pricing
- 100Pricing score 100 of 100
- Usability
- 45Usability score 45 of 100
- Performance
- 82Performance score 82 of 100
- Support
- 60Support score 60 of 100
- Reliability
- 66Reliability score 66 of 100
- Onboarding
- 40Onboarding score 40 of 100
- Security
- 48Security score 48 of 100
- Integrations
- 75Integrations score 75 of 100
how these scores were set
Free and extremely capable, but it is a programming language: the v1/v2 split, admin-window blocking, antivirus false positives and anti-cheat conflicts cost newcomers hours.
Overview
AutoHotkey (AHK) is a free, open-source scripting language for Windows that lets you remap keys, create hotkeys, expand text with hotstrings, automate clicks and window actions, and build small GUIs. It is aimed at power users, sysadmins and gamers who want custom shortcuts without a heavyweight tool. The current line is v2 (released December 2022); the older v1.1 syntax is incompatible and still widely used.
- company
- AutoHotkey community (open source, GPL-2.0)
- founded
- 2003
- website
- www.autohotkey.com
AutoHotkey Not Working? Common Errors & Fixes
10 entries// step-by-step fixes for the errors users hit most
- E-01AutoHotkey v1 Script Not Working in v2v2 is not backward compatible, so v1 scripts fail or do nothing. Install v1 for old scripts, or port the syntax and add #Requires so the right version runs.
- E-02AutoHotkey Error: This Line Does Not Contain a Recognized ActionThis error almost always means v1-style code is running under v2. Fix the syntax or run the script with the matching version.
- E-03AutoHotkey Hotkeys Not Working in Admin WindowsWindows UAC blocks normal scripts from elevated windows. Run the script with UI Access (best) or as administrator.
- E-04AutoHotkey Flagged as Virus by AntivirusAHK and compiled scripts are often false positives. Verify on VirusTotal, report to the vendor and add an exclusion for your own file.
- E-05AutoHotkey Anti-Cheat Errors and Bans in GamesMany anti-cheat systems block or flag AHK. Close it before launching the game, and avoid scripts that give gameplay advantage.
- E-06AutoHotkey Send and Click Not Working in GamesGames often ignore normal simulated input. Try longer key delays, down/up events or ControlSend; some anti-cheat games block it entirely.
- E-07AutoHotkey Modifier Key Stuck (Ctrl, Alt, Shift, Win)Send can re-press a modifier you already released. Use SendEvent, add small delays and tap the modifiers to clear it.
- E-08AutoHotkey Hotkeys Not Working on Non-English Keyboard LayoutsLetter hotkeys depend on the active layout. Bind by scan code (for example sc010) so the hotkey works on any layout.
- E-09AutoHotkey Script Slow or Laggy Under High CPUHotkeys can lag when the PC is busy. Raise the script's process priority and trim slow loops.
- E-10How to Run an AutoHotkey Script at StartupPut a shortcut to the script in your Startup folder (shell:startup). Use Task Scheduler if it must run elevated.
Try it: a launcher with snippets and clipboard history
A hands-on sandbox of how AutoHotkey-style tools work, including where users run into trouble. Simplified illustration, not the real AutoHotkey app. Nothing is saved.
SANDBOX · autohotkey LIVE, NOTHING SAVED
Our team built this sandbox from scratch. Want a real AutoHotkey-style tool built around how you work?
Get a quote// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like AutoHotkey: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code
Signals & Issues
13 signals · sorted by impact// patterns extracted from real user feedback, not raw reviews
AutoHotkey v1 scripts not working after installing v2✓ verified
v2 deliberately dropped backward compatibility: `=` assignments, `%var%` expansion, comma-style commands and `return`-terminated hotkeys all fail. Users who install v2 and double-click an old script get load errors or a script that silently does nothing. Official docs say v1 scripts generally will not work on v2 without changes.
reported 9xnegativevia Reddit (4)migration pain
impact7/10AutoHotkey v2 error: This line does not contain a recognized action✓ verified
Load-time errors such as 'Function calls require a space or (' and 'does not contain a recognized action' are the usual symptom of v1-style syntax running under the v2 interpreter, often from copied forum or ChatGPT snippets. The error text rarely tells beginners which version the code was written for.
reported 9xnegativevia Reddit (4)workflow failure
impact6/10
AutoHotkey blocked or banned in games with anti-cheat✓ verified
Battlefield, Apex, THE FINALS and other anti-cheat systems flag AHK or refuse to launch while it runs. The FAQ says anti-cheat such as GameGuard/Hackshield often blocks AutoHotkey entirely. Players report errors and some account bans; closing AHK before launching is the common workaround.
reported 7xnegativevia Other (4)workflow failure
impact8/10AutoHotkey hotkeys not working in admin windows✓ verified
Windows UAC/UIPI stops a normal-privilege script from sending keys to, or catching hotkeys in, elevated windows such as Task Manager, installers or apps run as administrator. The script looks alive but hotkeys do nothing in that window. Official FAQ fixes are running as admin or UI Access from Program Files.
reported 8xnegativevia Other (4)workflow failure
impact7/10
Antivirus flags AutoHotkey or compiled .exe as a virus✓ verified
Windows Defender, Webroot and other engines repeatedly flag Ahk2Exe, the base binaries and compiled scripts as trojans. The official FAQ calls most of these false positives and recommends VirusTotal plus reporting to the vendor, but users still lose time to quarantined files and warnings on friends' PCs.
reported 8xnegativevia Other (5)workflow failure
impact7/10Is it safe to run downloaded AutoHotkey scripts?✓ verified
An .ahk file can do anything the user can: run programs, read files, send keystrokes. Because AHK is also used in malware loaders, security vendors treat random scripts and compiled exes with suspicion. Only run scripts you have read.
reported 5xnegativevia Other (3)expectation mismatch
impact6/10
AutoHotkey Send not working in games and some apps✓ verified
Send, Click and hotstrings often do nothing in games and apps that read raw input. Official fixes are longer key delays, SendPlay/ControlSend or separate down/up events, but SendPlay is deprecated and may do nothing on Windows 11.
reported 7xnegativevia Other (3)workflow failure
impact6/10AutoHotkey modifier key stuck after Send✓ verified
Ctrl, Alt, Shift or Win can appear stuck after a script's Send, because Send may re-press a modifier it temporarily released. Terminating the script does not always release it. Users fix it by switching Send mode, adding delays or tapping the modifiers.
reported 6xnegativevia Other (3)workflow failure
impact6/10
Is AutoHotkey hard to learn? It is a programming language✓ verified
Beginners expect a point-and-click macro tool and find a scripting language with its own syntax, two incompatible versions, and tutorials that mix v1 and v2. Community advice is to learn v2 only and avoid old v1 videos.
reported 8xnegativevia Reddit (3)expectation mismatch
impact6/10
AutoHotkey hotkeys not working with non-English keyboard layouts✓ verified
Letter hotkeys such as `q::` depend on the active layout, so they are inactive when the layout has no such key. Users bind by scan code (for example sc010) and check Key History to find the right code.
reported 5xnegativevia Other (3)workflow failure
impact5/10
AutoHotkey script slow or lagging under heavy CPU load✓ verified
Hotkeys, clicks and sends can lag when the PC is busy. The FAQ suggests adding ProcessSetPriority High near the top of the script.
reported 4xnegativevia Other (2)workflow failure
impact4/10
AutoHotkey has no official support, only forum and Reddit✓ verified
Help comes from the community forum and r/AutoHotkey. Docs are thorough but dense, and error messages do not always point to the cause. Many threads are v1-era and give outdated answers for v2.
reported 6xnegativevia Reddit (3)support breakdown
impact5/10
AutoHotkey is Windows only (no Mac, Linux or phone)✓ verified
AHK works on Windows only. Mac and Linux users need other tools such as Keyboard Maestro, Hammerspoon, espanso or AutoKey, and scripts do not port.
reported 6xnegativevia Other (3)user type mismatch
impact5/10
What Users Love
Completely free and open source
No license, no subscription, no telemetry account. GPL-licensed with active development.
Remap anything and automate almost any Windows task
Hotkeys, hotstrings, window control, clicks, GUIs, COM and DLL calls from one small language.
Tiny and fast
Scripts use little memory and start instantly; the runtime is a few MB.
v2 is cleaner and more consistent than v1
v2 removes many v1 quirks (consistent expressions, real functions, exceptions) and the maintainers promise v2.x scripts keep working until v3.
Compile scripts to standalone exes
Ahk2Exe turns a script into a portable exe you can share, though antivirus may flag it.
Large community and script library
A long-running forum, active subreddit and many open-source libraries and examples.
Pricing Plans
Users: Unlimited
- ✓Full AutoHotkey v1.1 and v2 runtime
- ✓Ahk2Exe compiler
- ✓Hotkeys, hotstrings, GUI, COM
- ✓Commercial use allowed (GPL-2.0)
Limitations: Windows only, no official support, no visual macro recorder, no built-in sync or cloud
Features
Core
- Hotkeys and key remapping
- Hotstrings (text expansion)
- Compile to .exe
Ahk2Exe; may be flagged by antivirus
- GUI building
Code-only, no designer
Compatibility
- Works in elevated windows
Needs run as admin or UI Access
- v1 script compatibility in v2
Scripts need conversion
Platform
- macOS / Linux support
Windows only
Ease of use
- Visual macro recorder
Launcher
- App launcher / search
Can be scripted, not built in
Who Should Use This?
Good Fit
Windows power users and sysadmins
Custom shortcuts and automations for free, with huge flexibility.
Developers comfortable scripting
Small language, quick to automate repetitive desktop tasks.
Accessibility and keyboard remapping needs
Can remap any key and tailor input to personal needs.
Neutral
Heavy typists needing text expansion
Hotstrings work well, but TextExpander or espanso have friendlier snippet management.
People with existing v1 scripts
Keep v1 installed or budget time to port; the two versions can coexist.
Avoid
Non-technical users wanting point-and-click macros
It is a programming language with no recorder; PowerToys is simpler for common remaps.
Competitive online gamers
Anti-cheat often blocks AHK and bans are reported.
Mac or Linux users
Windows only.
Regret Patterns
Common buyer's remorse scenarios reported by users.
Users grab the newest installer, then find years of v1 scripts no longer load.
Forum posts, videos and AI answers mix syntax versions, producing confusing load errors.
Everything works until the target app runs as admin, and nothing explains why.
Sharing a compiled script triggers antivirus warnings and distrust.
A background AHK script triggers an anti-cheat error or ban risk.
One long script of hotkeys becomes fragile without structure or testing.
When It Breaks Down
Scenarios where this product tends to fail users.
Load errors or silent no-ops until you add #Requires or convert the syntax.
Hotkeys and Send are blocked by UIPI unless AHK runs as admin or with UI Access.
Launch errors, blocked input or possible bans.
Antivirus false positives on other PCs.
Send and Click do nothing in some games and secure apps.
Letter hotkeys go inactive when the layout lacks that key.
Alternatives Users Switch To
Microsoft PowerToys
8x mentionedFree from Microsoft with Keyboard Manager for remaps and PowerToys Run launcher; no scripting needed. Trade-off: far less flexible and its remaps also fail in admin apps.
Raycast
6x mentionedLauncher with extensions, snippets and scripts, now also on Windows. Trade-off: some features need a paid plan and it is not a general scripting language.
Alfred
5x mentionedMac launcher with workflows and snippets for people who want automation on macOS. Trade-off: macOS only and Powerpack is paid.
TextExpander
5x mentionedPolished snippet manager with sync, replacing AHK hotstrings. Trade-off: subscription.
Espanso
5x mentionedFree cross-platform open-source text expander (Windows, Mac, Linux). Trade-off: text expansion only, YAML config.
Keyboard Maestro
5x mentionedThe macOS automation standard with a visual macro editor. Trade-off: Mac only, paid license.
Hammerspoon
3x mentionedFree Lua scripting for macOS, the closest AHK-style tool on Mac. Trade-off: steeper learning curve.
Frequently Asked Questions
See how AutoHotkey compares in our Best Launcher Software rankings, or calculate costs with our Budget Calculator.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usWork at AutoHotkey or spotted something outdated? Suggest a correction — we verify every change against public sources. See our methodology.