{"id":13438601,"url":"https://github.com/jeffshee/gnome-ext-hanabi","last_synced_at":"2025-05-14T19:09:47.488Z","repository":{"id":41472283,"uuid":"509753398","full_name":"jeffshee/gnome-ext-hanabi","owner":"jeffshee","description":"Live Wallpaper for GNOME","archived":false,"fork":false,"pushed_at":"2025-05-12T03:15:53.000Z","size":6838,"stargazers_count":1071,"open_issues_count":57,"forks_count":26,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-05-12T04:26:30.209Z","etag":null,"topics":["gnome","gnome-shell-extension","live-wallpaper","video-wallpaper","wallpaper"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeffshee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"jeffshee","ko_fi":"jeffshee","buy_me_a_coffee":"jeffshee"}},"created_at":"2022-07-02T12:45:47.000Z","updated_at":"2025-05-12T03:15:56.000Z","dependencies_parsed_at":"2023-02-15T20:15:27.760Z","dependency_job_id":"34610d44-5d52-49c5-90c4-a44c6b242a4d","html_url":"https://github.com/jeffshee/gnome-ext-hanabi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffshee%2Fgnome-ext-hanabi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffshee%2Fgnome-ext-hanabi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffshee%2Fgnome-ext-hanabi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffshee%2Fgnome-ext-hanabi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeffshee","download_url":"https://codeload.github.com/jeffshee/gnome-ext-hanabi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254209859,"owners_count":22032897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gnome","gnome-shell-extension","live-wallpaper","video-wallpaper","wallpaper"],"created_at":"2024-07-31T03:01:06.780Z","updated_at":"2025-05-14T19:09:46.238Z","avatar_url":"https://github.com/jeffshee.png","language":"JavaScript","funding_links":["https://github.com/sponsors/jeffshee","https://ko-fi.com/jeffshee","https://buymeacoffee.com/jeffshee"],"categories":["HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/jeffshee/gnome-ext-hanabi/master/res/sparkler.svg\" width=\"256\"\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eLive Wallpaper for GNOME\u003c/p\u003e  \n\u003cp align=\"center\"\u003eHanabi 花火【はなび】(n) fireworks\u003c/p\u003e\n\u003cp align=\"center\"\u003e( ・ω・)o─━・*:'・:・゜'・:※\u003c/p\u003e\n\n# Gnome Shell Extension - Hanabi\n\nIf you like my project, please consider buying me a coffee!! (⁎˃ ꇴ ˂⁎)ｯ\n\n[![Github-sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA)](https://github.com/sponsors/jeffshee)\n[![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/jeffshee)\n[![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://buymeacoffee.com/jeffshee)\n\nAlso please don't forget to hit that star button! 🌟  \nFeel free to open an issue for problems or suggestions 🤗  \nYour support is truly appreciated!\n\n## Join our Discord!\n\n[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/mP7yg4gX7g)\n\n## Demo 📽️\n\nPlease click on the image to view \u003ci\u003e(redirect to YouTube)\u003c/i\u003e\n\n[![](https://i3.ytimg.com/vi/BWjXl4h9_BA/maxresdefault.jpg)](https://www.youtube.com/watch?v=BWjXl4h9_BA)\n[Wallpaper used in demo](https://www.youtube.com/watch?v=2pBj0RKN3Y8)\n\n## GNOME Shell Support\n\n| Version | ≤41 | 42  | 43  | 44  | 45  | 46  | 47  | 48  |\n| :-----: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |\n| Status  | ⛔  | ✅  | ✅  | ✅  | ✅  | ✅  | ✅  | 🚧  |\n\nSee also the section [Troubleshooting](#troubleshooting), for version-specific known issues.\n\n## Installation\n\n1. Clone the repo\n\n-   **For GNOME 48 (experimental)**\n\n    ```\n    git clone https://github.com/jeffshee/gnome-ext-hanabi.git -b gnome-48\n    ```\n\n-   **For GNOME 45 and later**\n    ```\n    git clone https://github.com/jeffshee/gnome-ext-hanabi.git\n    ```\n-   **For GNOME 44 and earlier**\n    ```\n    git clone https://github.com/jeffshee/gnome-ext-hanabi.git -b legacy\n    ```\n\n2. Run the installation script (Require `meson`)\n\n    ```\n    cd gnome-ext-hanabi\n    ./run.sh install\n    ```\n\n3. Restart GNOME Shell\n4. Enable the Hanabi extension\n5. Choose your video wallpaper in the extension preference window\n\n### Distro-specific Guides\n\n-   [Installation Guide for Ubuntu/Pop!\\_OS 22.04](docs/ubuntu-22-04.md)\n-   [Installation Guide for Ubuntu 23.04](docs/ubuntu-23-04.md)\n-   [Installation Guide for openSUSE Tumbleweed](docs/opensuse-tumbleweed.md)\n\n### Troubleshooting\n\n1. The video doesn't play / The extension is enabled but nothing happens  \n   The GTK4 media backend is not pre-installed on some distributions (such as PopOS).\n\n    To install the backend:  \n     `sudo apt install libgtk-4-media-gstreamer`\n\n2. High CPU usage during video playback (proprietary NVIDIA)  \n   Your hardware acceleration may not work properly, see this [issue](https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/issues/1478).\n\n    To delete the GStreamer cache:  \n     `rm -rf ~/.cache/gstreamer-1.0/`  \n     After that, check if `gst-inspect-1.0 nvcodec` reports all its features.\n\n3. The GNOME Shell keeps crashing after enabling Hanabi, help!  \n   You can try to disable the extension from tty ( \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eF3\u003c/kbd\u003e ):\n    ```\n    gnome-extensions disable hanabi-extension@jeffshee.github.io\n    ```\n\n### Optimization\n\nHanabi extension can utilize `clappersink` from [Clapper](https://github.com/Rafostar/clapper) for the best performance if installed.\n\nFor this to work, Clapper must be installed **from the package manager and not from Flatpak/Snap**.\n\n\u003cdetails\u003e\n  \u003csummary\u003ePerformance comparison\u003c/summary\u003e\n\n-   With `clappersink`\n    ![](https://user-images.githubusercontent.com/25530920/190872365-f1cefa30-6e11-40e4-bf99-1b79c3790d6b.png)\n\n-   Without `clappersink` (Using `Gtk.MediaFile` as default fallback)\n    ![](https://user-images.githubusercontent.com/25530920/190872366-7fce5703-2310-4c68-81c7-f17a8a15019f.png)\n\n\u003c/details\u003e\n\n## Advanced Customization\n\nFor more advanced customization, learn how to write scripts for Hanabi extension!  \nCheck out the [scripting guide](docs/scripting.md) for detailed instructions and examples.\n\n## Get Involved 🚀\n\nContributors are welcome! Let's make Hanabi extension better together~  \nIf you're interested in translating, you can help on [Hosted Weblate](https://hosted.weblate.org/projects/gnome-ext-hanabi/gnome-ext-hanabi/).\n\n### Translation Status\n\n[![Translation status](https://hosted.weblate.org/widget/gnome-ext-hanabi/gnome-ext-hanabi/multi-auto.svg)](https://hosted.weblate.org/engage/gnome-ext-hanabi/)\n\n### Contributors ✨\n\n\u003ca href=\"https://github.com/jeffshee/gnome-ext-hanabi/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=jeffshee/gnome-ext-hanabi\" /\u003e\n\u003c/a\u003e\n\nMade with [contributors-img](https://contrib.rocks).  \nIcons made by [Freepik](http://www.freepik.com/) from [Flaticon](https://www.flaticon.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffshee%2Fgnome-ext-hanabi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeffshee%2Fgnome-ext-hanabi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffshee%2Fgnome-ext-hanabi/lists"}