Live Wallpaper for GNOME
Hanabi 花火【はなび】(n) fireworks
( ・ω・)o─━・*:'・:・゜'・:※
Gnome Shell Extension - Hanabi
If you like my project, please consider buying me a coffee!! (⁎˃ ꇴ ˂⁎)ッ
Also please don't forget to hit that star button! 🌟
Feel free to open an issue for problems or suggestions 🤗
Your support is truly appreciated!
Join our Discord!
Demo 📽️
Please click on the image to view (redirect to YouTube)
GNOME Shell Support
Version | Status |
---|---|
≤41 | ⛔ |
42 | ✅ |
43 | ✅ |
44 | ✅ |
45 | ✅ |
See also the section Troubleshooting, for version-specific known issues.
Installation
- Clone the repo
- For GNOME 45
git clone https://github.com/jeffshee/gnome-ext-hanabi.git
- For GNOME 44 and earlier
git clone https://github.com/jeffshee/gnome-ext-hanabi.git -b legacy
- Run the installation script (Require
meson
)
cd gnome-ext-hanabi
./run.sh install
- Restart GNOME Shell
- Enable the Hanabi extension
- Choose your video wallpaper in the extension preference window
Distro-specific Guides
Troubleshooting
-
The video doesn't play / The extension is enabled but nothing happens
The GTK4 media backend is not pre-installed on some distributions (such as PopOS).To install the backend:
sudo apt install libgtk-4-media-gstreamer
-
High CPU usage during video playback (proprietary NVIDIA)
Your hardware acceleration may not work properly, see this issue.To delete the GStreamer cache:
rm -rf ~/.cache/gstreamer-1.0/
After that, check ifgst-inspect-1.0 nvcodec
reports all its features. -
The GNOME Shell keeps crashing after enabling Hanabi, help!
You can try to disable the extension from tty ( Ctrl + Alt + F3 ):gnome-extensions disable hanabi-extension@jeffshee.github.io
Optimization
Hanabi extension can utilize clappersink
from Clapper for the best performance if installed.
For this to work, Clapper must be installed from the package manager and not from Flatpak/Snap.
Performance comparison
Advanced Customization
For more advanced customization, learn how to write scripts for Hanabi extension!
Check out the scripting guide for detailed instructions and examples.
Get Involved 🚀
Contributors are welcome! Let's make Hanabi extension better together~
If you're interested in translating, you can help on Hosted Weblate.
Translation Status
Contributors ✨
Made with contributors-img.
Icons made by Freepik from Flaticon