Note

Legacy v1 config remains available on ags-v1 branch

---

wall picker	old config

Other Screenshots

Flatpak widget with updates & no-updates

You can toggle this by clicking on the flatpak-counter module on the bar widget

Loading	Updates	No Updates

Requirements

• bun - for building & compiling stuff
• sassc - to compile "scss" files to "css"
• pipewire - volume Control
• libgtop - resource usage
• networkmanager
• hyprshade, hyprpicker - nightlight & colorpicker
• wf-recorder - screen recorder
• swww - wallpaper-picker & other related stuff
• imagemagick - for compressing images
• flatpak - flatpak update widget
• zenity - file-picker

Sometimes I forget which packages are required, so I may not always update the README accordingly. Please keep that in mind. 🙈

Fonts

• JetBrainsMono Nerd Font

Optional

• inotify-tools - for hot-reload script, wallpaper picker etc

Installation

1. Install AGS
2. Clone this repo git clone https://github.com/ImRayy/ags-dots ~/.config/ags
3. On terminal ags, yes, it's that simple

Notes

ColorScheme : Since I’m using NixOS, the color scheme file imported in style/style.scss could originally be @import "/home/ray/.config/stylix/ags-colors.scss", which is generated by stylix. Change this to @import "./colors.scss".

Flatpak update widget & module : If you don’t use Flatpak, simply remove Flatpak() from widgets/main.ts and FlatpakUpdatesCount() from widgets/bar/Bar.ts. Otherwise, AGS might not run at all—though I’m not entirely sure.

Wallpaper Picker : It’s important to add wallpapers only using the wallpaper-picker widget. Why? Because if you add wallpapers manually, the file sizes are larger, which causes AGS to boot up slowly. Compressing the wallpapers fixes this issue, but setting them directly reduces quality. So, I created a method where you add wallpapers using the Add Walls button on the wallpaper-picker widget, which automatically compresses them and saves the actual file location in a file called log.txt. I hope that covers everything! Also, it’s recommended to right-click on any wallpaper to remove it from the list.