Video wallpaper for Linux. 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!

Join our Discord!

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 (currently GNOME exclusive, support for other DE might be added if requested...)
² Automatically pauses playback when maximized window or full screen mode is detected (currently X11 only...)
³ Randomly select and play a video
⁴ Use vlc as backend (currently HW acceleration doesn't work with Nvidia+Wayland combination...)
⁵ 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!

Installation ⏬

Flatpak 📦

It is available on Flathub!

Command line instructions

Install:
Make sure to follow the setup guide before installing

flatpak install flathub io.github.jeffshee.Hidamari

Run:

flatpak run io.github.jeffshee.Hidamari

Unofficial package

These are maintained by the community!	Distro	URL	Maintainer
Arch Linux		None

Screenshot 📸

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