Sxhkdのソースを表示

{{Lowercase title}}
[[Category:キーボード設定]]
[[Category:X サーバー]]
[[en:Sxhkd]]
{{Related articles start}}
{{Related|Xbindkeys}}
{{Related|Xmodmap}}
{{Related articles end}}
[https://github.com/baskerville/sxhkd sxhkd] は、[[bspwm]] の開発者による単純な [[X]] ホットキーデーモンであり、コマンドを実行して入力イベントに反応します。

==インストール==
{{Pkg|sxhkd}} または {{AUR|sxhkd-git}} を[[インストール]]してください。

==設定==

===Sxhkd 設定ファイル===

sxhkd のデフォルトの設定ファイルは {{ic|$XDG_CONFIG_HOME/sxhkd/sxhkdrc}} です。{{ic|-c}} オプションを使うことで他のファイルを設定ファイルとして指定することもできます。

設定ファイルの各行は以下のように処理されます:

* 行頭が {{ic|#}} の場合、無視されます。
* 1つ以上の空白コマンドから始まっている場合、コマンドとして読み取られます。
* それ以外の場合、ホットキーとして解釈されます: キーの名前は空白か {{ic|+}} 文字で区切ります。

構文:

 [MODIFIER + ]*[@|!]KEYSYM
     COMMAND

{{ic|MODIFIER}} は次の名前のどれかになります: {{ic|super}}, {{ic|hyper}}, {{ic|meta}}, {{ic|alt}}, {{ic|control}}, {{ic|ctrl}}, {{ic|shift}}, {{ic|mode_switch}}, {{ic|lock}}, {{ic|mod1}}, {{ic|mod2}}, {{ic|mod3}}, {{ic|mod4}}, {{ic|mod5}}。{{ic|@}} がキーシムの最初に追加されている場合、キーのリリース時にコマンドが実行されます。付いていない場合はキーを押した時に実行されます。{{ic|!}} がキーシムの先頭に付いている場合、コマンドはマウスを動かした時に実行されます。コマンドには2つの整数値変換仕様を含める必要があり、ルートウィンドウからのポインタの相対座標に置き換わります (このタイプのホットキーで使えるボタンキーシムは: {{ic|button1}}, ..., {{ic|button5}})。{{ic|KEYSYM}} の名前は {{ic|xev}} で取得できます。

特殊なキーシム名を使用することでマウスのホットキーを定義することができます: {{ic|button1}}, {{ic|button2}}, {{ic|button3}}, ..., {{ic|button24}}。ホットキーはシーケンスの形で記述することができ ({{ic|STRING_1}},...,{{ic|STRING_N}})、この場合、コマンドも ''N'' 個の要素からなるシーケンスを記述する必要があります: 2つのシーケンスを合わせて ''N'' 個のホットキーが出来ます。さらに、シーケンスには {{ic|A-Z}} という形で範囲を指定できます。''A'' や ''Z'' は英数字です。

実際に実行されるのは {{ic|SHELL -c COMMAND}} なので、{{ic|COMMAND}} に環境変数を設定することができます。{{ic|SHELL}} は次のリストで定義された最初の環境変数になります: {{ic|SXHKD_SHELL}}, {{ic|SHELL}}。sxhkd が {{ic|SIGUSR1}} シグナルを受け取った場合、設定ファイルがリロードされます。

=== 例 ===

{{hc|$XDG_CONFIG_HOME/sxhkd/sxhkdrc|
# On mouse button 1 press Alt_R+F1
button1
    xte "keydown Alt_R" "keydown F1" "keyup Alt_R" "keyup F1"

# On mouse button 2 pause 3 seconds then press Alt_R+F2
button2
    xte "sleep 3" "keydown Alt_R" "keydown F2" "keyup Alt_R" "keyup F2"
}}

== 使用方法 ==
sxhkd を設定したら[[自動起動]]するようにしてください。
{{Tip|[[systemd]] サービスファイルが [https://github.com/baskerville/sxhkd/blob/master/contrib/systemd/sxhkd.service こちら] にあります。}}

=== 例 ===

{{ic|$XDG_CONFIG_HOME/sxhkd/sxhkdrc}} を編集:

 # On mouse button 1 press Alt_R+F1
 button1
  xte "keydown Alt_R" "keydown F1" "keyup Alt_R" "keyup F1"
 # On mosue button 2 pause 3 seconds then press Alt_R+F2
 button2
  xte "sleep 3" "keydown Alt_R" "keydown F2" "keyup Alt_R" "keyup F2"

ユーザーの sxhkd サービスを再起動:

 # systemctl --user restart sxhkd.service

== 参照 ==
*[https://github.com/baskerville/sxhkd 公式ウェブサイト] - includes configuration options, example bindings, and source code.
*[https://bbs.archlinux.org/viewtopic.php?id=155613 ArchLinux forum thread]