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 の順にパラメーターが渡されます。

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

=== ボリューム/明るさレベルのインジケーターとして dunstify を使用 ===

ID の置換機能を使用して、この画像 [https://i.postimg.cc/j2CDkS1H/screen1712.png] のような単純な音量または明るさインジケーターの通知を実装できます。

ボリュームインジケーターを実現するには、次のスクリプトを {{ic|PATH}} のどこかに配置します。

{{bc|<nowiki>
#!/bin/bash
# changeVolume

# Arbitrary but unique message id
msgId="991049"

# Change the volume using alsa(might differ if you use pulseaudio)
amixer -c 0 set Master "$@" > /dev/null

# Query amixer for the current volume and whether or not the speaker is muted
volume="$(amixer -c 0 get Master | tail -1 | awk '{print $4}' | sed 's/[^0-9]*//g')"
mute="$(amixer -c 0 get Master | tail -1 | awk '{print $6}' | sed 's/[^a-z]*//g')"
if [[ $volume == 0 || "$mute" == "off" ]]; then
    # Show the sound muted notification
    dunstify -a "changeVolume" -u low -i audio-volume-muted -r "$msgId" "Volume muted" 
else
    # Show the volume notification
    dunstify -a "changeVolume" -u low -i audio-volume-high -r "$msgId" \
    "Volume: ${volume}%" "$(getProgressString 10 "<b> </b>" " " $volume)"
fi

# Play the volume changed sound
canberra-gtk-play -i audio-volume-change -d "changeVolume"
</nowiki>}}

{{ic|getProgressString}} は、文字列のようにプログレスバーを組み立てる関数である必要があります。このスクリプトは [https://github.com/Fabian-G/dotfiles/blob/master/scripts/bin/getProgressString] を使用します。

{{ic|changeVolume 2dB+ unmute}} などをホットキーにバインドするだけで、完了です。また、 dunst に履歴内のこれらのタイプの通知を無視させることもできます。 [[#Modifying]] を参照してください。

=== 以前の通知を上書きする ===

一部の通知(音や明るさなど)では、前の通知を上書きしたい場合があります。より一般的な例については、 [[#Replacingnotifications]] で Dunst メソッドを使用するか、 [https://wiki.archlinux.org/index.php/Desktop_notifications#Replace_previous_notification Replacepreviousnotification] を参照してください。

== トラブルシューティング ==

=== Dunst は systemd 経由で開始できません ===

ディスプレイマネージャなしで dunst を使用すると、 {{ic|DISPLAY}} 環境変数が正しく設定されない場合があります。 [https://github.com/dunst-project/dunst/issues/347]

これを修正するには、 {{ic|.xinitrc}} に以下を追加します。
 systemctl --user import-environment DISPLAY

=== 一致しないフォントサイズ (テキストよりもはるかに大きい絵文字) ===

これは、{{Pkg|fontconfig}} がビットマップフォントを再スケーリングしないことが原因です。 これは通常、特定の絵文字フォントでのみ認識されます (例:{{Pkg|noto-fonts-emoji}})

解決するには、次のコマンドを実行します。
 # ln -s /etc/fonts/conf.avail/10-scale-bitmap-fonts.conf /etc/fonts/conf.d/

Dunst を再起動します。