Quickstart

This document assumes you have Python 3.8 or newer installed

Installing AHK

AHK requires the AutoHotkey software in addition to the Python package

1. Install the Python ahk package

   py -m pip install ahk
   

2. Download and install AutoHotkey (1.1.x). It can be downloaded from the autohotkey website; OR install using pip

   py -m pip install "ahk[binary]"
   

3. Write your first script:

   from ahk import AHK
   ahk = AHK()
   ahk.run_script('Run Notepad')
   notepad_window = ahk.win_get(title='Untitled - Notepad')
   notepad_window.send('Hello World')
   

Run the script!

If you get an ExecutableNotFoundError it’s because AutoHotkey was installed to a location that is not on PATH or the default location (C:\Program Files\AutoHotkey\AutoHotkey.exe). You can either place the executable on PATH, in the default location, or specify the location manually in code:

ahk = AHK(executable_path='C:\\Path\\To\\AutoHotkey.exe')