https://github.com/jeffshee/hidamari
Video wallpaper for Linux. Written in Python. π
https://github.com/jeffshee/hidamari
linux live-wallpaper streaming video-playback video-wallpaper wallpaper webpage
Last synced: 2 days ago
JSON representation
Video wallpaper for Linux. Written in Python. π
- Host: GitHub
- URL: https://github.com/jeffshee/hidamari
- Owner: jeffshee
- License: gpl-3.0
- Created: 2020-03-01T19:15:37.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-03T05:38:29.000Z (3 months ago)
- Last Synced: 2025-04-06T17:01:35.754Z (9 days ago)
- Topics: linux, live-wallpaper, streaming, video-playback, video-wallpaper, wallpaper, webpage
- Language: Python
- Homepage: https://flathub.org/apps/details/io.github.jeffshee.Hidamari
- Size: 5.54 MB
- Stars: 1,366
- Watchers: 16
- Forks: 39
- Open Issues: 80
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- stars - jeffshee/hidamari
- Awesome - Hidamari - Video wallpaper for Linux. Written in Python. π (Desktop Customization / VoIP)
- awesome-list - hidamari - Video wallpaper for Linux. Written in Python. (Themes π / Live Wallpapers)
README
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!! (βΛ κ΄ Λβ)ο½―
[](https://github.com/sponsors/jeffshee)
[](https://ko-fi.com/jeffshee)
[](https://buymeacoffee.com/jeffshee)
Also please don't forget to click that star button! π
Your support is truly appreciated!
## Join our Discord!
[](https://discord.gg/mP7yg4gX7g)
## For GNOME user πΎ
Please also check my new project [Hanabi](https://github.com/jeffshee/gnome-ext-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](https://www.linuxuprising.com/2019/05/livestream-wallpaper-for-your-gnome.html)
2. [Komorebi](https://github.com/cheesecakeufo/komorebi)
Hidamari offers similar feature as above, with additional features listed below:
- [x] Autostart after login
- [x] Apply static wallpaper with blur effect 1
- [x] Detect maximized window and fullscreen mode 2
- [x] Volume control
- [x] Mute/Pause the playback anytime with just 2 clicks!
- [x] I'm feeling lucky 3
- [x] Hardware accelerated video decoding! 4
- [x] Gnome Wayland support!
- [x] Multi-monitor support!
- [x] Streaming URL support! 5
- [x] 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!
#### Command line instructions
Install:
Make sure to follow the [setup guide](https://flatpak.org/setup/) 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 | [](https://aur.archlinux.org/packages/hidamari) | 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](https://contrib.rocks).
Icons made by [Freepik](http://www.freepik.com/) from [Flaticon](https://www.flaticon.com)