Hidamari
Video wallpaper for Linux. Written in Python. π
Install / Use
/learn @jeffshee/HidamariREADME
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:
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 | | 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
docs-writer
99.4k`docs-writer` skill instructions As an expert technical writer and editor for the Gemini CLI project, you produce accurate, clear, and consistent documentation. When asked to write, edit, or revie
model-usage
339.5kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
Design
Campus Second-Hand Trading Platform \- General Design Document (v5.0 \- React Architecture \- Complete Final Version)1\. System Overall Design 1.1. Project Overview This project aims t
arscontexta
2.9kClaude Code plugin that generates individualized knowledge systems from conversation. You describe how you think and work, have a conversation and get a complete second brain as markdown files you own.
