Video wallpaper for Linux. Minimal and written in Python.

Hidamari 日溜まり【ひだまり】(n) sunny spot; exposure to the sun

Hidamari　ーひだまりー

If you like my project, please consider buying me a coffee!! (⁎˃ ꇴ ˂⁎)ｯ

Also please don't forget to click that star button! 🌟
Your support is truly appreciated!

For GNOME user 🐾

Please also check my new project Hanabi! While the project is still in its infancy, it has the potential to become more integrated with GNOME Shell.

Features 🔥

There are several solutions to achieve video as wallpaper on Linux, for example:

1. Xwinwrap + mpv
2. Komorebi

Hidamari offers similar feature as above, with additional features listed below:

• [x] Autostart after login
• [x] Apply static wallpaper with blur effect ¹
• [x] Detect maximized window and fullscreen mode ²
• [x] Volume control
• [x] Mute/Pause the playback anytime with just 2 clicks!
• [x] I'm feeling lucky ³
• [x] Hardware accelerated video decoding! ⁴
• [x] Gnome Wayland support!
• [x] Multi-monitor support!
• [x] Streaming URL support! ⁵
• [x] Webpage as wallpaper! ⁶
• [ ] You name it! =)

¹ Video frame can be applied as system wallpaper, look great in GNOME
² Automatically pauses playback when maximized window or full screen mode is detected (Limited support for Gnome Wayland, see issue #40)
³ Randomly select and play a video
⁴ Use vlc as backend
⁵ Use yt-dlp as backend, tested with YouTube videos
⁶ Theoretically it can be anything from a normal webpage to Unity/Godot WebGL games, be creative!

(Un)Installation ⏬

Run the script in terminal to install or uninstall:

bash <(wget -qO- https://raw.githubusercontent.com/jeffshee/hidamari/master/install.sh)

The script will also check for the dependencies. It will try to install them if possible (only for pip packages).

Screenshot 📸

Demo 📽️

Please click on the image to view (redirect to YouTube)

Please!! 🙏

Collaboration is welcome! Let's make it better together~
Feel free to open an issue if you have any problem or suggestion 🤗

Contributors ✨

Made with contributors-img.
Icons made by Freepik from Flaticon