https://github.com/happyman09/auto-wallpaper-themer
“Automatic wallpaper & color theme generator for terminals, Dunst notifications, and Cava ALL IN ONE SCRIPT!!— aesthetic unleashed.”
https://github.com/happyman09/auto-wallpaper-themer
archlinux auto-theme-switch auto-wallpapers cava-theme dunst linux pywall rice shell-scripts theme-switcher unixporn wallpaper-changer xorg
Last synced: 2 months ago
JSON representation
“Automatic wallpaper & color theme generator for terminals, Dunst notifications, and Cava ALL IN ONE SCRIPT!!— aesthetic unleashed.”
- Host: GitHub
- URL: https://github.com/happyman09/auto-wallpaper-themer
- Owner: happyman09
- License: mit
- Created: 2025-08-20T11:33:23.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-31T15:44:57.000Z (3 months ago)
- Last Synced: 2025-08-31T17:33:33.108Z (3 months ago)
- Topics: archlinux, auto-theme-switch, auto-wallpapers, cava-theme, dunst, linux, pywall, rice, shell-scripts, theme-switcher, unixporn, wallpaper-changer, xorg
- Language: Shell
- Homepage:
- Size: 9.8 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌌 Auto Wallpaper Themer
**Give your desktop a fresh look every time.**
**Auto-randomize** your wallpapers in yours **specified folder** and set the randomized one as your current desktop wallpaper along with **auto-generated pywall colors** corresponding to the wallpaper, which also applies colors to **Dunst** notify and **Cava** audio visualizer by using [Pywal](https://github.com/dylanaraps/pywal).
---
## ✨ Features
- 🖼️ **Random Wallpaper Picker** – grabs wallpapers from your folder
- 🎨 **Pywal Color Schemes** – generates matching terminal themes
- 🔔 **Dunst Integration** – notifications styled to match
- 🎵 **Cava Visualizer Sync** – reactive colors tied to wallpaper
- ⚡ **Fully Automated** – one script, cohesive aesthetics
---
## 📸 Screenshots
🔗 [Check out the wallpapers used →](assets/)
---
## ⚙️ Installation & Usage
## ⚠️ Reminder to update the wallpaper folder path inside the script.
### ▶️ Make the script executable and run it:
```
git clone https://github.com/happyman09/auto-wallpaper-themer.git
cd auto-wallpaper-themer
chmod +x pywallpaper.sh
./pywallpaper.sh
```
---
## 🔄 Auto-start on login
To run the script automatically when X starts, add this to your ~/.xinitrc:
```~/path/to/script/pywallpaper.sh &```
---
## ⚠️ Setup Requirements:
### Before running, copy both configs to your Cava directory:
```cp config.base config ~/.config/cava/```
**`config.base`** → template Cava config (edit defaults here)
**`config`** → dynamically overwritten by the script
---
## 📦 Dependencies
Make sure the following are installed:
- `jq`
- `pywal`
- `xwallpaper`
- `xdotool`
- `libnotify`
- `cava`
- `dunst`
---
## 📝 Notes
- Works best on Xorg (Wayland support is limited)
- Customize `config.base` for your Cava defaults
- The script auto-updates `config` on each wallpaper change for Cava
## 🌐 Ecosystem Integration
**Auto-Wallpaper-Themer plays nicely with my suckless setup:**
🖥️ **`dwm`** – https://github.com/happyman09/dwm.git
⌨️ **`st`** (Simple Terminal) – https://github.com/happyman09/st.git
📊 **`dwmblocks`** – https://github.com/happyman09/dwmblocks.git
🧭 **`dmenu`** – https://github.com/happyman09/dmenu.git
---
## 🤝 Contributing
Got ideas or fixes? PRs are welcome. Open an issue first to discuss big changes.
## 📜 License
MIT License – feel free to use, modify, and share.
---