dunstctl: script, module & preview images

polybar-scripts/dunst-controller/README.md

@@ -0,0 +1,29 @@
+# dunstctl, a dunst controller script & module
+
+This script is written in [`fish`](https://fishshell.com/), and displays a bell
+icon that can be used to interact with [`dunst`](https://github.com/dunst-project/dunst)
+via `dunstctl`, and utilises `dunstify` to send notifications.
+
+Click to show historic notifications, middle-click to mute/unmute notifications,
+and right-click to dismiss all.
+
+`chmod +x $HOME/.config/polybar/scripts/dunstctl` (or the path of your choice.)
+
+## Preview
+
+![dunst](dunstctl-0.png)
+![dunst-pause](dunstctl-1.png)
+
+![dunst-notif](dunstctl-2.png)
+
+## Example module
+
+```ini
+[module/dunstctl]
+click-left = dunstctl history-pop
+click-middle = $HOME/.config/polybar/scripts/dunstctl toggle
+click-right = dunstctl close-all
+exec = $HOME/.config/polybar/scripts/dunstctl
+interval = 1.6
+type = custom/script
+```

polybar-scripts/dunst-controller/dunstctl

@@ -0,0 +1,44 @@
+#! /usr/bin/env fish
+
+function unmute
+    dunstctl set-paused false && \
+        dunstify 'dunst' 'Unmuted notifications.' -i polari -u low &
+end
+
+function mute
+    dunstify 'dunst' 'Muting notifications...' -i polari -u low &
+    # We're about to mute notifications, so the above notification will
+    # effectively not show, since set-paused hides notifications. So, sleep
+    # for 2 seconds.
+    sleep 2
+    # Close all to prevent notification from showing up once we unmute.
+    dunstctl close-all
+    dunstctl set-paused true
+end
+
+function pop_all
+    for id in (dunstctl history | jq -r '.data[][].id.data')
+        dunstctl history-pop $id
+    end
+end
+
+if test (dunstctl is-paused) = "true"
+    switch $argv[1]
+    case 'toggle'
+        unmute
+    case 'show-all'
+        unmute
+        pop_all
+    case '*'
+        echo ' '(dunstctl count waiting)
+    end
+else
+    switch $argv[1]
+    case 'toggle'
+        mute
+    case 'show-all'
+        pop_all
+    case '*'
+        echo ''
+    end
+end

polybar-scripts/dunst-controller/dunstctl.ini

@@ -0,0 +1,8 @@
+[module/dunstctl]
+click-left = dunstctl history-pop
+click-middle = $HOME/.config/polybar/scripts/dunstctl toggle
+click-right = dunstctl close-all
+double-click-left = $HOME/.config/polybar/scripts/dunstctl show-all
+exec = $HOME/.config/polybar/scripts/dunstctl
+interval = 1.6
+type = custom/script