Как привязать сочетания клавиш к программам Wine в Linux

Введение

Вы любите Linux, но вам нужны Windows‑программы, которые работают через Wine. Часто привычные сочетания клавиш из Windows не срабатывают в Linux — это неудобно. В этой статье объясним, как связать/переопределить сочетания клавиш для приложений, запущенных под Wine, какие инструменты использовать и как отладить типовые проблемы.

Важно: предполагается, что Wine уже установлен и сама программа запускается. Некоторые приложения требуют явного включения горячих клавиш в настройках (Options/Settings).

Быстрый обзор инструментов

• xdotool — эмулирует нажатия клавиш и мыши, ищет окна по названию. Полезен для отправки событий в конкретное окно Wine.
• xte (пакет xautomation) — отправляет низкоуровневые события через XTest.
• xbindkeys — перехватывает глобальные нажатия клавиш и запускает команды/скрипты.
• Gnome/Metacity keybindings — для GNOME можно задать команды и привязать их к мультимедийным клавишам.
• Autokey — альтернативный вариант для сложных сценариев автоматизации.

Почему это работает: кратко

Wine запускает Windows‑программу в X11/Wayland окружении. События клавиатуры приходят через X11 (или Wayland), и их можно перехватить и переслать в нужное окно. Инструменты выше эмулируют или перенаправляют эти события.

Xdotool — пример и синтаксис

Xdotool позволяет симулировать ввод и искать окна. Установите его стандартной командой:

sudo apt-get install xdotool

Базовый шаблон для отправки комбинации в окно приложения:

xdotool key --window $(xdotool search --name "YOUR_APP" | head -n1) YOUR_KEYSTROKE

Пример: назначим глобальные мультимедийные клавиши для Spotify. Сохраним удобный скрипт music.sh (взято и адаптировано из вики Arch Linux):

#!/bin/sh

case $1 in
  "play")
    key="XF86AudioPlay"
    ;;
  "next")
    key="XF86AudioNext"
    ;;
  "prev")
    key="XF86AudioPrev"
    ;;
  *)
    echo "Usage: $0 play|next|prev"
    exit 1
    ;;
esac

xdotool key --window $(xdotool search --name "Spotify (Premium )?- Linux Preview" | head -n1) $key

exit 0

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

chmod +x ~/bin/music.sh

Привязка скрипта к глобальным клавишам

xbindkeys — один из простых способов запускать команду при нажатии глобальной клавиши. Примерent файла ~/.xbindkeysrc (формат для xbindkeys):

"~/bin/music.sh play"
  XF86AudioPlay

"~/bin/music.sh next"
  XF86AudioNext

"~/bin/music.sh prev"
  XF86AudioPrev

Если вы используете окружение с XML/ini-конфигом (например, старые настройки GNOME), привязка может выглядеть по-другому — в документации вашей среды смотрите формат.

Устранение ошибок модификаторов

Частая проблема — при записи комбинации застрявшие модификаторы (Ctrl/Shift/Alt) или лишние key_down/key_up события. У xdotool есть опция –clearmodifiers, которая временно «отпускает» модификаторы, выполняет команду и восстанавливает их:

xdotool key --clearmodifiers XF86AudioRaiseVolume

Это помогает, если при назначении ключа система считает, что клавиша-модификатор ещё зажата.

Пример для foobar2000

В отличие от Spotify, foobar2000 под Wine часто умеет принимать мультимедийные клавиши напрямую. Если нет — можно прописать команды в конфиге Metacity/GNOME.

1. Откройте Gnome Configuration Editor.
2. Перейдите в /apps/metacity/keybinding_commands и задайте:

command_1 - wine ~/.foobar2000/foobar2000.exe /playpause
command_2 - wine ~/.foobar2000/foobar2000.exe /stop
command_3 - wine ~/.foobar2000/foobar2000.exe /next
command_4 - wine ~/.foobar2000/foobar2000.exe /prev

3. Затем в /apps/metacity/global_keybindings установите:

run_command_1 - XF86AudioPause
run_command_2 - XF86AudioStop
run_command_3 - XF86AudioNext
run_command_4 - XF86AudioPrev

После этого мультимедиа‑клавиши будут вызывать соответствующие команды Wine → foobar2000.

XTE (xautomation) — низкоуровневое управление

Xte входит в пакет xautomation и отправляет события через расширение XTest. Установка (если нужны оба пакета):

sudo apt-get install xdotool
sudo apt-get install xautomation
sudo apt-get install xwd

Пример: назначим XF86Back на переключение вкладки (эмуляция Ctrl+PageUp). Создайте исполняемый скрипт sc_back:

#!/bin/bash

/usr/bin/xte 'keydown Control_L' 'keydown Page_Up' 'keyup Page_Up' 'keyup Control_L'

Дайте права 755 и свяжите XF86Back с запуском sc_back через xbindkeys или системные сочетания клавиш.

Альтернативные подходы

• Autokey — удобен для сложных макросов и сценариев на Python; хорошо интегрируется с X11.
• wmctrl — полезен для управления окнами (переключение/фокус) в связке с xdotool.
• Использовать встроенные средства вашей DE (KDE, GNOME, XFCE) для привязки команд к клавишам.

Практическое руководство: пошаговый SOP

1. Убедитесь, что приложение запускается в Wine и что горячие клавиши включены в его настройках.
2. Определите цель — глобальная клавиша или только при фокусе окна.
3. Попробуйте послать событие напрямую через xdotool в окно приложения (поиск по имени окна).
4. Если нужно глобальное перехватывание — настройте xbindkeys или DE keybindings, чтобы запускать скрипт.
5. Используйте –clearmodifiers при проблемах с модификаторами.
6. Проверьте, не перехватывает ли клавиши другое приложение (менеджер мультимедиа, плеер, DE).
7. Тестируйте в нескольких сценариях (разные рабочие столы, переключение панели задач).

Критерии приёмки:

• Горячие клавиши срабатывают, когда приложение запущено и доступно.
• Никакие системные комбинации не конфликтуют (или конфликт решён).
• Модификаторы корректно обрабатываются (нет залипаний).

Отладка и типичные проблемы

• Конфликт клавиш с DE (KDE/GNOME могут перехватывать мультимедийные клавиши). Решение: отключить назначение в DE или изменить приоритет.
• Несовпадение имени окна при поиске xdotool search — используйте регулярные части названия или получайте список окон через xdotool search --onlyvisible --name . и проверяйте вручную.
• Приложение блокирует хоткеи (нужно включить их в настройках приложения).

Совет: временно записывайте все события через xev или xinput test чтобы увидеть, какие события реально уходят в X.

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

Пользователь (обычные задачи):

• Установить xdotool и xbindkeys.
• Создать простые скрипты для play/pause/next.
• Назначить их в ~/.xbindkeysrc.

Power user (настройка и отладка):

• Использовать –clearmodifiers при ошибках.
• Диагностировать с помощью xev/xinput.
• Прописать условия в скрипте (поиск по PID/окну).

Системный администратор (масштаб/политики):

• Проверить глобальные политики DE/DM, блокирующие доступ к мультимедиа.
• Документировать конфигурации для развёртывания.

Решение: какой инструмент выбрать (дерево решений)

flowchart TD
  A[Нужно назначить сочетание для Wine-приложения?] --> B{Требуется глобальная клавиша?}
  B -- Да --> C[xbindkeys или DE keybinding -> запускает скрипт]
  B -- Нет --> D[Только в фоне/в окне -> xdotool key --window]
  C --> E{Нужна low-level эмуляция?}
  E -- Да --> F[xte 'xautomation']
  E -- Нет --> G[xdotool]
  D --> G
  G --> H[Тест, use --clearmodifiers при проблемах]
  F --> H

Когда это не сработает

• Приложение читает клавиши напрямую через драйверы и игнорирует X события (редкие случаи). В этом случае нужно искать внутренние настройки приложения.
• В Wayland некоторые инструменты (xdotool/xte) работают ограниченно или требуют дополнительных слоёв совместимости (XWayland).

Безопасность и приватность

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

Совместимость и миграция

• На Wayland функционал будет отличаться: проверьте, работает ли XWayland и какие инструменты поддерживаются вашей средой.
• При миграции с одной DE на другую проверьте, не перекрывают ли системные настройки ваши назначения.

Примеры тестов и критерии приёмки

• Нажать назначенную клавишу при запущенном приложении — ожидается выполнение команды (play/pause).
• Нажать комбинацию при зажатом Ctrl/Shift — убедиться, что –clearmodifiers решает проблему.
• Отключить xbindkeys и проверить, что другие приложения не потеряли управление мультимедиа.

Краткий глоссарий

• Wine — слой совместимости для запуска Windows-приложений в Unix-подобных ОС.
• xdotool — инструмент для эмуляции ввода в X11.
• xte / xautomation — альтернатива для отправки событий через XTest.
• xbindkeys — перехват и привязка глобальных клавиш к командам.

Важно: экспериментируйте в безопасной среде, сначала с простыми скриптами.

Резюме

• Для большинства задач xdotool + xbindkeys решают проблему привязки горячих клавиш к приложениям Wine.
• Если требуются низкоуровневые события, используйте xte (xautomation).
• На Wayland и в некоторых окружениях возможны ограничения — проверяйте совместимость.

Примечание: если вы предпочитаете вариант с графическим интерфейсом и более сложными сценариями, посмотрите Autokey.

Image credits: William Hook, F Hashemi, Walt Stoneburner