# jeffshee/hidamari

Video wallpaper for Linux. Written in Python. 🐍

Repository: https://github.com/jeffshee/hidamari
Canonical: https://ross.abutalabs.com/products/hidamari
Homepage: https://flathub.org/apps/details/io.github.jeffshee.Hidamari
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: wallpaper, video-wallpaper, video-playback, linux, streaming, webpage, live-wallpaper
Last push: 2026-07-09T17:57:39+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 60, longevity 100
- inputs: {"age_days": 2376, "days_push": 55, "days_rel": 55, "gap_med": 552, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2091, forks 78 (observed 2026-08-28T04:06:12.390735+00:00)

## What it is
Hidamari is a video wallpaper application for Linux written in Python that lets users set videos, streaming URLs, or webpages as their desktop wallpaper. It supports hardware-accelerated playback via VLC, GNOME Wayland, multi-monitor setups, and auto-pauses when maximized or fullscreen windows are detected.

## Use cases
- set a video as my desktop wallpaper on linux
- play youtube videos as a live wallpaper
- use a webpage as my wallpaper
- video wallpaper that pauses when a window is maximized
- animated wallpaper with hardware accelerated decoding
- live wallpaper on gnome wayland
- different video wallpaper on each monitor

## When to choose
- You want video or webpage wallpapers on Linux with a GUI instead of hand-rolling xwinwrap + mpv
- You need GNOME Wayland support, multi-monitor wallpapers, or streaming URL playback via yt-dlp
- You want playback to auto-pause on fullscreen/maximized windows and mute/pause from the tray

## When to avoid
- You are on Windows or macOS - it is Linux-only
- You need static image wallpapers with advanced effects on non-GNOME desktops, since blur wallpaper is GNOME-exclusive
- You use Nvidia with Wayland, where hardware-accelerated decoding does not work

## Facets
- artifact type: application
- maturity: active
- function: video-processing, gui, streaming
- domain: desktop-applications, media, operating-systems, entertainment
- platform: -
- tags: video-wallpaper, live-wallpaper, wallpaper, gnome, wayland, yt-dlp, vlc, multi-monitor, webpage-wallpaper, linux, desktop, flatpak

## Member repositories
- jeffshee/hidamari (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:12.390735+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:55:33.158614+00:00, confidence not recorded.
  - readme: https://github.com/jeffshee/hidamari (fetched 2026-08-28T04:06:12.390735+00:00, sha d6a6fe051960)
  - homepage: https://flathub.org/apps/details/io.github.jeffshee.Hidamari (fetched 2026-08-29T10:35:23.187642+00:00, sha a380ec245346)
  - site_page: https://docs.flathub.org/docs/for-app-authors/submission (fetched 2026-08-29T10:35:23.190868+00:00, sha f71a83e36969)
  - site_page: https://flathub.org/en/about (fetched 2026-08-29T10:35:23.193473+00:00, sha 8786526c4967)
  - site_page: https://docs.flathub.org/ (fetched 2026-08-29T10:35:23.195237+00:00, sha 651dbfb8e5ee)
  - site_page: https://flathub.org/en/apps/io.github.jeffshee.Hidamari/install (fetched 2026-08-29T10:35:23.196755+00:00, sha 41c621591da5)
- Data as of 2026-08-30T08:39:29.467469+00:00.