# autokey/autokey

AutoKey, a desktop automation utility for Linux and X11.

Repository: https://github.com/autokey/autokey
Canonical: https://ross.abutalabs.com/products/autokey
Homepage: https://autokey.github.io/index.html
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: python3, desktop-application, python, automation, desktop-automation, pyqt5, pyqt5-desktop-application, gtk3, help-wanted
Last push: 2026-07-10T21:54:51+00:00

## Health v2 (maintenance only)
Score: 64/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 8, longevity 100
- inputs: {"age_days": 4597, "days_push": 54, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3879, forks 264 (observed 2026-08-28T04:08:28.000353+00:00)

## What it is
AutoKey is a desktop automation utility for Linux and X11 that provides keyboard and GUI automation, including text expansion, hotkeys, and scripted macros written in Python. It is an X11 application and does not work correctly under Wayland.

## Use cases
- expand abbreviations into frequently typed text snippets
- bind hotkeys to run Python automation scripts
- automate repetitive keyboard and mouse actions on Linux
- simulate keypresses and mouse clicks programmatically
- create desktop macros to fill forms or launch apps

## When to choose
- you are on Linux with X11 and want scriptable text expansion and hotkeys
- you want to automate repetitive desktop tasks with Python scripts
- you need an open-source alternative to tools like AutoHotkey on Linux

## When to avoid
- you use Wayland instead of Xorg, since AutoKey will not function correctly
- you need cross-platform automation on Windows or macOS
- you need headless or server-side automation without a GUI

## Facets
- artifact type: application
- maturity: active
- function: workflow-automation, gui, developer-tools
- domain: developer-tools, desktop-applications
- platform: python
- tags: text-expansion, hotkeys, x11, macros, desktop-automation, automation, linux, desktop

## Member repositories
- autokey/autokey (main) score 64

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:28.000353+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:25:43.815513+00:00, confidence not recorded.
  - readme: https://github.com/autokey/autokey (fetched 2026-08-28T04:08:28.000353+00:00, sha 9bfe2df79e84)
  - homepage: https://autokey.github.io/index.html (fetched 2026-08-29T09:19:47.014324+00:00, sha 84318d400f03)
  - registry_pypi: https://pypi.org/pypi/autokey/json (fetched 2026-08-29T09:19:47.023986+00:00, sha dd67969fb98c)
- Data as of 2026-08-30T08:39:29.467469+00:00.