PyKeyBoardFairy

Введение

Python-написанный простой вариант клавиатурного эльфа. Может заменить игровые макросы клавиатуры и мыши.

Архитектура программы

Программа зависит только от одной внешней библиотеки: pynput 1.7.3.

Инструкция по установке

1. Скачайте программу, используя команду git clone https://gitee.com/J_Sky/py-key-board-fairy.git. Также можно скачать сжатый архив.
2. Убедитесь, что на вашей системе установлен Python, и установите зависимость с помощью команды pip install pynput.
3. Измените файл конфигурации программы main.py, чтобы настроить параметры в списке keyList в соответствии с требованиями к имитируемым клавишам.
4. Запустите программу в терминале с помощью команды python main.py. Затем нажмите кнопку запуска в программе, чтобы начать имитацию клавиш.

Использование

1. Настройка параметров: Все параметры программы сосредоточены в файле main.py в списке keyList. Изменение этого списка позволяет реализовать множественное моделирование клавиш. Описание параметров для моделирования клавиш:

• key_type:
  • interval: волшебная вспомогательная клавиша, которая нажимается через определённые промежутки времени.
  • combination: комбинация навыков, имитирующая нажатие группы клавиш в определённом порядке и с определёнными интервалами (каждая клавиша навыка нажимается один раз).
  • always: постоянно удерживаемая клавиша с возможностью кратковременной паузы. Если key_type = always, добавляется параметр времени «t1», который подробно описан ниже.
• key_switch: Key.ctrl — управляющая клавиша, отвечающая за управление моделированием этой клавиши навыка. Нажатие ctrl запускает моделирование клавиши, повторное нажатие ctrl приостанавливает моделирование.
• key: 'b' — клавиша, которую нужно смоделировать.
• is_start: 0 — переключатель, определяющий, будет ли текущая клавиша навыка включена при запуске программы. Обычно это 0 или 1.
• t: 0.5 — интервал времени между отпусканием текущей клавиши и повторным её нажатием, измеряется в секундах.
• t1: 5 — если key_type=always, этот атрибут действует и означает, что клавиша удерживается в течение 5 секунд.

1. Пример настройки параметров:
   • Требование 1: предположим, есть группа клавиш навыков: b, c, d, каждая из которых должна быть нажата примерно на 10–60 секунд, поскольку время не определено, поэтому установлено значение 0,5 секунды, а запуск осуществляется с помощью левой клавиши alt. Конфигурация keyList:

keyList = [
    {
        "key_type": "interval",
        "key_switch": 'alt',
        "key": 'b',
        "is_start": 0,
        "t": 0.5,
    },
    {
        "key_type": "interval",
        "key_switch": 'alt',
        "key": 'c',
        "is_start": 0,
        "t": 0.5,
    },
    {
        "key_type": "interval",
        "key_switch": 'alt',
        "key": 'd',
        "is_start": 0,
        "t": 0.5,
    }
]

* Требование 2: предположим, есть две клавиши навыков: b и c. Клавиша b должна быть нажата один раз примерно через 10–60 секунд, так как время не определено, поэтому устанавливается значение 0,5 секунды. Клавишу c нужно удерживать в течение 5 секунд с паузой в 0,5 секунды после каждого нажатия. Запуск осуществляется с помощью левой клавиши alt.

Конфигурация keyList:

keyList = [
    {
        "key_type": "interval",
        "key_switch": 'alt',
        "key": 'b',
        "is_start": 0,
        "t": 0.5,
    },
    {
        "key_type": "always",
        "key_switch": 'alt',
        "key": 'c',
        "is_start": 0,
        "t": 0.5,
        "t1":5
    }
]

* Требование 3: предположим, есть набор комбинаций клавиш навыков: b, c, d. Я хочу нажать управляющую клавишу z, затем сначала смоделировать нажатие клавиши b, через 0,5 секунды смоделировать нажатие c и через 1 секунду смоделировать d.

Конфигурация keyList:

keyList = [
    {
        "key_type": "combination",
        "key_switch": 'z',
        "key": 'b',
        "is_start": 0,
        "t": 0,
    },
    {
        "key_type": "combination",
        "key_switch": 'z',
        "key": 'c',
        "is_start": 0,
        "t": 0.5,
    },
    {
        "key_type": "combination",
        "key_switch": 'z',
        "key": 'd',
        "is_start": 0,
        "t": 1,
    }
]

При использовании комбинации клавиш key_type: «combination» необходимо обратить внимание на порядок и время клавиш навыков, управляемых одной и той же управляющей клавишей.

Участие и вклад

На данный момент не рассматривается создание графического интерфейса пользователя (GUI). Если у кого-то есть опыт, можно попробовать создать интерфейс GUI для настройки keyList, что может быть более удобным.

Процесс участия и вклада:

1. Fork этого репозитория.
2. Создайте ветку Feat_xxx.
3. Отправьте код.
4. Создайте запрос на вытягивание (Pull Request).