Dunstのソースを表示

[[Category:X サーバー]]
[[en:Dunst]]
{{Related articles start}}
{{Related|デスクトップ通知}}
{{Related articles end}}

[http://knopwob.org/dunst/index.html Dunst] はデスクトップ環境に同梱されている通知デーモンを置き換える軽量な代替デーモンです。

== インストール ==

{{Pkg|dunst}} パッケージを[[インストール]]してください。dunst を起動・有効化する必要はありません。プログラムが dbus で通知を送信したときに systemd によって呼び出されます。

サンプル設定ファイルは {{ic|/usr/share/dunst/dunstrc}} に存在します。

ファイルを {{ic|~/.config/dunst/dunstrc}} にコピーして適宜編集してください:

 $ cp /usr/share/dunst/dunstrc ~/.config/dunst/dunstrc

== 設定 ==

=== 外観 ===

Dunst では HTML を使って通知を表示できます。太字・斜体・取り消し線・下線のサンプルが存在します。詳しくは [https://developer.gnome.org/pango/stable/PangoMarkupFormat.html] を参照してください。{{ic|markup}} を {{ic|no}} に設定することで、通知から HTML を取り除くこともできます。

また、通知のフォーマットを指定できます。使用できるオプションは以下の通り:
 %a  アプリ名
 %s  概要
 %b  本文
 %i  アイコン名 (パスを含む)
 %I  アイコン名 (パスは含まない)
 %p  進捗率 ([  0%] から [100%])
上記のオプションは HTML と組み合わせて使うことができます。例えば {{ic|format}} を {{ic|<nowiki><b>%s</b>\n%b</nowiki>}} と設定することで、太字の概要に、改行の後に本文を表示します。

===アイコンセット===

アイコンは {{ic|icon_folders}} オプションで設定できます。ステータスとデバイスアイコンは必須です。

 # Paths to default icons.
 icon_folders = /usr/share/icons/Arc/status/16/:/usr/share/icons/Arc/devices/16/

=== ショートカット ===

Dunst は dunstctl で制御できます。dunstctl を実行する任意のキーボードショートカットを登録して使用してください。

例:すべての通知を閉じる

 $ dunstctl close-all

例:履歴リストを表示する

 $ dunstctl history-pop

== ルール ==

特定の通知に一致するルールをdunstrcファイルに作成し、スクリプトの実行などのアクションを実行できます。

=== フィルタリング ===

新しいルールを作成するには、構成ファイルにカスタム名を使用して新しいセクションを作成します。
そのセクションでは、属性 appname、 summary、 body、 icon、 category、 match_transient、および msg_urgency を使用して、
お知らせ。
グロブがサポートされています。例については、 [[#Scripting|Scripting]] を参照してください。
{{ic|-print}} オプションから始めて、適切なルールを作成するための通知に関する有用な情報を見つけてください。

=== 変更 ===

通知が一致すると、フォーマット文字列の変更など、特定のアクションを実行できます。これは特に
特定の通知を完全に無視したい場合に便利です。
その場合は、 {{ic|1=format=""}} 行をルールに追加するだけです。

もう1つの便利な機能は、たとえば、ダンストを使用している場合など、特定の通知を履歴から除外したい場合です。
[[#dunstifyを音量/明るさレベルインジケーターとして使用|音量インジケーター]] として。
これを実現するには、ルールに {{ic|1=history_ignore=yes}} を追加するだけです。

=== スクリプト ===

Dunst を設定することで特定の通知が表示されたときにスクリプトを実行することができます。以下は [[Pidgin]] から誰かがサインオンしたという通知がきたときにスクリプトを実行する例です:

 [signed_on]
    appname = Pidgin
    summary = "*signed on*"
    urgency = low
    script = do_something.sh

指定されたスクリプトには、appname、 summary、 body、 icon、 urgency の順にパラメーターが渡されます。

== ヒントとテクニック ==

=== スクリプト ===

Dunst を設定することで特定の通知が表示されたときにスクリプトを実行することができます。以下は [[Pidgin]] から誰かがサインオンしたという通知がきたときにスクリプトを実行する例です:

 [signed_on]
    appname = Pidgin
    summary = "*signed on*"
    urgency = low
    script = do_something.sh