Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/Nordgedanken/intellij-autohotkey

AutoHotkey plugin for the Jetbrain's IntelliJ platform
https://github.com/Nordgedanken/intellij-autohotkey

appcode autohotkey clion editor-plugin goland ide intellij intellij-plugin jetbrains pycharm rubymine webstorm

Last synced: 3 months ago
JSON representation

AutoHotkey plugin for the Jetbrain's IntelliJ platform

Host: GitHub
URL: https://github.com/Nordgedanken/intellij-autohotkey
Owner: Nordgedanken
License: gpl-3.0
Created: 2020-03-14T22:24:47.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2023-06-04T19:54:02.000Z (about 1 year ago)
Last Synced: 2024-01-17T00:53:26.225Z (5 months ago)
Topics: appcode, autohotkey, clion, editor-plugin, goland, ide, intellij, intellij-plugin, jetbrains, pycharm, rubymine, webstorm
Language: Kotlin
Homepage: https://plugins.jetbrains.com/plugin/13945-autohotkey-language
Size: 2.41 MB
Stars: 55
Watchers: 4
Forks: 6
Open Issues: 7
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Lists

awesome-stars-copy - Nordgedanken/intellij-autohotkey - AutoHotkey plugin for the JetBrains IntelliJ platform (Kotlin)

README

        

[![Contributors][contributors-shield]][contributors-url]

[![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![GPL-3.0 License][license-shield]][license-url]






  

    

  

  
AutoHotkey Plugin for the IntelliJ Platform


  


    A simple plugin to bring support for AutoHotkey into IntelliJ-based IDEs!

    


    Explore the docs »

    


    


    Get Plugin

    ·

    Report Bug

    ·

    Request Feature

  


## Table of Contents

* [About the Project](#about-the-project)

  

* [Getting Started](#getting-started)

  * [Prerequisites](#prerequisites)

  * [Setting up a Development Environment](#setting-up-a-development-environment)

* [Roadmap](#roadmap)

* [Contributing](#contributing)

* [License](#license)

* [Contact](#contact)

* [Acknowledgements](#acknowledgements)

## About The Project

A simple plugin for developing AutoHotkey scripts. The following features are available:

- Syntax highlighting (under construction; v1 only; no error checking available currently)

- Run configurations (v1 and v2)

- Quick documentation

- Compile to exe (file right-click option)

- More to come in the future... 

Check out the README on the plugin's GitHub page for more information on using this plugin.

Note: This plugin is under development and does not have a stable release yet. Please report any issues to the plugin's GitHub page.




Dependencies:

- Archive Browser plugin (for documentation assistance)

## Usage

Install the plugin from the [JetBrains Marketplace][jetbrains-marketplace-plugin-page]. The following features will become enabled:

- **AutoHotkey File Recognition**  

  ![Ahk file with normal icon](assets/demo_ahk_file_recognition.png)

- **Syntax Highlighting** (under construction; not complete yet)  

  ![Demo script with syntax highlighting](assets/demo_syntax_highlighting.png)

- **Run Configurations**  

  Allows you to run AutoHotkey scripts right in your IDE at the click of a button (or shortcut). Errors are logged straight to the console for easy debugging. Custom script arguments can be defined within the run configuration's settings.

  ![Sample Ahk run config UI](assets/demo_run_config_ui.png)  

  > Note: Run configurations can be auto-generated and executed by clicking the green triangle in the gutter as seen next to Line 1 in the "Quick Documentation" screenshot.

- **AutoHotkey Settings Page**  

  Custom page that allows you to manage AutoHotkey executables on your machine and swap between them easily in run configurations. 

  ![Ahk settings page UI](assets/demo_ahk_settings_page.png)

- **Quick Documentation**  

  ![Documentation popup for MsgBox function](assets/demo_quick_documentation.png)

  > Note: The hyperlink shown at the bottom of the documentation popup will link to either the v1 or v2 documentation based on which executable you selected as the default in the AutoHotkey settings page.

- **Line/Block Commenting**  

  Comments are toggled by selecting the comment action within the "Code" menu

- **Compile to Executable**  

  Right-click an AutoHotkey file in the project tree and select the "Compile to exe" option to [compile it to .exe][ahk-doc-url-for-ahk2exe]

## Getting Started

To get a local copy up and running, follow these simple steps:

### Prerequisites

* IntelliJ IDEA 2023.* or newer (Community Edition is fine)  

  Required plugins (for development only):

  - [Grammar-Kit](https://plugins.jetbrains.com/plugin/6606-grammar-kit)

  - [PsiViewer](https://plugins.jetbrains.com/plugin/227-psiviewer)

  - [Kotest](https://plugins.jetbrains.com/plugin/14080-kotest)

  - [Ktlint](https://plugins.jetbrains.com/plugin/15057-ktlint-unofficial-)

* Java 17

### Setting up a Development Environment

1. Clone the repo

```sh

git clone https://github.com/Nordgedanken/intellij-autohotkey.git

```

2. Open the cloned folder in IntelliJ

3. Run the `"Run Plugin in test IDE"` run configuration

## Roadmap

See the [open issues](https://github.com/Nordgedanken/intellij-autohotkey/issues) for a list of proposed features (and known issues).

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated, **but please read [CONTRIBUTING.md](CONTRIBUTING.md) before starting any work**.

## License

Distributed under the GPL-3.0 License. See `LICENSE` for more information.

## Contact

MTRNord - [@mtrnord](https://github.com/mtrnord) - https://matrix.to/#/@mtrnord:nordgedanken.dev

Project Link: [https://github.com/Nordgedanken/intellij-autohotkey](https://github.com/Nordgedanken/intellij-autohotkey)

## Acknowledgements

* [intellij-rust](https://github.com/intellij-rust/intellij-rust) which provided a huge starting point to implement undocumented features

* [intellij python plugin](https://github.com/JetBrains/intellij-community/tree/master/python) which also provided help with certain features

* [idea-multimarkdown](https://github.com/vsch/idea-multimarkdown) which also provided help with certain features

[contributors-shield]: https://img.shields.io/github/contributors/Nordgedanken/intellij-autohotkey.svg?style=flat-square

[contributors-url]: https://github.com/Nordgedanken/intellij-autohotkey/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/Nordgedanken/intellij-autohotkey.svg?style=flat-square

[forks-url]: https://github.com/Nordgedanken/intellij-autohotkey/network/members

[stars-shield]: https://img.shields.io/github/stars/Nordgedanken/intellij-autohotkey.svg?style=flat-square

[stars-url]: https://github.com/Nordgedanken/intellij-autohotkey/stargazers

[issues-shield]: https://img.shields.io/github/issues/Nordgedanken/intellij-autohotkey.svg?style=flat-square

[issues-url]: https://github.com/Nordgedanken/intellij-autohotkey/issues

[license-shield]: https://img.shields.io/github/license/Nordgedanken/intellij-autohotkey.svg?style=flat-square

[license-url]: https://github.com/Nordgedanken/intellij-autohotkey/blob/master/LICENSE

[product-screenshot]: images/screenshot.png

[jetbrains-marketplace-plugin-page]: https://plugins.jetbrains.com/plugin/13945-autohotkey/

[ahk-doc-url-for-ahk2exe]: https://www.autohotkey.com/docs/Scripts.htm#ahk2exe