Interception-tools - 版の履歴

AshMyzk: /* 複数のジョブを処理する */ 修正

2023-08-11T00:50:25Z

複数のジョブを処理する: 修正

← 古い版		2023年8月11日 (金) 09:50時点における版
137行目:		137行目:
	==== 複数のジョブを処理する ====		==== 複数のジョブを処理する ====

	{{ic\|mux}} を使うことで、複数のパイプラインを1つにまとめることができます。		{{ic\|mux}} を使うことで、複数のパイプラインを1つにまとめることができます。''muxer'' を先に作成しておく必要があります。作成した muxer は、後にパイプラインの入力や出力として使用できます。YAML 設定ファイルでは、muxer は {{ic\|CMD}} キーを使って作成できます:
	''muxer'' を先に作成しておく必要があります。
	作成した muxer は、後にパイプラインの入力や出力として使用できます。
	YAML 設定ファイルでは、muxer は {{ic\|CMD}} キーを使って作成できます:

	{{bc\|		{{bc\|
153行目:		150行目:
	}}		}}

	上記の例では、キーボードが接続された時に、キーボードは捕捉 (grab) され、入力イベントは最初に作成しておいた {{ic\|caps2esc}} muxer に送られます。マウスから観測された (捕捉されていない) 入力も、同じ muxer に送られます ~~(訳注: "捕捉 (grab)" の意味は、[[#コマンドを挟む]] セクションの訳注を見てください)~~。マウスのボタンは {{ic\|EV_KEY}} イベントを生成するので、{{ic\|caps2esc}} はそのイベントを受け入れます。		上記の例では、キーボードが接続された時に、キーボードは捕捉 (grab) され、入力イベントは最初に作成しておいた {{ic\|caps2esc}} muxer に送られます。マウスから観測された (捕捉されていない) 入力も、同じ muxer に送られます。マウスのボタンは {{ic\|EV_KEY}} イベントを生成するので、{{ic\|caps2esc}} はそのイベントを受け入れます。

	== 参照 ==		== 参照 ==

AshMyzk: /* 実用例 */ 口調を揃える

2023-08-11T00:44:00Z

実用例: 口調を揃える

← 古い版		2023年8月11日 (金) 09:44時点における版
61行目:		61行目:
	Interception-tools では4つのユーティリティが使用できます:		Interception-tools では4つのユーティリティが使用できます:

	* {{ic\|intercept}}: デバイスの入力イベントを標準出力にリダイレクトします。		* {{ic\|intercept}}: デバイスの入力イベントを標準出力にリダイレクトする。
	* {{ic\|mux}}: 入力イベントの複数のストリームを結合します。		* {{ic\|mux}}: 入力イベントの複数のストリームを結合する。
	* {{ic\|udevmon}}: 入力デバイスを監視し、(それに応じて) タスクを開始する。		* {{ic\|udevmon}}: 入力デバイスを監視し、(それに応じて) タスクを開始する。
	* {{ic\|uinput}}: 入力イベントを標準入力から仮想デバイスへリダイレクトする。		* {{ic\|uinput}}: 入力イベントを標準入力から仮想デバイスへリダイレクトする。

AshMyzk: TranslationStatus

2023-08-11T00:40:56Z

TranslationStatus

← 古い版		2023年8月11日 (金) 09:40時点における版
160行目:		160行目:
	* [https://gitlab.com/interception/linux/tools 公式ウェブサイト]		* [https://gitlab.com/interception/linux/tools 公式ウェブサイト]
	* [https://github.com/kmonad/kmonad kmonad] - 高度なキーボードリマッピングツールのデーモン		* [https://github.com/kmonad/kmonad kmonad] - 高度なキーボードリマッピングツールのデーモン

			{{TranslationStatus\|interception-tools\|2023-08-11\|785050}}

AshMyzk: /* 設定 */ 翻訳

2023-08-11T00:40:21Z

設定: 翻訳

差分を表示

AshMyzk: 余分な空白を削除

2023-08-10T22:45:59Z

余分な空白を削除

← 古い版		2023年8月11日 (金) 07:45時点における版
11行目:		11行目:
	[https://gitlab.com/interception/linux/tools interception-tools] は、キーボード入力のマッピングの制御とカスタマイズをするためのユーティリティのセットです。		[https://gitlab.com/interception/linux/tools interception-tools] は、キーボード入力のマッピングの制御とカスタマイズをするためのユーティリティのセットです。

	interception-tools は、[https://www.freedesktop.org/software/libevdev/doc/latest/index.html libevdev] と {{man\|3\|libudev}} を使用することで、他の似たようなツール ({{Pkg\|xcape}}、[[xmodmap]]) よりも低レベルで動作します。ゆえに interception-tools は、[[X11]]、[[Wayland]]、そして [[Linux コンソール]] の全てでキーボードの挙動をカスタマイズできる数少ない方法の1つとなります。		interception-tools は、[https://www.freedesktop.org/software/libevdev/doc/latest/index.html libevdev] と {{man\|3\|libudev}} を使用することで、他の似たようなツール ({{Pkg\|xcape}}、[[xmodmap]]) よりも低レベルで動作します。ゆえに interception-tools は、[[X11]]、[[Wayland]]、そして [[Linux コンソール]]の全てでキーボードの挙動をカスタマイズできる数少ない方法の1つとなります。

	== インストール ==		== インストール ==

AshMyzk: 冒頭を訳を修正

2023-08-10T12:47:50Z

冒頭を訳を修正

← 古い版		2023年8月10日 (木) 21:47時点における版
11行目:		11行目:
	[https://gitlab.com/interception/linux/tools interception-tools] は、キーボード入力のマッピングの制御とカスタマイズをするためのユーティリティのセットです。		[https://gitlab.com/interception/linux/tools interception-tools] は、キーボード入力のマッピングの制御とカスタマイズをするためのユーティリティのセットです。

	interception-tools は、[https://www.freedesktop.org/software/libevdev/doc/latest/index.html libevdev] と {{man\|3\|libudev}} を使用することで、他の似たようなツール ({{Pkg\|xcape}}、[[xmodmap]]) よりも低レベルで動作します。ゆえに interception-tools は、[[X11]]、[[Wayland]]、そして [[Linux コンソール]] の全てでキーボードをカスタマイズできる数少ない方法の1つとなります。		interception-tools は、[https://www.freedesktop.org/software/libevdev/doc/latest/index.html libevdev] と {{man\|3\|libudev}} を使用することで、他の似たようなツール ({{Pkg\|xcape}}、[[xmodmap]]) よりも低レベルで動作します。ゆえに interception-tools は、[[X11]]、[[Wayland]]、そして [[Linux コンソール]] の全てでキーボードの挙動をカスタマイズできる数少ない方法の1つとなります。

	== インストール ==		== インストール ==

AshMyzk: /* 参照 */ 翻訳

2023-08-10T12:45:24Z

参照: 翻訳

← 古い版		2023年8月10日 (木) 21:45時点における版
158行目:		158行目:
	== 参照 ==		== 参照 ==

	* [[入力リマップユーティリティ]] - ~~Lists similar software.~~		* [[入力リマップユーティリティ]] - 似たようなソフトウェアのリストがいくつかあります。
	* [https://gitlab.com/interception/linux/tools ~~Official website~~]		* [https://gitlab.com/interception/linux/tools 公式ウェブサイト]
	* [https://github.com/kmonad/kmonad kmonad] - ~~advanced keyboard remapping tool daemon~~		* [https://github.com/kmonad/kmonad kmonad] - 高度なキーボードリマッピングツールのデーモン

AshMyzk: /* インストール */ 翻訳

2023-08-10T12:44:42Z

インストール: 翻訳

← 古い版		2023年8月10日 (木) 21:44時点における版
15行目:		15行目:
	== インストール ==		== インストール ==

	~~[[Install]]~~ {{Pkg\|interception-tools}}.		{{Pkg\|interception-tools}} を[[インストール]]してください。

			利用可能なプラグインはたくさんあります:
	Many plugins are available:

	* {{Pkg\|interception-caps2esc}} ~~to switch~~ {{ic\|~~CapsLock~~}} ~~with~~ {{ic\|~~Ctrl~~}}/{{ic\|~~Esc~~}}		* {{Pkg\|interception-caps2esc}} ({{ic\|Ctrl}}/{{ic\|Esc}} で {{ic\|CapsLock}} を切り替える)
	* {{AUR\|interception-caps2esc-delay-git}}		* {{AUR\|interception-caps2esc-delay-git}}
	* {{AUR\|interception-caps2esc-nocaps-git}}		* {{AUR\|interception-caps2esc-nocaps-git}}
	* {{Pkg\|interception-dual-function-keys}} ~~to modify the behavior of a key when held.~~		* {{Pkg\|interception-dual-function-keys}} (キーが押されたときの挙動を変更する)
	* {{AUR\|interception-hideaway}}		* {{AUR\|interception-hideaway}}
	* {{AUR\|interception-k2k-git}}		* {{AUR\|interception-k2k-git}}

AshMyzk: 冒頭を翻訳

2023-08-10T12:42:43Z

冒頭を翻訳

← 古い版		2023年8月10日 (木) 21:42時点における版
9行目:		9行目:
	{{Related articles end}}		{{Related articles end}}

	[https://gitlab.com/interception/linux/tools interception-tools] ~~is a set of utilities to control and customize the behavior of keyboard input mappings.~~		[https://gitlab.com/interception/linux/tools interception-tools] は、キーボード入力のマッピングの制御とカスタマイズをするためのユーティリティのセットです。

			interception-tools は、[https://www.freedesktop.org/software/libevdev/doc/latest/index.html libevdev] と {{man\|3\|libudev}} を使用することで、他の似たようなツール ({{Pkg\|xcape}}、[[xmodmap]]) よりも低レベルで動作します。ゆえに interception-tools は、[[X11]]、[[Wayland]]、そして [[Linux コンソール]] の全てでキーボードをカスタマイズできる数少ない方法の1つとなります。
	Interception-tools operates at a lower level compared to other similar tools ({{Pkg\|xcape}},
	[[xmodmap]]) by using [https://www.freedesktop.org/software/libevdev/doc/latest/index.html libevdev] and
	{{man\|3\|libudev}}. This makes it one of the only options available for customizing the keyboard behavior across [[X11]], [[Wayland]], and the [[Linux console]].

	== インストール ==		== インストール ==

AshMyzk: ページの作成:「{{Lowercase title}} en:interception-tools Category:入力デバイス Category:キーボード設定 {{Related articles start}} {{Related|Linux コンソー…」

2023-08-10T12:33:10Z

ページの作成:「{{Lowercase title}} en:interception-tools Category:入力デバイス Category:キーボード設定 {{Related articles start}} {{Related|Linux コンソー…」

新規ページ

{{Lowercase title}}
[[en:interception-tools]]
[[Category:入力デバイス]]
[[Category:キーボード設定]]
{{Related articles start}}
{{Related|Linux コンソール/キーボード設定}}
{{Related|Xbindkeys}}
{{Related|Xmodmap}}
{{Related articles end}}

[https://gitlab.com/interception/linux/tools interception-tools] is a set of utilities to control and customize the behavior of keyboard input mappings.

Interception-tools operates at a lower level compared to other similar tools ({{Pkg|xcape}},
[[xmodmap]]) by using [https://www.freedesktop.org/software/libevdev/doc/latest/index.html libevdev] and
{{man|3|libudev}}. This makes it one of the only options available for customizing the keyboard behavior across [[X11]], [[Wayland]], and the [[Linux console]].

== インストール ==

[[Install]] {{Pkg|interception-tools}}.

Many plugins are available:

* {{Pkg|interception-caps2esc}} to switch {{ic|CapsLock}} with {{ic|Ctrl}}/{{ic|Esc}}
* {{AUR|interception-caps2esc-delay-git}}
* {{AUR|interception-caps2esc-nocaps-git}}
* {{Pkg|interception-dual-function-keys}} to modify the behavior of a key when held.
* {{AUR|interception-hideaway}}
* {{AUR|interception-k2k-git}}
* {{AUR|interception-ralt2hyper}}
* {{AUR|interception-space2meta}}
* {{AUR|interception-uswitch}}
* {{AUR|interception-vimproved-git}}
* {{AUR|interception-xswitch}}

== 設定 ==

The tools comprise commandline tools and a [[systemd]] service.

A configuration in {{ic|/etc/interception/udevmon.yaml}} needs to be added before [[start]]ing the packaged {{ic|udevmon.service}}.

{{Note|Configuration files found on {{ic|/etc/interception/udevmon.d/}} are read first, and fallbacks to {{ic|/etc/interception/udevmon.yaml}}.}}

=== 仕組み ===

Interception-tool makes use of ''libevdev'', which according to its wiki is essentially a {{man|2|read}} on steroids for {{ic|/dev/input/eventX}} devices.
It sits in between the kernel and the process handling an event.
In the simplest scenario would look like this:

kernel | libevdev | evtest

For X.Org input modules, the stack would look like this:

kernel | libevdev | xf86-input-evdev | X server | X client

For Wayland, the stack would look like this:

kernel | libevdev | Compositor | Wayland client

In other words, {{ic|libevdev}} is so low level that it does not have knowledge of X/Wayland clients.

=== 実用例 ===

Interception-tools makes 4 utilities available:

* {{ic|intercept}}: redirect device input events to stdout,
* {{ic|mux}}: combine streams of input events,
* {{ic|udevmon}}: monitor input devices for launching tasks,
* {{ic|uinput}}: redirect device input events from stdin to virtual device.

==== 実行優先度を上げる ====

Since the tool is going to be sitting down at the lowest level of the device inputs,
make sure it will behave consistently by increasing {{ic|udevmon}} priority:

# nice -n -20 udevmon -c udevmon.yaml > udevmon.log 2> udevmon.err &

{{Tip|The {{ic|udevmon}} systemd service runs with {{ic|1=Nice=-20}}.}}

==== シンプルなリダイレクト ====

The simplest way or redirecting the event to the stdin (without doing nothing) is:

$ intercept -g ''DEVNODE'' | uinput -d ''DEVNODE''

where {{ic|''DEVNODE''}} is the path to the actual device: e.g. {{ic|/dev/input/by-path/platform-i8042-serio-0-event-kbd}}.

==== コマンドを挟む ====

To actually perform an operation in between the key event and the input, simply pipe it in between {{ic|intercept}} and {{ic|uinput}}.

E.g. with the {{Pkg|interception-caps2esc}} plugin installed:

$ intercept -g ''DEVNODE'' | caps2esc | uinput -d ''DEVNODE''

If we omitted the {{ic|-g}} flag, then device event would have been just ''observed'', not grabbed.

==== YAML で設定する ====

This way of intercepting the input can quickly become sub-optimal, this is where {{ic|udevmon}} comes in handy.
udevmon accepts a YAML configuration with a list of jobs (sh commands by default) to be executed.

In case the device matches a given description:

{{hc|$ udevmon -c caps2esc.conf.yml|
- JOB: intercept -g''DEVNODE'' {{!}} caps2esc {{!}} uinput -d ''DEVNODE''
DEVICE:
LINK: /dev/input/by-path/platform-i8042-serio-0-event-kbd
}}

The {{ic|LINK}} configuration will match a device with a specific name, but it will accept also a regex option.
This can be combined with multiple job specifications to create a default behavior, in each case only the first matching job is going to be executed:

{{bc|
- JOB: intercept -g ''DEVNODE'' {{!}} caps2esc -m 2 {{!}} uinput -d ''DEVNODE''
DEVICE:
LINK: /dev/input/by-id/usb-SEMITEK_USB-HID_Gaming_Keyboard_SN0000000001-event-kbd
- JOB: intercept -g ''DEVNODE'' {{!}} caps2esc {{!}} uinput -d ''DEVNODE''
DEVICE:
EVENTS:
<nowiki>EV_KEY: [[KEY_CAPSLOCK, KEY_ESC]]</nowiki>
LINK: .*-event-kbd
}}

==== デバイスを組み合わせる ====

Beside input emulation, the {{ic|uinput}} tool also serves purpose to print a device's description in YAML format:

$ uinput -p -d /dev/input/by-id/my-kbd

which itself can be fed back to {{ic|uinput}} as:

$ uinput -c my-kbd.yaml

It can also merge device and YAML characteristics, which can be used for instance to combine events coming from keyboard and mouse:

e.g. instance {{ic|CapsLock+Click}} as {{ic|Ctrl+Click}}

$ uinput -p -d /dev/input/by-id/my-kbd -d /dev/input/by-id/my-mouse -c my-extra.yaml

==== 複数のジョブを処理する ====

The {{ic|mux}} is used to combine multiple pipelines into a single one.
A ''muxer'' needs to be created first,
and it can later be used as the input or the output of a given pipeline.
In a YAML specification file, the muxer is created using the {{ic|CMD}} key:

{{bc|
- CMD: mux -c caps2esc
- JOB: mux -i caps2esc {{!}} caps2esc {{!}} uinput -c /etc/interception/gaming-keyboard.yaml
- JOB: intercept -g ''DEVNODE'' {{!}} mux -o caps2esc
DEVICE:
LINK: /dev/input/by-id/my-kbd
- JOB: intercept ''DEVNODE'' {{!}} mux -o caps2esc
DEVICE:
LINK: /dev/input/by-id/my-mouse
}}

In the example above, when the keyboard is connected, it's grabbed and its input events are sent to the {{ic|caps2esc}} muxer that was initially created. Observed input (not grabbed) from mouse is also sent to the same muxer. The buttons of the mouse generate {{ic|EV_KEY}} events, so {{ic|caps2esc}} will accept them.

== 参照 ==

* [[入力リマップユーティリティ]] - Lists similar software.
* [https://gitlab.com/interception/linux/tools Official website]
* [https://github.com/kmonad/kmonad kmonad] - advanced keyboard remapping tool daemon

← 古い版		2023年8月11日 (金) 09:44時点における版
61行目:		61行目:
	Interception-tools では4つのユーティリティが使用できます:		Interception-tools では4つのユーティリティが使用できます:

	* {{ic\|intercept}}: デバイスの入力イベントを標準出力にリダイレクトします。		* {{ic\|intercept}}: デバイスの入力イベントを標準出力にリダイレクトする。
	* {{ic\|mux}}: 入力イベントの複数のストリームを結合します。		* {{ic\|mux}}: 入力イベントの複数のストリームを結合する。
	* {{ic\|udevmon}}: 入力デバイスを監視し、(それに応じて) タスクを開始する。		* {{ic\|udevmon}}: 入力デバイスを監視し、(それに応じて) タスクを開始する。
	* {{ic\|uinput}}: 入力イベントを標準入力から仮想デバイスへリダイレクトする。		* {{ic\|uinput}}: 入力イベントを標準入力から仮想デバイスへリダイレクトする。