Skip to content

jeffshee/hidamari

Repository files navigation

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!! (⁎˃ ꇴ ˂⁎)ッ

Github-sponsors Ko-Fi BuyMeACoffee

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

Join our Discord!

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 1
  • Detect maximized window and fullscreen mode 2
  • Volume control
  • Mute/Pause the playback anytime with just 2 clicks!
  • I'm feeling lucky 3
  • Hardware accelerated video decoding! 4
  • Gnome Wayland support!
  • Multi-monitor support!
  • Streaming URL support! 5
  • Webpage as wallpaper! 6
  • You name it! =)

1 Video frame can be applied as system wallpaper, look great in GNOME (currently GNOME exclusive, support for other DE might be added if requested...)
2 Automatically pauses playback when maximized window or full screen mode is detected (currently X11 only...)
3 Randomly select and play a video
4 Use vlc as backend (currently HW acceleration doesn't work with Nvidia+Wayland combination...)
5 Use yt-dlp as backend, tested with YouTube videos
6 Theoretically it can be anything from a normal webpage to Unity/Godot WebGL games, be creative!

Installation ⏬

Flatpak 📦

It is available on Flathub!

Download Hidamari 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 AUR 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