https://github.com/System64fumo/syshud

Simple heads up display written in gtkmm 4
https://github.com/System64fumo/syshud

brightness-indicator gtk4 hud volume-indicator wayland

Last synced: 13 days ago
JSON representation

Simple heads up display written in gtkmm 4

• Host: GitHub
• URL: https://github.com/System64fumo/syshud
• Owner: System64fumo
• License: wtfpl
• Created: 2024-02-04T16:58:23.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-11T16:24:13.000Z (about 1 month ago)
• Last Synced: 2025-03-30T15:07:31.784Z (16 days ago)
• Topics: brightness-indicator, gtk4, hud, volume-indicator, wayland
• Language: C++
• Homepage:
• Size: 252 KB
• Stars: 108
• Watchers: 2
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hyprland - syshud

README

        
# Syshud

Syshud is a simple system status indicator written in gtkmm 4


![preview](https://github.com/System64fumo/sysvol/blob/main/preview.gif "preview")

[![Packaging status](https://repology.org/badge/vertical-allrepos/syshud.svg)](https://repology.org/project/syshud/versions)

# Configuration

syshud can be configured in 2 ways


1: By changing config.hpp and recompiling (Suckless style)


2: Using launch arguments


```

arguments:

  -p	Set position (eg: top, top-left, bottom, right)

  -o	Set orientation (eg: v, h)

  -W	Set window width

  -H	Set window Height

  -i	Set icon size

  -P	Hide percentage

  -m	Set margins ("top right bottom left")

  -t	Set timeout

  -T	Set transition time (0 disables animations)

  -b	Set custom backlight path

  -M	Set things to monitor (audio_in, audio_out, brightness, keyboard)

  -k	Set keyboard path (/dev/input/by-id/my_keyboard-event-kbd)

  -v	Prints version info

```

To use pulseaudio instead of wireplumber,


change `#define AUDIO_WIREPLUMBER` to `#define AUDIO_PULSEAUDIO` in `src/config.hpp`

# Theming

syshud uses your gtk4 theme by default, However it can be also load custom css,


Just copy the included style.css file to ~/.config/sys64/hud/style.css


# Credits

[Jason White](https://gist.github.com/jasonwhite/1df6ee4b5039358701d2) for showing how to write pulseaudio stuff


[waybar](https://github.com/Alexays/Waybar) for showing how to write wireplumber stuff