tools/caps2esc
0
0
Fork 0
mirror of https://gitlab.com/interception/linux/plugins/caps2esc.git synced 2025-04-07 06:55:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Compare commits

base: tools:master
Branches Tags
tools:master
tools:v0.3.2
tools:v0.3.1
tools:v0.3.0
tools:v0.2.0
tools:v0.1.3
tools:v0.1.2
tools:v0.1.1
tools:v0.1.0
..
compare: tools:v0.3.0
Branches Tags
tools:master
tools:v0.3.2
tools:v0.3.1
tools:v0.3.0
tools:v0.2.0
tools:v0.1.3
tools:v0.1.2
tools:v0.1.1
tools:v0.1.0

No commits in common. "master" and "v0.3.0" have entirely different histories.
master ... v0.3.0

2 changed files with 64 additions and 80 deletions
Show Stats Expand all files Collapse all files

55
README.md
View File

@ -25,8 +25,8 @@ ESC when pressed alone is quite handy, specially in vi.
## Building ## Building
```text ```
$ git clone https://gitlab.com/interception/linux/plugins/caps2esc.git $ git clone git@gitlab.com:interception/linux/plugins/caps2esc.git
$ cd caps2esc $ cd caps2esc
$ cmake -B build -DCMAKE_BUILD_TYPE=Release $ cmake -B build -DCMAKE_BUILD_TYPE=Release
$ cmake --build build $ cmake --build build
@ -34,10 +34,10 @@ $ cmake --build build
## Execution ## Execution
```text ```
caps2esc - transforming the most useless key ever in the most useful one caps2esc - transforming the most useless key ever in the most useful one
usage: caps2esc [-h | [-m mode] [-t delay]] usage: caps2esc [-h] [-m mode] [-t delay]
options: options:
-h show this message and exit -h show this message and exit
@ -54,67 +54,56 @@ options:
``` ```
`caps2esc` is an [_Interception Tools_][interception-tools] plugin. A suggested `caps2esc` is an [_Interception Tools_][interception-tools] plugin. A suggested
`udevmon` job configuration (check the [_Interception Tools_ `udevmon` job configuration is:
README][interception-tools] for alternatives) is:
```yaml ```yaml
- JOB: intercept -g $DEVNODE | caps2esc | uinput -d $DEVNODE - JOB: intercept -g $DEVNODE | caps2esc | uinput -d $DEVNODE
DEVICE: DEVICE:
EVENTS: EVENTS:
EV_KEY: [KEY_CAPSLOCK, KEY_ESC] EV_KEY: [KEY_CAPSLOCK, KEY_ESC]
``` ```
For more information about the [_Interception Tools_][interception-tools], check For more information about the [_Interception Tools_][interception-tools], check
the project's website. the project's website.
## Mouse/Touchpad Support ## Mouse button support
After _Interception Tools_ 0.3.2, `caps2esc` can observe (or replace) mouse After _Interception Tools_ 0.3, `caps2esc` can work with mouse clicks. An
events. An example configuration taken from my laptop: example configuration taken from my laptop:
```yaml ```yaml
SHELL: [zsh, -c] SHELL: [zsh, -c]
--- ---
- CMD: mux -c caps2esc - JOB: mux -c caps2esc
- JOB: mux -i caps2esc | caps2esc | uinput -c /etc/interception/keyboard.yaml - JOB:
- JOB: intercept -g $DEVNODE | mux -o caps2esc - intercept -g $DEVNODE | mux -o caps2esc
- mux -i caps2esc | caps2esc | uinput -d $DEVNODE
DEVICE: DEVICE:
LINK: /dev/input/by-path/platform-i8042-serio-0-event-kbd LINK: /dev/input/by-path/platform-i8042-serio-0-event-kbd
- JOB: intercept $DEVNODE | mux -o caps2esc - JOB:
- intercept $DEVNODE | mux -o caps2esc
DEVICE: DEVICE:
LINK: /dev/input/by-path/platform-i8042-serio-4-event-mouse LINK: /dev/input/by-path/platform-i8042-serio-4-event-mouse
``` ```
For more information on the topic, check the [_Interception Tools_ For more information on the topic, check the [_Interception Tools_
README][interception-tools] about usage of the `mux` tool and hybrid virtual README][interception-tools] about usage of the `mux` tool and device specific
device configurations. setups.
## Installation ## Installation
### Archlinux
It's available from [community](https://archlinux.org/packages/community/x86_64/interception-caps2esc/): It's available from [community](https://archlinux.org/packages/community/x86_64/interception-caps2esc/):
```text ```
$ pacman -S interception-caps2esc $ pacman -S interception-caps2esc
``` ```
### Void Linux I don't use Ubuntu and recommend Archlinux instead, as it provides the AUR, so I
don't maintain PPAs. For more information on Ubuntu/Debian installation check
this:
```text - <https://askubuntu.com/questions/979359/how-do-i-install-caps2esc>
$ xbps-install -S caps2esc
```
### Ubuntu ([independent package][ubuntu])
```text
sudo add-apt-repository ppa:deafmute/interception
sudo apt install interception-caps2esc
```
<sub>For debian and other derivatives you can download directly at https://launchpad.net/~deafmute/+archive/ubuntu/interception/+packages.</sub>
[ubuntu]: https://gitlab.com/interception/linux/tools/-/issues/38
## Caveats ## Caveats

89
caps2esc.c
View File

@ -6,11 +6,11 @@
// clang-format off // clang-format off
const struct input_event const struct input_event
syn = {.type = EV_SYN , .code = SYN_REPORT , .value = 0}, syn = {.type = EV_SYN, .code = SYN_REPORT, .value = 0},
esc_up = {.type = EV_KEY , .code = KEY_ESC , .value = 0}, esc_up = {.type = EV_KEY, .code = KEY_ESC, .value = 0},
ctrl_up = {.type = EV_KEY , .code = KEY_LEFTCTRL , .value = 0}, ctrl_up = {.type = EV_KEY, .code = KEY_LEFTCTRL, .value = 0},
esc_down = {.type = EV_KEY , .code = KEY_ESC , .value = 1}, esc_down = {.type = EV_KEY, .code = KEY_ESC, .value = 1},
ctrl_down = {.type = EV_KEY , .code = KEY_LEFTCTRL , .value = 1}; ctrl_down = {.type = EV_KEY, .code = KEY_LEFTCTRL, .value = 1};
// clang-format on // clang-format on
void print_usage(FILE *stream, const char *program) { void print_usage(FILE *stream, const char *program) {
@ -18,20 +18,20 @@ void print_usage(FILE *stream, const char *program) {
fprintf(stream, fprintf(stream,
"caps2esc - transforming the most useless key ever in the most useful one\n" "caps2esc - transforming the most useless key ever in the most useful one\n"
"\n" "\n"
"usage: %s [-h | [-m mode] [-t delay]]\n" "usage: %s [-h] [-m mode] [-t delay]\n"
"\n" "\n"
"options:\n" "options:\n"
" -h show this message and exit\n" " -h show this message and exit\n"
" -t delay used for key sequences (default: 20000 microseconds)\n" " -t delay used for key sequences (default: 20000 microseconds)\n"
" -m mode 0: default\n" " -m mode 0: default\n"
" - caps as esc/ctrl\n" " - caps as esc/ctrl\n"
" - esc as caps\n" " - esc as caps\n"
" 1: minimal\n" " 1: minimal\n"
" - caps as esc/ctrl\n" " - caps as esc/ctrl\n"
" 2: useful on 60%% layouts\n" " 2: useful on 60%% layouts\n"
" - caps as esc/ctrl\n" " - caps as esc/ctrl\n"
" - esc as grave accent\n" " - esc as grave accent\n"
" - grave accent as caps\n", " - grave accent as caps\n",
program); program);
// clang-format on // clang-format on
} }
@ -46,39 +46,37 @@ void write_event(const struct input_event *event) {
} }
void write_event_with_mode(struct input_event *event, int mode) { void write_event_with_mode(struct input_event *event, int mode) {
if (event->type == EV_KEY) switch (mode) {
switch (mode) { case 0:
case 0: if (event->code == KEY_ESC)
if (event->code == KEY_ESC) event->code = KEY_CAPSLOCK;
break;
case 2:
switch (event->code) {
case KEY_ESC:
event->code = KEY_GRAVE;
break;
case KEY_GRAVE:
event->code = KEY_CAPSLOCK; event->code = KEY_CAPSLOCK;
break; break;
case 2: }
switch (event->code) { break;
case KEY_ESC: }
event->code = KEY_GRAVE;
break;
case KEY_GRAVE:
event->code = KEY_CAPSLOCK;
break;
}
break;
}
write_event(event); write_event(event);
} }
int main(int argc, char *argv[]) { int main(int argc, char *argv[]) {
int mode = 0, delay = 20000; int opt, mode = 0, delay = 20000;
while ((opt = getopt(argc, argv, "ht:m:")) != -1) {
for (int opt; (opt = getopt(argc, argv, "ht:m:")) != -1;) {
switch (opt) { switch (opt) {
case 'h': case 'h':
return print_usage(stdout, argv[0]), EXIT_SUCCESS; return print_usage(stdout, argv[0]), EXIT_SUCCESS;
case 'm':
mode = atoi(optarg);
continue;
case 't': case 't':
delay = atoi(optarg); delay = atoi(optarg);
continue; continue;
case 'm':
mode = atoi(optarg);
continue;
} }
return print_usage(stderr, argv[0]), EXIT_FAILURE; return print_usage(stderr, argv[0]), EXIT_FAILURE;
@ -93,22 +91,20 @@ int main(int argc, char *argv[]) {
if (input.type == EV_MSC && input.code == MSC_SCAN) if (input.type == EV_MSC && input.code == MSC_SCAN)
continue; continue;
if (input.type != EV_KEY && input.type != EV_REL && if (input.type != EV_KEY) {
input.type != EV_ABS) {
write_event(&input); write_event(&input);
continue; continue;
} }
switch (state) { switch (state) {
case START: case START:
if (input.type == EV_KEY && input.code == KEY_CAPSLOCK && if (input.code == KEY_CAPSLOCK && input.value)
input.value)
state = CAPSLOCK_HELD; state = CAPSLOCK_HELD;
else else
write_event_with_mode(&input, mode); write_event_with_mode(&input, mode);
break; break;
case CAPSLOCK_HELD: case CAPSLOCK_HELD:
if (input.type == EV_KEY && input.code == KEY_CAPSLOCK) { if (input.code == KEY_CAPSLOCK) {
if (input.value == 0) { if (input.value == 0) {
write_event(&esc_down); write_event(&esc_down);
write_event(&syn); write_event(&syn);
@ -116,8 +112,7 @@ int main(int argc, char *argv[]) {
write_event(&esc_up); write_event(&esc_up);
state = START; state = START;
} }
} else if ((input.type == EV_KEY && input.value == 1) || } else if (input.value == 1) {
input.type == EV_REL || input.type == EV_ABS) {
write_event(&ctrl_down); write_event(&ctrl_down);
write_event(&syn); write_event(&syn);
usleep(delay); usleep(delay);
@ -127,7 +122,7 @@ int main(int argc, char *argv[]) {
write_event_with_mode(&input, mode); write_event_with_mode(&input, mode);
break; break;
case CAPSLOCK_IS_CTRL: case CAPSLOCK_IS_CTRL:
if (input.type == EV_KEY && input.code == KEY_CAPSLOCK) { if (input.code == KEY_CAPSLOCK) {
input.code = KEY_LEFTCTRL; input.code = KEY_LEFTCTRL;
write_event(&input); write_event(&input);
if (input.value == 0) if (input.value == 0)