hidamari

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:

• Autostart after login
• Apply static wallpaper with blur effect ¹
• Detect maximized window and fullscreen mode ²
• Volume control
• Mute/Pause the playback anytime with just 2 clicks!
• I’m feeling lucky ³
• Hardware accelerated video decoding! ⁴
• Gnome Wayland support!
• Multi-monitor support!
• Streaming URL support! ⁵
• 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