「Libinput」の版間の差分
Kusanaginoturugi (トーク | 投稿記録) 細 (→Xorg 設定ファイルを使う) |
細 (翻訳ステータスの追加) |
||
(3人の利用者による、間の17版が非表示) | |||
14行目: | 14行目: | ||
:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。 |
:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。 |
||
− | + | X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。 |
|
== インストール == |
== インストール == |
||
− | [[ |
+ | [[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。 |
+ | * [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。 |
||
− | [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージを[[インストール]]してください。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換できます。 |
||
+ | * [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。 |
||
− | |||
− | また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。 |
+ | ** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。 |
== 設定 == |
== 設定 == |
||
− | [[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 |
+ | [[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。 |
[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。 |
[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。 |
||
− | === xinput を使う === |
+ | === Xorg の xinput を使う === |
まず、次を実行してください: |
まず、次を実行してください: |
||
59行目: | 59行目: | ||
オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。 |
オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。 |
||
− | 通常、[[Xorg# |
+ | 通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。 |
+ | {{Tip| |
||
− | {{Tip|libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、{{ic|70-synaptics.conf}} のファイル名によって synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください: |
||
+ | * libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください: |
||
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf |
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf |
||
− | 両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。 |
+ | 両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。 |
+ | * 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}} |
||
どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります: |
どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります: |
||
90行目: | 92行目: | ||
EndSection |
EndSection |
||
}} |
}} |
||
− | 単体の設定ファイルで |
+ | 単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、 |
+ | * {{ic|MatchIsPointer "on"}} (トラックポイント) |
||
+ | * {{ic|MatchIsKeyboard "on"}} |
||
+ | * {{ic|MatchIsTouchpad "on"}} |
||
+ | * {{ic|MatchIsTouchscreen "on"}} |
||
+ | 入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。 |
||
+ | 一般的な設定オプションは以下の通りです: |
||
* {{ic|"Tapping" "on"}}: タップでクリック。 |
* {{ic|"Tapping" "on"}}: タップでクリック。 |
||
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。 |
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。 |
||
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。 |
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。 |
||
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。 |
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。 |
||
− | デバイスによっては上記の一部オプションが使えないこともあるので注意してください。 |
+ | デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。 |
+ | |||
=== グラフィカルツール === |
=== グラフィカルツール === |
||
106行目: | 115行目: | ||
* [[Cinnamon]]: |
* [[Cinnamon]]: |
||
** GNOME UI と同じように設定することができます。 |
** GNOME UI と同じように設定することができます。 |
||
+ | * [[MATE]]: |
||
+ | ** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。 |
||
* [[KDE|KDE Plasma]] 5: |
* [[KDE|KDE Plasma]] 5: |
||
− | ** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます |
+ | ** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。 |
+ | * [[Xfce]]: |
||
− | ** {{AUR|kcm-pointing-devices-git}} は libinput によってサポートされている全ての入力デバイスの古い KDE 設定モジュールです。タッチパッド設定も機能しますが再起動すると設定は消えてしまいます。詳しくは [https://bugs.kde.org/show_bug.cgi?id=402882 KDE Bug 402882] を参照。 |
||
+ | ** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。 |
||
== ヒントとテクニック == |
== ヒントとテクニック == |
||
156行目: | 168行目: | ||
{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}} |
{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}} |
||
− | === |
+ | === デバイスの無効化 === |
+ | ==== 環境変数を使う ==== |
||
− | タッチパッドを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。 |
||
+ | |||
+ | [[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です: |
||
+ | |||
+ | {{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2= |
||
+ | ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1" |
||
+ | }} |
||
+ | |||
+ | ''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。 |
||
+ | |||
+ | 一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。 |
||
+ | |||
+ | ==== xinput を使う ==== |
||
+ | |||
+ | タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。 |
||
{{Note| |
{{Note| |
||
166行目: | 192行目: | ||
設定を永続化する場合は[[自動起動]]を見てください。 |
設定を永続化する場合は[[自動起動]]を見てください。 |
||
+ | |||
+ | 有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。 |
||
=== ジェスチャー === |
=== ジェスチャー === |
||
176行目: | 204行目: | ||
[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。 |
[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。 |
||
+ | |||
+ | [[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。 |
||
==== fusuma ==== |
==== fusuma ==== |
||
185行目: | 215行目: | ||
$ gem install fusuma |
$ gem install fusuma |
||
− | + | あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。 |
|
+ | |||
+ | {{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。 |
||
+ | |||
+ | {{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}} |
||
それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定: |
それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定: |
||
193行目: | 227行目: | ||
3: |
3: |
||
left: |
left: |
||
− | + | sendkey: 'LEFTALT+RIGHT' |
|
right: |
right: |
||
− | + | sendkey: 'LEFTALT+LEFT' |
|
up: |
up: |
||
− | + | sendkey: 'LEFTALT+LEFTSHIFT+TAB' |
|
down: |
down: |
||
− | + | sendkey: 'LEFTALT+TAB' |
|
pinch: |
pinch: |
||
in: |
in: |
||
− | + | sendkey: 'LEFTALT+LEFTSHIFT+TAB' |
|
out: |
out: |
||
− | + | sendkey: 'LEFTALT+TAB' |
|
threshold: |
threshold: |
||
215行目: | 249行目: | ||
</nowiki>}} |
</nowiki>}} |
||
+ | あるいは {{ic|xdotool}} では次のようにします: |
||
− | スワイプの閾値を低くするとページをスワイプしすぎてしまいます。 |
||
+ | {{hc|~/.config/fusuma/config.yml|<nowiki> |
||
− | 上記の設定は3本指のスワイプを使います。 |
||
+ | swipe: |
||
+ | 3: |
||
+ | left: |
||
+ | command: 'xdotool key alt+Right' |
||
+ | right: |
||
+ | command: 'xdotool key alt+Left' |
||
+ | up: |
||
+ | command: 'xdotool key ctrl+shift+plus' |
||
+ | down: |
||
+ | command: 'xdotool key ctrl+minus' |
||
+ | pinch: |
||
+ | in: |
||
+ | command: 'xdotool key ctrl+shift+plus' |
||
+ | out: |
||
+ | command: 'xdotool key ctrl+minus' |
||
+ | |||
+ | threshold: |
||
+ | swipe: 0.5 |
||
+ | pinch: 0.2 |
||
+ | |||
+ | interval: |
||
+ | swipe: 0.2 |
||
+ | pinch: 0.2 |
||
+ | </nowiki>}} |
||
+ | |||
+ | {{ic|ydotool}} は {{ic|xdotool}} と同様です。 |
||
+ | |||
+ | スワイプの閾値を低くするとページをスワイプしすぎるので重要です。 |
||
+ | |||
+ | 上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。 |
||
− | ==== |
+ | ==== gebaar ==== |
− | [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] |
+ | [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。 |
+ | Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。 |
||
− | Unlike Fusuma, it doesn't support pinching (support is planned in the future though) and threshholds, but in addition to swiping left, right, up and down with 3/4 fingers, it also supports diagonal swipes, which Fusuma does not. |
||
− | + | gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] |
|
==== GnomeExtendedGestures ==== |
==== GnomeExtendedGestures ==== |
||
229行目: | 293行目: | ||
GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。 |
GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。 |
||
+ | === ボタンを押したままマウスでスクロールする === |
||
− | === Scroll with mouse by holding a button === |
||
+ | マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。 |
||
− | There is a nice trick to optimize scrolling with a mouse or trackball by holding a mouse button (like right or middle button, or some other if the mouse has more buttons) and moving the mouse. Very useful in case your mouse does not have the mouse wheel (often the case with the trackballs). To do that one has to set {{ic|ScrollMethod}} to {{ic|button}} and specify the mouse button in the {{ic|ScrollButton}} option for the action. Here is an example for configuration to achieve that: |
||
{{hc|/etc/X11/xorg.conf.d/00-mouse.conf| |
{{hc|/etc/X11/xorg.conf.d/00-mouse.conf| |
||
242行目: | 306行目: | ||
}} |
}} |
||
+ | === マウスホイールのスクロール速度の調整 === |
||
− | === Mouse wheel scrolling speed scaling === |
||
− | + | マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。 |
|
− | + | このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。 |
|
− | $ xinput --set-prop ' |
+ | $ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5 |
+ | ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。 |
||
− | where the {{ic|RAPOO Rapoo 2.4G Wireless Device}} is the name of your mouse device, listed in {{ic|xinput --list}}. {{ic|2.5 2.5}} are the scaling factors, for x- and y-axis, respectively. |
||
− | + | または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。 |
|
− | $ |
+ | $echo 6>/tmp/libinput_discrete_deltay_multiplier |
− | + | フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。 |
|
+ | |||
+ | === 入力時のタッチパッドの有効化 === |
||
+ | |||
+ | デフォルトでは、[[libinput]] はタイピング中にタッチパッドを無効化します。[[Inkscape]] におけるマウス入力付きキーバインディング動作など、いくつかのソフトウェアにおいて問題になります。次のように {{ic|/etc/X11/xorg.conf.d/30-touchpad.conf}} へ {{ic|InputClass}} セクションを加える事でこの無効化動作を避ける事ができます: |
||
+ | |||
+ | Section "InputClass" |
||
+ | ... |
||
+ | Option "DisableWhileTyping" "0" |
||
+ | EndSection |
||
== トラブルシューティング == |
== トラブルシューティング == |
||
274行目: | 347行目: | ||
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true |
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true |
||
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false |
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false |
||
+ | |||
+ | === 慣性スクロールが KDE で使えない === |
||
+ | |||
+ | 慣性スクロールの機能は現在実装されていません ([https://bugs.kde.org/show_bug.cgi?id=456383 KDE bug 456383])。Chromium-ベースのブラウザ上については、[https://chrome.google.com/webstore/detail/smoothscroll/nbokbjkabcmbfdlbddjidfmibcpneigj SmoothScroll] の拡張機能をインストールする事で使えるようになります。 |
||
+ | |||
+ | === タブレットモードでキーがスタックする === |
||
+ | |||
+ | いくつかのタブレット PC (Lenovo Yoga など) において、タブレットモードへの切り替わり時にキー入力が停止しタブレットモードを抜けるまでスタックします。libinput の quirks ファイルを編集する事で解決できる場合があります。詳細は [https://gitlab.freedesktop.org/libinput/libinput/-/issues/914 Issue 914] を見てください。 |
||
+ | |||
+ | For example, find the name of the keyboard device: |
||
+ | 例えば、キーボードデバイスの名前が次の場合: |
||
+ | |||
+ | {{hc|# libinput list-devices| |
||
+ | ... |
||
+ | Device: AT Translated Set 2 keyboard |
||
+ | Kernel: /dev/input/event3 |
||
+ | Capabilities: keyboard |
||
+ | ... |
||
+ | }} |
||
+ | |||
+ | 次の様に上書き用のファイルを作ってください: |
||
+ | |||
+ | {{hc|/etc/libinput/local-overrides.quirks|2= |
||
+ | [Lenovo Thinkpad Yoga] |
||
+ | MatchName=AT Translated Set 2 keyboard |
||
+ | ModelTabletModeNoSuspend=0 |
||
+ | }} |
||
+ | |||
+ | {{ic|1=ModelTabletModeNoSuspend=0}} によってキースタックの問題となる振る舞いを無効化します。 [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html Device quirks] に、設定ファイルのフォーマットやデバイス名の指定方法が記載されています。いくつかのデバイスについては既存の quirks エントリーを使って上書き用のファイルを作れます。デフォルトの quirks ファイルは {{ic|/usr/share/libinput/}} にあります。 |
||
== 参照 == |
== 参照 == |
||
280行目: | 382行目: | ||
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明 |
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明 |
||
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事 |
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事 |
||
+ | * [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] Linux における入力デバイスの取り扱いの経緯と現状 (2020年時点) の概説 |
||
+ | * [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] libinput の概説 |
||
+ | |||
+ | |||
+ | {{TranslationStatus|libinput|2024-08-14|808708}} |
2024年8月14日 (水) 10:38時点における最新版
関連記事
libinput プロジェクトより:
- libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。
X.Org の入力ドライバーは標準的な入力デバイスのほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは libinput のドキュメント を見て下さい。
インストール
Xorg か Wayland をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。
- Wayland で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして libinput パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
- Xorg で libinput を使用する場合、xf86-input-libinput パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [1]。つまり、
xf86-input-
で始まる X 用のドライバーパッケージを置換します。- また、xorg-xinput をインストールすることで実行中に設定を変更することができます。
設定
Wayland 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 (#グラフィカルツールを参照)、あるいはデスクトップ環境非依存の udev ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば GNOME におけるタッチパッドスクロースの速度) を設定したい場合は、libinput-config-gitAUR が使えるかもしれません。サポートされているオプションは libinput-config README にまとめられています。
Xorg 用のデフォルト設定ファイルは /usr/share/X11/xorg.conf.d/40-libinput.conf
にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。
Xorg の xinput を使う
まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。
グラフィカル環境を再起動すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。
設定できるオプションは libinput(4) man ページを参照してください。xinput ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。
デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props device
オプションを設定するには:
$ xinput set-prop device option-number setting
例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:
$ xinput set-prop 14 303 1 1
または
$ xinput set-prop 14 "libinput Click Method Enabled" 1 1
Xorg 設定ファイルを使う
オプションの永続的な設定については Xorg#.conf ファイルを使う を見て下さい。Logitech Marble Mouse#libinput を使うや下の#ボタンの再マッピングに設定例が載っています。
通常、Xorg#入力デバイス用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、/etc/X11/xorg.conf.d/
にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。
どのデバイスが libinput によって管理されているか xorg のログファイルで確認できます。例えば、/etc/X11/xorg.conf.d/
に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
$ grep -e "Using input driver 'libinput'" /path/to/Xorg.0.log
[ 28.799] (II) Using input driver 'libinput' for 'Power Button' [ 28.847] (II) Using input driver 'libinput' for 'Video Bus' [ 28.853] (II) Using input driver 'libinput' for 'Power Button' [ 28.860] (II) Using input driver 'libinput' for 'Sleep Button' [ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard' [ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad' [ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint' [ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'
もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、Synaptics タッチパッドドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。
カスタム設定ファイルは /etc/X11/xorg.conf.d/
に配置します。よく使われるファイル名は 30-touchpad.conf
です。
基本的な設定は以下のようになります:
/etc/X11/xorg.conf.d/30-touchpad.conf
Section "InputClass" Identifier "devname" Driver "libinput" ... EndSection
単体の設定ファイルで好きな数だけセクションを定義することができます。xorg.conf(5) § INPUTCLASS_SECTION にあるフィルターを使ってデバイスをフィルターできます。例えば、
MatchIsPointer "on"
(トラックポイント)MatchIsKeyboard "on"
MatchIsTouchpad "on"
MatchIsTouchscreen "on"
入力デバイスは libinput(4) § CONFIGURATOIN_DETAILS を見ながら設定できます。 一般的な設定オプションは以下の通りです:
"Tapping" "on"
: タップでクリック。"ClickMethod" "clickfinger"
: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは ドキュメント を参照。"NaturalScrolling" "true"
: ナチュラルスクロール (逆スクロール)。"ScrollMethod" "edge"
: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。
グラフィカルツール
複数の GUI ツールが存在します:
- GNOME:
- コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。GNOME#マウスとタッチパッドも参照。
- gnome-tweaks には他にもいくつか設定が存在します。
- Cinnamon:
- GNOME UI と同じように設定することができます。
- MATE:
- 設定パネルからマウスのオプションが選べます。
mate-mouse-properties
からも設定できます。
- 設定パネルからマウスのオプションが選べます。
- KDE Plasma 5:
- キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
- Xfce:
- xfce4-settings にあるマウスやタッチパッドのサブメニューから設定できます。
ヒントとテクニック
ボタンの再マッピング
例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、Xorg の設定ファイルで TappingButtonMap
オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには TappingButtonMap
を lrm
に、左・中・右にするには lmr
に設定してください。
/etc/X11/xorg.conf.d/30-touchpad.conf
Section "InputClass" Identifier "touchpad" Driver "libinput" MatchIsTouchpad "on" Option "Tapping" "on" Option "TappingButtonMap" "lmr" EndSection
デバイスがタッチパッドではない場合は MatchIsTouchpad "on"
を削除して Identifier
も変えてください。
ボタンの手動再マッピング
デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (device は xinput list
で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map device
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map device 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。Wayland でも上記の設定は使えますが、device の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。
デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は xinitrc で Logitech Revolution MX マウスのボタンマッピングを変更する例です:
~/.xinitrc
... for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"') do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20 fi done ...
タッチパッド感度の変更
libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [2] に書かれています。
タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[3] を見てください。
デバイスの無効化
環境変数を使う
環境変数 LIBINPUT_IGNORE_DEVICE
を使って指定のデバイスの初期化を避ける事ができます [6]。次のような udev ルールを使って設定するのが最適です:
/etc/udev/rules.d/99-libinput-ignore.rules
ACTION=="add|change", device_delineation, ENV{LIBINPUT_IGNORE_DEVICE}="1"
device_delineation によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには lsusb
から取得した ID vendor_id と product_id を使って SUBSYSTEMS=="usb", ATTRS{idVendor}=="vendor_id", ATTRS{idProduct}=="product_id"
とします。
一度ファイルを用意したら、udev は自動的に設定の変更を反映するので (Udev#新しいルールをロードするを参照)、デバイスを再接続するだけで反映されます。
xinput を使う
タッチパッドを始めとするデバイスを無効化するには、まず xinput list
で名前を確認してから xinput disable name
で無効化してください。
設定を永続化する場合は自動起動を見てください。
有効化・無効化をトグルするには [7] のようなスクリプトを書いてください。
ジェスチャー
libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [8]、デスクトップ環境やウィンドウマネージャがまだそれらのアクションを実装していない可能性があります。
libinput-gestures
EWMH (wm-spec を参照) 互換のウィンドウマネージャでは、代わりに libinput-gestures ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを (libinput debug-events
を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。
libinput-gestures を使用するには、libinput-gesturesAUR パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは README を見てください。
Touchegg を使っている場合は、干渉を避ける為に libinput-gesturesAUR はアンインストールしてください[9]。
fusuma
Fusuma は Ruby で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。
fusuma
の Ruby gem をインストールしてください:
$ gem install fusuma
あるいは、AUR バージョンが存在します: ruby-fusumaAUR。
fusuma
Ruby gem 以外にも、fusuma-plugin-sendkey
Ruby gem あるいは、xdotool (X 用) か ydotool (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は こちらにリストされています。
それから ~/.config/fusuma/config.yml
で以下のように設定:
~/.config/fusuma/config.yml
swipe: 3: left: sendkey: 'LEFTALT+RIGHT' right: sendkey: 'LEFTALT+LEFT' up: sendkey: 'LEFTALT+LEFTSHIFT+TAB' down: sendkey: 'LEFTALT+TAB' pinch: in: sendkey: 'LEFTALT+LEFTSHIFT+TAB' out: sendkey: 'LEFTALT+TAB' threshold: swipe: 0.5 pinch: 0.2 interval: swipe: 0.2 pinch: 0.2
あるいは xdotool
では次のようにします:
~/.config/fusuma/config.yml
swipe: 3: left: command: 'xdotool key alt+Right' right: command: 'xdotool key alt+Left' up: command: 'xdotool key ctrl+shift+plus' down: command: 'xdotool key ctrl+minus' pinch: in: command: 'xdotool key ctrl+shift+plus' out: command: 'xdotool key ctrl+minus' threshold: swipe: 0.5 pinch: 0.2 interval: swipe: 0.2 pinch: 0.2
ydotool
は xdotool
と同様です。
スワイプの閾値を低くするとページをスワイプしすぎるので重要です。
上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [10]。
gebaar
Gebaar もジェスチャー認識ツールです。 Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。
gebaar のフォークは Gebaar にあり、gebaar-libinput-gitAUR を使ってインストールすることができます。gebaar-libinput-gitAUR はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください Gebaar
GnomeExtendedGestures
GNOME との統合が必要な場合、GnomeExtendedGestures が存在します (gnome-shell-extension-extended-gestures-gitAUR)。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。
ボタンを押したままマウスでスクロールする
マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、ScrollMethod
を button
に設定し、アクションの ScrollButton
オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。
/etc/X11/xorg.conf.d/00-mouse.conf
Section "InputClass" Identifier "system-mouse" MatchIsPointer "on" Option "ScrollMethod" "button" Option "ScrollButton" "3" EndSection
マウスホイールのスクロール速度の調整
マウスによっては、特に HiDPI デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。patch が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの xf86-input-libinput が組み込まれています。
このパッチでは、マウスに新しいプロパティ libinput Scroll Distance Scale
が導入され、次のようなスケーリング係数を設定できます。
$ xinput --set-prop 'device_name' 'libinput Scroll Distance Scale' 2.5 2.5
ここで、device_name
は、xinput --list
にリストされているマウスデバイスの名前です。2.5 2.5
は、それぞれx軸とy軸の倍率です。
または、libinput-multiplierAUR をインストールして Xorg を再起動し、y軸のスクロール距離を6倍に拡大します。
$echo 6>/tmp/libinput_discrete_deltay_multiplier
フォーカス変更時に倍率を変更する場合 こちらを参照。
入力時のタッチパッドの有効化
デフォルトでは、libinput はタイピング中にタッチパッドを無効化します。Inkscape におけるマウス入力付きキーバインディング動作など、いくつかのソフトウェアにおいて問題になります。次のように /etc/X11/xorg.conf.d/30-touchpad.conf
へ InputClass
セクションを加える事でこの無効化動作を避ける事ができます:
Section "InputClass" ... Option "DisableWhileTyping" "0" EndSection
トラブルシューティング
まず、libinput debug-events
を実行して問題をデバッグできないか確認してください。利用可能なオプションは libinput-debug-events(1) を見てください。
入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには evemu パッケージに含まれている evemu-describe を使います:
software supported input trackpad driver の出力を a supported trackpad と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 INPUT_PROP_BUTTONPAD
プロパティも設定されます。
タッチパッドが GNOME で動作しない
以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled
さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の gsettings
コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true $ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false
慣性スクロールが KDE で使えない
慣性スクロールの機能は現在実装されていません (KDE bug 456383)。Chromium-ベースのブラウザ上については、SmoothScroll の拡張機能をインストールする事で使えるようになります。
タブレットモードでキーがスタックする
いくつかのタブレット PC (Lenovo Yoga など) において、タブレットモードへの切り替わり時にキー入力が停止しタブレットモードを抜けるまでスタックします。libinput の quirks ファイルを編集する事で解決できる場合があります。詳細は Issue 914 を見てください。
For example, find the name of the keyboard device: 例えば、キーボードデバイスの名前が次の場合:
# libinput list-devices
... Device: AT Translated Set 2 keyboard Kernel: /dev/input/event3 Capabilities: keyboard ...
次の様に上書き用のファイルを作ってください:
/etc/libinput/local-overrides.quirks
[Lenovo Thinkpad Yoga] MatchName=AT Translated Set 2 keyboard ModelTabletModeNoSuspend=0
ModelTabletModeNoSuspend=0
によってキースタックの問題となる振る舞いを無効化します。 Device quirks に、設定ファイルのフォーマットやデバイス名の指定方法が記載されています。いくつかのデバイスについては既存の quirks エントリーを使って上書き用のファイルを作れます。デフォルトの quirks ファイルは /usr/share/libinput/
にあります。
参照
- libinput Wayland ドキュメント
- FOSDEM 2015 - libinput - Hans de Goede によるプロジェクトの目標と計画についての説明
- Peter Hutterer のブログ - プロジェクトのハッカーによる libinput 関連の記事
- Talk by the primary libinput maintainer Linux における入力デバイスの取り扱いの経緯と現状 (2020年時点) の概説
- Blog post by the libinput maintainer libinput の概説