# 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).