https://github.com/mark-wiemer/ahkpp
AHK++ provides AutoHotkey v1 and v2 support for VS Code, Theia IDE, and more
https://github.com/mark-wiemer/ahkpp
ahk ahkv2 autohotkey autohotkey-v2 language-support theia theia-extension theia-ide theia-language-extension vscode vscode-extension vscodium vscodium-extension
Last synced: 16 days ago
JSON representation
AHK++ provides AutoHotkey v1 and v2 support for VS Code, Theia IDE, and more
- Host: GitHub
- URL: https://github.com/mark-wiemer/ahkpp
- Owner: mark-wiemer
- License: other
- Created: 2020-11-07T19:46:38.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-03T04:35:53.000Z (26 days ago)
- Last Synced: 2025-04-04T12:05:57.935Z (24 days ago)
- Topics: ahk, ahkv2, autohotkey, autohotkey-v2, language-support, theia, theia-extension, theia-ide, theia-language-extension, vscode, vscode-extension, vscodium, vscodium-extension
- Language: TypeScript
- Homepage: https://ahkpp.com
- Size: 2.59 MB
- Stars: 209
- Watchers: 6
- Forks: 12
- Open Issues: 41
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- Contributing: Contributing.md
- License: license.md
- Security: security.md
Awesome Lists containing this project
README
AHK++
Full language support for AHK v1 and AHK v2
IntelliSense
Syntax highlighting
Debug support
Formatting (customizable!)
Quick help
...and more
## Install
AHK++ is available for: [VS Code](https://code.visualstudio.com) | [Theia IDE](https://theia-ide.org) | [VSCodium](https://vscodium.com) | [any other IDE that supports \*.vsix extensions](https://github.com/mark-wiemer/ahkpp/releases)
Download from a trusted source: [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=mark-wiemer.vscode-autohotkey-plus-plus) | [Open VSX Registry](https://open-vsx.org/extension/mark-wiemer/vscode-autohotkey-plus-plus) | [GitHub releases](https://github.com/mark-wiemer/ahkpp/releases)
## AHK v2 full support is here! 🥂
AHK++ 6 incorporates [AutoHotkey v2 Language Support by thqby](https://marketplace.visualstudio.com/items?itemName=thqby.vscode-autohotkey2-lsp), providing full support for AHK v2, including:
- Running, debugging, and stopping v1 and v2 scripts without changing settings
- Full syntax highlighting for v2 scripts
- "Open help" (`Ctrl+F1`) opens language-specific help (and includes your text selection)
- Unique icons for AHK v1 (blue) and v2 (green)
- Rich IntelliSense support with snippets, hover text, and suggestions
- Formatting files with many customized options
For all changes, including breaking changes, see [the changelog](./changelog.md#600---2024-09-01-)
As always, please [🐛 report any issues](https://github.com/mark-wiemer/ahkpp/issues/new/choose)
💚 Special thanks again to [thqby](https://github.com/thqby), as this would not have been possible without thqby's open-source [AutoHotkey v2 Language Support](https://marketplace.visualstudio.com/items?itemName=thqby.vscode-autohotkey2-lsp)!
---
## Commands
With AHK++, you can compile, debug, and run your scripts with keyboard shortcuts. You can also run a selection as a standalone script.
- Compile: `Ctrl+Shift+F9`
- Debug: `Ctrl+Alt+F9`
- Open help: `Ctrl+F1`
- Run: `Ctrl+F9`
- Run selection: `Ctrl+F8`
- Stop: `Ctrl+F6`
## Debug
> There are some [known issues with the debugger](https://github.com/mark-wiemer/ahkpp/issues?q=is%3Aopen+is%3Aissue+label%3Adebugger). If you need an advanced setup, we recommend [zero-plusplus.vscode-autohotkey-debug](https://marketplace.visualstudio.com/items?itemName=zero-plusplus.vscode-autohotkey-debug) for now. Please [open an issue](https://github.com/mark-wiemer/ahkpp/issues/new/choose) if the built-in debugger does not support your needs. As `zero-plusplus.vscode-autohotkey-debug` is [closed-source](https://github.com/zero-plusplus/vscode-autohotkey-debug/discussions/332), we will be working to introduce advanced debugger features to ensure an open-source, collaborative, complete extension is available to the AHK community 🙂
1. Click the debug button in the editor title menu (at the top right of the editor) or press `Ctrl+Alt+F9`.
2. The debugger supports breakpoints, stack tracing, and variable watching
### Debug features
1. **Output message**: You can use `OutputDebug` command instead of `MsgBox` to log values.
2. **Evaluate**: Set and get variable values through the debug console.
This extension provides basic debugging functions. If you need more debugging functions (such as conditional breakpoints), you can add an additional extension: [Install vscode-autohotkey-debug](https://marketplace.visualstudio.com/items?itemName=zero-plusplus.vscode-autohotkey-debug).
## Language features
### Go to definition
1. Supports navigation to symbol definition.
2. Usage: Ctrl-click on the symbol to navigate to its definition.
### Find symbol references
Select a symbol, then:
- Right-click and select `Find All References`.
- Or press `Shift+F12`.
### Hover tip
Usage: Hover over symbol to see IntelliSense documentation.
### Outline
Assign name to block of code via double semicolon comment `;;Name` and go to it from outline.
### Folding
Custom folding regions:
```autohotkey
;region
MsgBox % "Collapse me!"
;endregion
; Block comments with regions
/* ;region
Collapse me!
*/ ;endregion
```
### Code format
Supports standard VS Code formatting with a few options.
#### Formatter directives
Formatter directives instruct the formatter to behave a certain way on sections of code.
1. `FormatBlockComment`:
```autohotkey
;@AHK++FormatBlockCommentOn
/*
;All text inside block comment will be formatted like regular code.
*/
;@AHK++FormatBlockCommentOff
```
2. `AlignAssignment`:
```autohotkey
;@AHK++AlignAssignmentOn
a = 5 ; number five
str = legacy text = with equal symbol
inputFile := "movie.mkv"
abc := "abc" ; string
abc := a + b
;@AHK++AlignAssignmentOff
```
## 💚 Acknowledgements
This extension relies heavily on open-source code. A huge thank you to all these open-source contributors who made the extension what it is today!
- [AutoHotkey Plus by cweijan](https://marketplace.visualstudio.com/items?itemName=cweijan.vscode-autohotkey-plus): AHK++ is a fork of AutoHotkey Plus by cweijan (Weijan Chen)
- [AutoHotkey v2 Language Support extension by thqby](https://marketplace.visualstudio.com/items?itemName=thqby.vscode-autohotkey2-lsp): The source of the v2 grammar and other great contributions
- [Contributions to AHK++ by kyklish](https://github.com/mark-wiemer/ahkpp/commits/main?author=kyklish): Greatly improved formatting and snippets by both fixing bugs and adding features
- [AutoHotkey v2 definition files by GroggyOtter](https://github.com/GroggyOtter/ahkv2_definition_rewrite)
- [AHK version selection by Lexikos](https://github.com/Lexikos/vscode-auto-select): The core code for automatically switching AHK versions
- [AutoHotkey by stef-levesque](https://marketplace.visualstudio.com/items?itemName=slevesque.vscode-autohotkey): AutoHotkey Plus is a fork of stef-levesque's original AutoHotkey extension, which provided the original grammar and snippets for AHK
- People like you: Thank you for opening issues, offering suggestions, and providing information to the AHK community :)
## Links
- [GitHub repo](https://github.com/mark-wiemer/ahkpp): View code, file bugs, and join discussions
- [Reviews on VS Marketplace](https://marketplace.visualstudio.com/items?itemName=mark-wiemer.vscode-autohotkey-plus-plus&ssr=false#review-details): Help others discover AHK++ by leaving a review