Giter Site home page Giter Site logo

gnome-ext-hanabi's Introduction

Live Wallpaper for GNOME

Hanabi 花火【はなび】(n) fireworks

( ・ω・)o─━・*:'・:・゜'・:※

Gnome Shell Extension - Hanabi

If you like my project, please consider buying me a coffee!! (⁎˃ ꇴ ˂⁎)ッ

Github-sponsors Ko-Fi BuyMeACoffee

Also please don't forget to hit that star button! 🌟
Feel free to open an issue for problems or suggestions 🤗
Your support is truly appreciated!

Join our Discord!

Discord

Demo 📽️

Please click on the image to view (redirect to YouTube)

Wallpaper used in demo

GNOME Shell Support

Version ≤41 42 43 44 45 46
Status

See also the section Troubleshooting, for version-specific known issues.

Installation

  1. Clone the repo
  • For GNOME 45 and later
git clone https://github.com/jeffshee/gnome-ext-hanabi.git
  • For GNOME 44 and earlier
git clone https://github.com/jeffshee/gnome-ext-hanabi.git -b legacy
  1. Run the installation script (Require meson)
cd gnome-ext-hanabi
./run.sh install
  1. Restart GNOME Shell
  2. Enable the Hanabi extension
  3. Choose your video wallpaper in the extension preference window

Distro-specific Guides

Troubleshooting

  1. The video doesn't play / The extension is enabled but nothing happens
    The GTK4 media backend is not pre-installed on some distributions (such as PopOS).

    To install the backend:
    sudo apt install libgtk-4-media-gstreamer

  2. High CPU usage during video playback (proprietary NVIDIA)
    Your hardware acceleration may not work properly, see this issue.

    To delete the GStreamer cache:
    rm -rf ~/.cache/gstreamer-1.0/
    After that, check if gst-inspect-1.0 nvcodec reports all its features.

  3. The GNOME Shell keeps crashing after enabling Hanabi, help!
    You can try to disable the extension from tty ( Ctrl + Alt + F3 ):

    gnome-extensions disable [email protected]
    

Optimization

Hanabi extension can utilize clappersink from Clapper for the best performance if installed.

For this to work, Clapper must be installed from the package manager and not from Flatpak/Snap.

Performance comparison
  • With clappersink

  • Without clappersink (Using Gtk.MediaFile as default fallback)

Advanced Customization

For more advanced customization, learn how to write scripts for Hanabi extension!
Check out the scripting guide for detailed instructions and examples.

Get Involved 🚀

Contributors are welcome! Let's make Hanabi extension better together~
If you're interested in translating, you can help on Hosted Weblate.

Translation Status

Translation status

Contributors ✨

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

gnome-ext-hanabi's People

Contributors

jeffshee avatar rafostar avatar aumaca avatar weblate avatar vypal avatar comradekingu avatar kurikawatt avatar karorogunso avatar 5mikachu avatar momentqyc avatar optixwolf avatar xaprier avatar cfyusacapraz avatar santossi avatar slowayy avatar anto426 avatar 0xarch avatar alynxzhou avatar arjixwastaken avatar darllowin avatar hotr1pak avatar narcrop avatar stalgo avatar laccsu avatar matt-sennin avatar miphonya avatar yakushabb avatar seikm avatar dzheremi2 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.