131 lines
7.6 KiB
Markdown
131 lines
7.6 KiB
Markdown
# remap — переназначение клавиш
|
||
|
||
Переназначает клавиши на кнопки мыши, функции текстового редактора, мультимедиа/веб-действия, эмуляцию горячих клавиш и макросы (канал 04 11, формат — в [protocol.md](../protocol.md)).
|
||
|
||
```
|
||
./katana.py remap --key caps=lmb # Caps → левая кнопка мыши
|
||
./katana.py remap --key caps=lmb --key esc=back # несколько за раз
|
||
./katana.py remap --key caps=default # вернуть стандартное действие
|
||
./katana.py remap --key fn=macro0 # Fn → макрос 0 (однократно)
|
||
./katana.py remap --key fn=macro0:5 # Fn → макрос 0 пять раз
|
||
./katana.py remap --key fn=macro0-toggle # Fn → макрос 0 до повторного нажатия
|
||
./katana.py remap --key caps=copy # Caps → копировать (Ctrl+C)
|
||
./katana.py remap --key menu=paste --key rctrl=undo # функции редактора
|
||
./katana.py remap --key fn=volup # Fn → громкость +
|
||
./katana.py remap --key esc=play --key lwin=calc # мультимедиа и калькулятор
|
||
./katana.py remap --key caps=ctrl+c # Caps → горячая клавиша Ctrl+C
|
||
./katana.py remap --key menu=meta+e # Menu → горячая клавиша Win+E
|
||
./katana.py remap --key rctrl=shift+b --key lalt=f1 # Shift+B и F1
|
||
./katana.py remap --clear # сбросить ВСЕ переназначения
|
||
```
|
||
|
||
## Аргументы `remap`
|
||
|
||
### `--key КЛЮЧ=ДЕЙСТВИЕ`
|
||
|
||
Переназначить одну клавишу.
|
||
Повторяется сколько нужно.
|
||
КЛЮЧ — те же имена, что в `paint --key` (имена из `keymap.py`, символы, синонимы, hex-индексы).
|
||
Действия перечислены ниже.
|
||
|
||
### Действия `--key`
|
||
|
||
**Мышь:**
|
||
|
||
| Имена | Кнопка |
|
||
| ------------------------- | ------------------ |
|
||
| `lmb`, `mouse1` | левая |
|
||
| `rmb`, `mouse2` | правая |
|
||
| `mmb`, `mouse3` | средняя |
|
||
| `back`, `mouseback` | назад (боковая) |
|
||
| `forward`, `mouseforward` | вперёд (боковая) |
|
||
|
||
**Шорткаты редактора:**
|
||
|
||
| Имя | Функция | Шорткат |
|
||
| ----------- | ------------ | ------- |
|
||
| `open` | Открыть | Ctrl+O |
|
||
| `new` | Создать | Ctrl+N |
|
||
| `undo` | Отмена | Ctrl+Z |
|
||
| `save` | Сохранить | Ctrl+S |
|
||
| `copy` | Копировать | Ctrl+C |
|
||
| `cut` | Вырезать | Ctrl+X |
|
||
| `paste` | Вставить | Ctrl+V |
|
||
| `find` | Найти | Ctrl+F |
|
||
| `selectall` | Выбрать всё | Ctrl+A |
|
||
|
||
**Мультимедиа и веб:**
|
||
|
||
| Имя | Функция |
|
||
| ------------------------------ | ------------------------ |
|
||
| `player` | Плеер |
|
||
| `play`, `playpause` | Воспроизведение/пауза |
|
||
| `stop` | Стоп |
|
||
| `prev`, `prevsong` | Предыдущая песня |
|
||
| `next`, `nextsong` | Следующая песня |
|
||
| `volup` | Громкость + |
|
||
| `voldown` | Громкость − |
|
||
| `mute` | Без звука |
|
||
| `home`, `homepage` | Домашняя страница |
|
||
| `refresh`, `webrefresh` | Веб: обновить |
|
||
| `webstop` | Веб: остановить |
|
||
| `webback` | Веб: назад |
|
||
| `webforward` | Веб: вперед |
|
||
| `favorites`, `webfavorites` | Веб: избранное |
|
||
| `websearch`, `search` | Веб: поиск |
|
||
| `mycomputer`, `computer` | Мой компьютер |
|
||
| `calculator`, `calc` | Калькулятор |
|
||
| `email` | Электронная почта |
|
||
|
||
**Горячие клавиши:** `MOD+КЛАВИША` — эмуляция шортката с модификаторами, модификаторы можно комбинировать через `+` (например `ctrl+shift+x`).
|
||
Без модификатора тоже работает: `a` — просто клавиша A.
|
||
Формат снят по дампу keybind-hotkeys; одиночные модификаторы и комбинации (`ctrl+shift+c`) проверены на железе.
|
||
|
||
| Модификатор (`MOD`) | Смысл |
|
||
| ----------------------- | ----------- |
|
||
| `ctrl` | Ctrl |
|
||
| `shift` | Shift |
|
||
| `alt` | Alt |
|
||
| `meta`, `win`, `super` | Meta (Win) |
|
||
|
||
| Клавиша | Смысл |
|
||
| ---------------------- | ---------------------------------- |
|
||
| `a`..`z` | буквы |
|
||
| `0`..`9` | цифры верхнего ряда |
|
||
| `f1`..`f12` | F-клавиши |
|
||
| `esc` | Esc |
|
||
| `tab` | Tab |
|
||
| `enter` | Enter |
|
||
| `space` | пробел |
|
||
| `caps` | Caps Lock |
|
||
| `backspace` | Backspace |
|
||
| `num0`..`num9` | цифры нумпада |
|
||
| `fn` | Fn (собственный код прошивки) |
|
||
|
||
Примеры: `ctrl+c` (копировать), `shift+b`, `alt+d`, `meta+e` (Win+E), `esc`, `f1`, `num1`, `fn`.
|
||
|
||
**Макросы:**
|
||
|
||
| Формат | Поведение |
|
||
| ------------------- | ------------------------------ |
|
||
| `macro<N>` | макрос N однократно |
|
||
| `macro<N>:K` | макрос N повторить K раз |
|
||
| `macro<N>-toggle` | макрос N до повторного нажатия |
|
||
|
||
**Стандартное действие:** `default`/`none`/`off`.
|
||
|
||
### `--clear`
|
||
|
||
Сбросить все переназначения: записывается таблица из одних default-записей.
|
||
Нельзя сочетать с `--key`.
|
||
|
||
### `--no-save`
|
||
|
||
Не писать во флеш (см. `mode --no-save` в [color-modes.md](../color-modes.md)).
|
||
|
||
**Важно:** каждый вызов перезаписывает ВСЮ таблицу переназначений (как вендорская утилита).
|
||
Переназначения, не указанные в текущем вызове `--key`, сбрасываются в default.
|
||
Команда чтения текущих переназначений неизвестна — учитывайте это при комбинировании.
|
||
|
||
Макросы, на которые можно ссылаться через `macro<N>`, записываются командой `macro` — см. [macro.md](macro.md).
|