This is my linux custom desktop shell.

https://i.stefdp.com/raw/yxrB0y2qvw74.mp4

• Bar

  • CPU - See the general load and each core's load (on hover)
  • Disk - See the available and used disk space (on hover)
  • RAM - See the available and used RAM & Swap (on hover)ver)
  • Battery - See the percentage, power drain and time to empty/full of the battery (on hover)
  • Time - See current hour, year & month (on click) and calendar (on right click)ick)
  • Media Icon - The cover url of the playing media on Spotify
  • Media Metadata - The Spotify song name & arist, and album & volume (on hover)n hover)
  • Media Lyrics - The spotify song line-synced lyrics when available (sourced from Musixmatch and lrclib.net)
  • Speaker - Volume and device name (on hover)
  • Micrphone - Volume and device name (on hover)
  • Network - Wifi or ethernet info
  • Notifications - Notification count and center (on click)
  • Tray - Tray apps
  • Power - Power actions (see session menu)

• Notification Daemon

  • Notification popup
  • Notification center

• OSD:

  • Speaker volume %
  • Microphone volume %
  • Screen brightness %

• Launcher

  • Apps
  • Calculator

• Session Menu

  • Lock Screen
  • Sleep
  • Logout
  • Task Manager
  • Hibernate
  • Shutdown
  • Reboot
  • Reboot to Firmware (UEFI/BIOS)

• libsoup3
• glib-networking
• libadwaita
• AstalIO & mp; Astal4
• AstalApps
• AstalBattery
• AstalBluetooth
• AstalMpris
• AstalNetwork
• AstalNotifd
• AstalTray
• AstalWp

1. Clone this repository and move its contents to ~/.config/ags
2. Install all the required libraries
3. just run ags run

An example for NixOS can be found here.

The desktop shell can be configured by creating the ~/.config/stef-shell/config.json file

the avaible properties are:

• paths.musixmatchToken (string): The path where to store the musixmatch cookie, usertoken and expiration date (default: /tmp/musixmatch_token.json). ^{1 2}

• paths.backlightBaseDir (string): The path where the backlight data for all devices is stored (default: /sys/class/backlight). ¹

• paths.saveFolder (string): The folder where to save lyrics and song icons when middle clicked (default: $HOME/Music/spotifyData). ¹

• paths.lyricsFolder (string): The path where the local lyrics files will be stored (default: $HOME/.config/stef-shell/lyrics). ¹

• volumeStep.media (number): Percentage of volume increase/decrease when scrolling on the media module (default: 0.05). ³

• volumeStep.microphone (number): Percentage of volume increase/decrease when scrolling on the microphone module (default: 0.05). ³

• volumeStep.speaker (number): Percentage of volume increase/decrease when scrolling on the speaker module (default: 0.05). ³

• animationsDuration.notification (number): How long the notification animation should last (default: 500). ⁴

• animationsDuration.launcher (number): How long the launcher animation should last (default: 300). ⁴

• animationsDuration.notificationCenter (number): How long the notification center animation should last (default: 500). ⁴

• animationsDuration.osd (number): How long the OSD animation should last (default: 300). ⁴

• animationsDuration.sessionMenu (number): How long the session menu animation should last (default: 300). ⁴

• animationsType.notification (string): The notifications animation type (default: SLIDE_LEFT). ⁵

• animationsType.launcher (string): The launcher animation type (default: CROSSFADE). ⁵

• animationsType.notificationCenter (string): The notification center animation type (default: SLIDE_LEFT). ⁵

• animationsType.osd (string): The OSD animation type (default: CROSSFADE). ⁵

• animationsType.sessionMenu (string): The session menu animation type (default: CROSSFADE). ⁵

• timeouts.osd: How long the OSD should last before disappearing (default: 3000). ⁴

• timeouts.defaultNotificationExpire: How long a notification should last before disappearing (default: 5000). ^{4 6}

• sessionMenu.buttonWidth (number): How large should a button be in the session menu (default: 120). ⁷

• sessionMenu.buttonHeight (number): How high should a button be in the session menu (default: 120). ⁷

• sessionMenu.buttonGap (number): How large should the gap between buttons be in the session menu (default: 120). ⁷

• mediaMaxLength (number): How many characters should be displayed in the media bar module before it would start scrolling (default: 25). ⁸

• systemStatsUpdateInterval (number): How often system stats (CPU, Disk, RAM etc.) should be updated (default: 1000). ⁹

windowrules:

• float, class:^(gjs)$ (float normal desktop shell windows)
• noblur, class:^(gjs)$, title:^(?!AGS Session Menu$).* (remove the blur to normal desktop shell windows (except for session manager))
• noanim, class:^(gjs)$ (disable the animations normal desktop shell windows)
• pin, class:^(gjs)$, title:^(AGS Notification Center)$ (pin the notification center so it always stays in the active workspace)
• pin, class:^(gjs)$, title:^(AGS Session Menu)$ (pin th session menu so it always stays in the active workspace)

layerrules:

• noanim, gtk4-layer-shell (disable the animations layered desktop shell windows)

For local lyrics to work for a song you must follow these steps:

1. Copy the song's track ID (right click the media module while it's playing that song)
2. Create a file .lrct;.lrc in your lyrics folder (default is $HOME/.config/stef-shell/lyrics, can be configured through the config.json file)
3. Add the lyrics in that file, for it work correctly it must follow this format: [mm:ss.ms] Lyric here (example: [01:34.819] Lyric here) mm = minutes (padded, so 1 => t; 01) ss = seconds (padded, so 1 => t; 01) ms = milliseconds (padded, so 1 => t; 001)

Icons inside the icons folder are from Material Symbols