Dunst

関連記事

• デスクトップ通知

Dunst はデスクトップ環境に同梱されている通知デーモンを置き換える軽量な代替デーモンです。

インストール

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

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

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

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

設定

外観

Dunst では HTML を使って通知を表示できます。太字・斜体・取り消し線・下線のサンプルが存在します。詳しくは [1] を参照してください。markup を no に設定することで、通知から HTML を取り除くこともできます。

また、通知のフォーマットを指定できます。使用できるオプションは以下の通り:

%a  アプリ名
%s  概要
%b  本文
%i  アイコン名 (パスを含む)
%I  アイコン名 (パスは含まない)
%p  進捗率 ([  0%] から [100%])

上記のオプションは HTML と組み合わせて使うことができます。例えば format を <b>%s</b>\n%b と設定することで、太字の概要に、改行の後に本文を表示します。

アイコンセット

アイコンは 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 を参照してください。 -print オプションから始めて、適切なルールを作成するための通知に関する有用な情報を見つけてください。

変更

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

もう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 を一時的に無効にする

Dunst を一時的に無効にするには、2つのオプションがあります。

特別な通知を送信します

notify-send "DUNST_COMMAND_PAUSE" を使用して無効にし、 notify-send "DUNST_COMMAND_RESUME" を使用して再度有効にします。 notify-send "DUNST_COMMAND_TOGGLE" を使用して、一時停止と再開を切り替えることもできます。

killall を使用する

killall -SIGUSR1 dunst を使用して無効にし、 killall -SIGUSR2 dunst を使用して再度有効にします

dunstctl を使用します

dunstctl set-paused true/false/toggle を使用して、一時停止通知を無効化/再有効化または切り替えることができます。 そして、dunstctl is-paused を使用して、 dunst が現在実行中か一時停止中かを確認します。

一時停止すると、 Dunst はすべての通知を保留します。 再び Dunst を有効にすると、すべての保留通知が表示されます。

Dunstify

Dunstify は、 notify-send コマンドの代替手段です。 これは notify-send と完全に互換性があり、一緒に使用できますが、さらにいくつかの機能を提供します。 Dunstify は、 Dunst 通知デーモンでのみ機能します。

通知送信で利用可能なオプションに加えて、dunstifyはIDやアクションなどのいくつかの機能を提供します。

通知の置き換え

-r ID オプションを指定して dunstify を呼び出すことにより、通知に ID を割り当てることができます。ここで、IDは整数である必要があります。 そのIDの通知がすでに存在する場合は、新しい通知に置き換えられます。 dunstify -C ID を使用して通知を閉じることもできます。

ただし、ほとんどのユースケースでは、IDのマイクロ管理よりもタグの実装が推奨されます。後者のオプションには、多くの隠れた落とし穴があるためです [2] ID の置き換えは、一般的な方法ではなく、デバッグや非常に複雑な通知送信者に対して検討される場合があります [3]

同じタグ(この例では test) を持つ通知は、 ID を気にすることなく置き換えられます。

$ dunstify -h string:x-dunst-stack-tag:test Test -A 'tested,default'
$ dunstify -h string:x-dunst-stack-tag:test Testing

アクション

1つ以上の --action=action,label パラメータを指定することにより、通知から直接呼び出すことができるアクションを定義できます。 例えば:

dunstify --action="replyAction,reply" "メッセージを受信しました"

その後、ユーザーは Dunst のコンテキストメニューから指定されたアクションにアクセスできます。 dunstify の呼び出しは、通知が消えるか、アクションが選択されるまでブロックされます。前者の場合、 dunstify は、通知がタイムアウトした場合は1を返し、手動で却下された場合は2を返します [4] 後者の場合、Dunst のコンテキストメニューで選択されたアクションを返します。

コンテキストメニューを使用してアクションを呼び出すことに加えて、マウスイベントがアクションを呼び出す方法を定義することもできます [5] これにより、 [6] で提案されているように、Dunstをインタラクティブに使用できます。通知にアクションが1つしかない場合、またはアクションの名前が default の場合、そのアクションは、通知をミドルクリックすることで呼び出すことができます(デフォルト、または dunstrc が mouse_middle_click = do_action)。

reply_action () {}
forward_action () {}
handle_dismiss () {}

ACTION=$(dunstify --action="default,Reply" --action="forwardAction,Forward" "メッセージを受信しました")

case "$ACTION" in
"default")
    reply_action
    ;;
"forwardAction")
    forward_action
    ;;
"2")
    handle_dismiss
    ;;
esac

ヒントとテクニック

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

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

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

#!/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"

getProgressString は、文字列のようにプログレスバーを組み立てる関数である必要があります。このスクリプトは [8] を使用します。

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

以前の通知を上書きする

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

トラブルシューティング

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

ディスプレイマネージャなしで dunst を使用すると、 DISPLAY 環境変数が正しく設定されない場合があります。 [9]

これを修正するには、 .xinitrc に以下を追加します。

systemctl --user import-environment DISPLAY

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

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

解決するには、次のコマンドを実行します。

# ln -s /etc/fonts/conf.avail/10-scale-bitmap-fonts.conf /etc/fonts/conf.d/

Dunst を再起動します。