AutoKey на Linux: установка и руководство

how to use autokey linux

Изображение: общий вид рабочего стола Linux с подсказкой об AutoKey и примерами использования.

Что такое AutoKey

AutoKey — это бесплатная и открытая утилита для автоматизации рабочего стола в Linux. Она позволяет автоматически вводить заранее подготовенный текст, исправлять частые опечатки, запускать программы и выполнять произвольные Python-скрипты в ответ на горячие клавиши или триггерные фразы.

Короткое определение: триггерная фраза — это сочетание символов, которое AutoKey заменяет на заданный фрагмент текста или запускает скрипт.

Когда использовать AutoKey:

быстрый ввод часто повторяющихся фрагментов (подписи, шаблоны письма);
автоматическая правка опечаток;
запуск приложений и простая интеграция с системными командами через Python.

Когда AutoKey не подходит: для GUI-тестирования сложных приложений или для автоматизации на Wayland с ограничениями — лучше использовать специализированные инструменты.

Установка AutoKey на разные дистрибутивы

AutoKey доступен в двух основных вариантах: autokey-gtk и autokey-qt. Выберите версию, соответствующую вашей среде рабочего стола: GTK обычно подходит для GNOME, Qt — для KDE. Функционально обе версии предоставляют схожие возможности.

Совет: предпочтительнее устанавливать AutoKey через менеджер пакетов дистрибутива — так проще получать обновления и решать зависимости.

На Debian, Ubuntu, Linux Mint, Elementary

Откройте терминал и выполните одну из команд в зависимости от интерфейса:

sudo apt update
sudo apt install autokey-gtk

или, если вы предпочитаете Qt-версию:

sudo apt install autokey-qt

Если пакет не найден в репозиториях, проверьте наличие backports или используйте pip (см. раздел о pip ниже).

На Fedora

В Fedora установка выполняется так:

sudo dnf install autokey-gtk

Для Qt-версии путь аналогичен, если пакет доступен в репозиториях.

На Arch Linux (AUR)

AutoKey можно установить из AUR. Если у вас установлен помощник для AUR, например yay:

yay -S autokey-gtk

Повторите аналогично для autokey-qt.

Установка через pip (если нужен последний релиз)

Если в репозиториях устаревшая версия и нужен последний релиз, можно установить через pip. Однако установка через pip чаще требует дополнительных зависимостей и менее автоматизирована, поэтому этот путь рекомендуется опытным пользователям.

python3 -m pip install --user autokey

После установки через pip проверьте документацию и лог запуска, чтобы убедиться, что все зависимости (GUI-библиотеки) установлены.

Установка из исходников

Если вы собираете AutoKey из исходников, следуйте инструкциям в официальном репозитории проекта: клонируйте репозиторий, установите зависимости для вашей среды (GTK/Qt) и выполните установку согласно README.

Important: обратите внимание на совместимость с графической подсистемой (X11 vs Wayland). AutoKey традиционно работает под X11; функциональность под Wayland может быть ограничена.

Первый запуск и автозапуск при входе в систему

Запустите AutoKey из меню приложений. Главное окно разделено на две части: левая панель — дерево папок, фраз и скриптов; правая — настройки выбранного элемента и поле редактирования.

AutoKey main window

Изображение: главное окно AutoKey с деревом фраз слева и редактором справа.

Чтобы AutoKey запускался автоматически при входе в систему:

Выберите меню «Edit» → «Preferences» (Редактирование → Настройки).
Во вкладке «General» отметьте поле «Automatically start AutoKey at Login».
Нажмите OK и закройте окно.

enable startup at boot

Изображение: окно настроек AutoKey с опцией автозапуска.

Работа с фразами (Phrases)

Фразы — это статические текстовые шаблоны, которые заменяются по триггерной фразе или набору сокращений. Они отлично подходят для подписей, часто используемых фрагментов кода или ответов на типичные письма.

Создание новой фразы — пошагово

Нажмите «New» и выберите «Phrase».
Дайте фразе имя и подтвердите OK.
В правой части нажмите в поле «Enter phrase contents» и вставьте текст, который хотите вводить автоматически.
Нажмите «Set» рядом с «Abbreviations» и добавьте сокращение, которое будет заменять фразу.
Установите поведение триггера («Trigger on») — например, «All non-word» (триггер при вводе непечатного символа).
Сохраните изменения.

Советы по настройке фраз:

Включите «Ignore case of typed abbreviation», чтобы триггер был нечувствителен к регистру.
Включите «Trigger immediately (don’t require a trigger character)», если хотите заменять текст без дополнительного символа.

Организация фраз

Если фраз много, сгруппируйте их по папкам (проекты, документация, шаблоны кода). Создайте папку и перетащите туда соответствующие фразы.

Чтобы назначить горячую клавишу для папки и быстро вывести список фраз:

Создайте новую папку и поместите в неё фразы.
Выберите папку и в настройках папки нажмите «Set» рядом с «Hotkey».
Выберите модификатор, нажмите «Press to Set» и задайте клавишу.

Теперь по назначенному хоткею откроется список фраз из папки — выберите нужную.

Работа со скриптами AutoKey

Скрипты дают больше возможностей, чем статические фразы: они могут запускать приложения, работать с файловой системой, управлять буфером обмена и запускать системные команды.

Пример: создать скрипт для запуска браузера

Нажмите «New» → «Script».
Дайте скрипту имя.
В поле кода замените плейсхолдер на следующий пример (используется стандартный модуль subprocess):

import subprocess

# Укажите абсолютный путь до бинарника или команду, доступную в PATH
subprocess.Popen(["/usr/bin/google-chrome"])  # пример для Google Chrome

Назначьте горячую клавишу через кнопку «Set» рядом с «Hotkey».
Нажмите OK и затем Save.

Теперь при нажатии назначенной комбинации скрипт запустит браузер.

Примечание: используйте абсолютные пути к бинарникам или убедитесь, что команда присутствует в PATH при запуске из GUI-сессии.

Полезные примеры скриптов

Вставить текущее время в формате ISO:

from datetime import datetime

ts = datetime.now().isoformat(sep=" ", timespec="seconds")
# В AutoKey можно использовать функцию для вставки текста в активное поле
keyboard.send_keys(ts)

Открыть папку в файловом менеджере (пример для стандартного объекта Nautilus):

import subprocess

subprocess.Popen(["xdg-open", "/home/username/Документы"])  # xdg-open безопасно использует ассоциации системы

Копировать текст в буфер обмена и вставить его:

# Убедитесь, что используете API AutoKey для работы с буфером и клавиатурой
clipboard.fill_clipboard("Шаблон ответа")
keyboard.send_keys("{CTRL+V}")

Замечание: конкретные имена функций для работы с буфером и клавиатурой могут отличаться в зависимости от версии AutoKey; используйте встроенную подсказку API и примеры в приложении.

Лучшие практики и рекомендации

Держите скрипты простыми и небольшими — легче отлаживать и тестировать.
Разделяйте фразы и скрипты по контекстам (работа, личная переписка, код) — это снижает риск ненадлежащих замен.
Используйте понятные имена и комментарии в скриптах.
Не храните секреты (пароли, ключи) в открытом виде в скриптах.
Регулярно создавайте резервные копии ваших шаблонов и скриптов.

Короткая методология тестирования нового скрипта:

Запустите скрипт вручную в безопасном окружении.
Проверьте поведение в целевых приложениях.
Назначьте временный хоткей и протестируйте в реальных сценариях.
Перенесите в рабочую папку после валидации.

Когда AutoKey не подойдёт: ограничения и подводные камни

Wayland: многие функции, связанные с имитацией клавиатуры или глобальными хоткеями, могут работать некорректно под Wayland. Если вы используете Wayland (например, в новых версиях GNOME), проверьте совместимость или используйте XWayland/обходные пути.
Параллельные сеансы: если у вас несколько X-сессий или удалённый рабочий стол, поведение горячих клавиш может отличаться.
Безопасность: скрипты AutoKey выполняют код от вашего имени — не запускайте сценарии из ненадёжных источников.

Альтернативы и инструменты в соседних областях

Espanso — кросс-платформенный текстовый expander с поддержкой YAML-конфигураций;
xdotool — утилита для посылки событий X11 (полезна для низкоуровневой автоматизации);
SikuliX — визуальная автоматизация на основе распознавания изображений (иногда полезно при GUI-автоматизации);
AutoHotkey — популярный инструмент для Windows (при необходимости можно запускать в Wine, но чаще это не удобно).

Выбор инструмента зависит от задач: если нужно только расширение текста — Espanso или комбинация системных средств будет достаточно; для сложных сценариев в Linux AutoKey остаётся удобным вариантом при X11.

Роли и краткие чеклисты

Для разработчика:

Разбить скрипт на тестируемые функции;
Использовать относительные пути и конфигурации, не жёстко прописывать пароли;
Версионировать коллекцию фраз и скриптов.

Для автора контента / копирайтера:

Собрать часто используемые шаблоны (письма, подписи);
Назначить короткие и однозначные аббревиатуры;
Создать папки по тематикам.

Для системного администратора:

Следить за автозапуском и логами;
Ограничить доступ к конфигурации на машине с общим доступом;
Проверять совместимость с политиками безопасности.

Резервное копирование и миграция

Рекомендуется периодически сохранять копию каталога конфигурации AutoKey в вашем домашнем каталоге. Обычно он находится в подкаталоге конфигурации в домашней директории (например, ~/.config/autokey/ или аналогичном). Для переноса на другую машину скопируйте эту папку и импортируйте или поместите в соответствующее место на новой системе.

Если вы переходите между версиями GTK и Qt, экспорт и импорт коллекций обычно возможны без потери данных, но перед крупными изменениями создайте резервную копию.

Безопасность и конфиденциальность

Скрипты AutoKey выполняются с правами пользователя — не запускать код из ненадёжных источников.
Избегайте хранения паролей и секретных ключей в открытом виде в фразах или скриптах.
При работе в многопользовательской среде ограничьте права доступа к конфигурационной папке.

Часто задаваемые вопросы

Работает ли AutoKey под Wayland?

AutoKey в основном ориентирован на X11. Под Wayland некоторые операции (имитация клавиатуры, глобальные хоткеи) могут работать нестабильно или требовать дополнительных настроек. Если для вас критична поддержка Wayland, проверьте актуальные выпуски проекта и тестируйте конкретные сценарии.

Чем autokey-gtk отличается от autokey-qt?

Разница в GUI-библиотеках: GTK подходит для сред GNOME, Qt — для KDE. Функционально обе версии предоставляют аналогичные возможности для фраз и скриптов.

Как восстановить фразы после переустановки системы?

Восстановите ранее созданную резервную копию конфигурационного каталога AutoKey в домашней директории новой системы и перезапустите AutoKey.

Можно ли делиться фразами между пользователями?

Да, но помните про безопасность: не включайте в общие шаблоны секретные данные.

Примеры сценариев применения (идеи)

Вставка шаблонов e-mail (подпись, стандартный ответ);
Вставка часто используемых фрагментов кода или импортов в IDE;
Быстрый запуск утилит и скриптов обслуживания системы;
Автозаполнение форм и часто повторяющихся полей в CRM;
Локальные макросы для работы с текстовыми редакторами.

Заключение

AutoKey — удобный инструмент для экономии времени при повторяющихся операциях в Linux. Начните с простых фраз, постепенно переходите к скриптам на Python, соблюдайте лучшие практики безопасности и храните резервные копии. Если AutoKey не покрывает ваши требования (например, при использовании Wayland или при необходимости визуальной автоматизации), рассмотрите альтернативы.

Important: всегда проверяйте и тестируйте скрипты в безопасном окружении перед применением в рабочей сессии.

Краткое резюме

Установите autokey-gtk или autokey-qt через пакетный менеджер;
Настройте автозапуск и организуйте фразы в папки;
Используйте скрипты для сложных задач, основываясь на Python и subprocess;
Делайте резервные копии и не храните секреты в открытом виде.

Частое обновление навыков и аккуратное оформление коллекции фраз/скриптов позволит сократить рутинную работу и снизить количество ошибок.

Как установить и использовать AutoKey на Linux