A OSD window for common actions like volume, playback and capslock.
This is my first time coding in Rust so fixes and improvements are appreciated :)
- LibInput listener Backend for these keys:
- Caps Lock
- Num Lock
- Scroll Lock
- Audio playback
- Input and output volume change indicator
- Input and output mute change indicator
- Audio playback indicator
- Customizable maximum Volume
- Capslock change (Note: doesn't change the caps lock state)
- Brightness change indicator
There's a new LibInput watcher binary shipped with SwayOSD (swayosd-libinput-backend)
which can automatically detect key presses, so no need for binding key combos.
The supported keys are listed above in Features
# Please note that the command below might require `--prefix /usr` on some systems
meson setup build --buildtype release
ninja -C build
meson install -C buildThe package is available on COPR:
dnf copr enable erikreider/swayosd
dnf install swayosdThe package can be layered over the base image after adding the Copr repo as an ostree repo:
sudo curl -sL -o /etc/yum.repos.d/_copr:copr.fedorainfracloud.org:erikreider:swayosd.repo https://copr.fedorainfracloud.org/coprs/erikreider/swayosd/repo/fedora-$(rpm -E %fedora)/erikreider-swayosd-fedora-$(rpm -E %fedora).repo
rpm-ostree install swayosd- extra: swayosd
- AUR: swayosd-git (thanks to @jgmdev! Don't report AUR packaging issues here)
Starting with Debian trixie and Ubuntu Plucky swayosd is available via apt.
swayosd-server must be running in the background.
Use swayosd-client to send commands and display the OSD.
Used for notifying when caps-lock, scroll-lock, and num-lock is changed.
Using Systemd: sudo systemctl enable --now swayosd-libinput-backend.service
Other users can run: pkexec swayosd-libinput-backend
# OSD server
exec swayosd-server# Sink volume raise optionally with --device
bindsym XF86AudioRaiseVolume exec swayosd-client --output-volume raise
# Sink volume lower optionally with --device
bindsym XF86AudioLowerVolume exec swayosd-client --output-volume lower --device alsa_output.pci-0000_11_00.4.analog-stereo.monitor
# Sink volume toggle mute
bindsym XF86AudioMute exec swayosd-client --output-volume mute-toggle
# Source volume toggle mute
bindsym XF86AudioMicMute exec swayosd-client --input-volume mute-toggle
# Volume raise with custom value
bindsym XF86AudioRaiseVolume exec swayosd-client --output-volume 15
# Volume lower with custom value
bindsym XF86AudioLowerVolume exec swayosd-client --output-volume -15
# Volume raise with max value
bindsym XF86AudioRaiseVolume exec swayosd-client --output-volume raise --max-volume 120
# Volume lower with max value
bindsym XF86AudioLowerVolume exec swayosd-client --output-volume lower --max-volume 120
# Sink volume raise with custom value optionally with --device
bindsym XF86AudioRaiseVolume exec swayosd-client --output-volume +10 --device alsa_output.pci-0000_11_00.4.analog-stereo.monitor
# Sink volume lower with custom value optionally with --device
bindsym XF86AudioLowerVolume exec swayosd-client --output-volume -10 --device alsa_output.pci-0000_11_00.4.analog-stereo.monitor
# Capslock (If you don't want to use the backend)
bindsym --release Caps_Lock exec swayosd-client --caps-lock
# Capslock but specific LED name (/sys/class/leds/)
bindsym --release Caps_Lock exec swayosd-client --caps-lock-led input19::capslock
# Brightness raise (optionally with --device, can be device name or wildcard)
bindsym XF86MonBrightnessUp exec swayosd-client --brightness raise --device intel_backlight
# Brightness lower (optionally with --device, can be device name or wildcard)
bindsym XF86MonBrightnessDown exec swayosd-client --brightness lower --device intel_backlight
# Brightness raise with custom value('+' sign needed)
bindsym XF86MonBrightnessUp exec swayosd-client --brightness +10
# Brightness lower with custom value('-' sign needed)
bindsym XF86MonBrightnessDown exec swayosd-client --brightness -10
# Play/Pause current player
bindsym XF86AudioPlay exec swayosd-client --playerctl play-pause
# Next song for current player
bindsym XF86AudioNext exec swayosd-client --playerctl next- It is for audio and BrightnessCtl devices only.
- If it is omitted, the default audio / first BrightnessCtl device is used.
- It only changes the target device for the current action that changes the volume / brightness.
- You can list your input audio devices using
pactl list short sources, for outputs replacesourceswithsinks. - You can list your brightness devices using
brightnessctl -l, for backlights, usebrightnessctl -l -c backlight.
- By default, without using --monitor the osd will be shown on all monitors
- On setups with multiple monitors, if you only want to show the osd on the focused monitor, you can do so with the help of window manager specific commands:
# Sway
swayosd-client --monitor "$(swaymsg -t get_outputs | jq -r '.[] | select(.focused == true).name')" --output-volume raise
# Hyprland
swayosd-client --monitor "$(hyprctl monitors -j | jq -r '.[] | select(.focused == true).name')" --output-volume raiseSince SwayOSD uses GTK, its appearance can be changed. Initially scss is used, which GTK does not support, so we need to use plain css.
The style conifg file is in ~/.config/swayosd/style.css (it is not automatically generated). For reference you can check this and this.
Some devices may not have permission to write /sys/class/backlight/*/brightness.
So using the provided packaged udev rules + adding the user to video group
by running sudo usermod -a -G video $USER, everything should work as expected.