SkillAgentSearch skills...

Hidamari

Video wallpaper for Linux. Written in Python. 🐍

Install / Use

/learn @jeffshee/Hidamari
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

<p align="center"><img src="https://raw.githubusercontent.com/jeffshee/hidamari/master/assets/hidamari.svg" width="256"></p> <p align="center">Video wallpaper for Linux. Written in Python. 🐍</p> <p align="center">Hidamari ζ—₯ζΊœγΎγ‚Šγ€γ²γ γΎγ‚Šγ€‘(n) sunny spot; exposure to the sun</p>

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:

  • [x] Autostart after login
  • [x] Apply static wallpaper with blur effect <sup>1</sup>
  • [x] Detect maximized window and fullscreen mode <sup>2</sup>
  • [x] Volume control
  • [x] Mute/Pause the playback anytime with just 2 clicks!
  • [x] I'm feeling lucky <sup>3</sup>
  • [x] Hardware accelerated video decoding! <sup>4</sup>
  • [x] Gnome Wayland support!
  • [x] Multi-monitor support!
  • [x] Streaming URL support! <sup>5</sup>
  • [x] Webpage as wallpaper! <sup>6</sup>
  • [ ] You name it! =)

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

Installation ⏬

Flatpak πŸ“¦

It is available on Flathub!

<a href='https://flathub.org/apps/details/io.github.jeffshee.Hidamari'><img width='240' alt='Download Hidamari on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png'/></a>

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 ✨

<a href="https://github.com/jeffshee/hidamari/graphs/contributors"> <img src="https://contrib.rocks/image?repo=jeffshee/hidamari" /> </a>

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

Related Skills

View on GitHub
GitHub Stars1.9k
CategoryContent
Updated1d ago
Forks61

Languages

Python

Security Score

100/100

Audited on Mar 27, 2026

No findings