Skip to content
Switch branches/tags

Komorebi - Animated Wallpapers for Linux

(n) sunlight filtering through trees.

Platform (GNU/Linux) Awesome Build Status

Komorebi Demo
Watch demo

What is Komorebi?

Komorebi is an awesome animated wallpapers manager for all Linux platforms. It provides fully customizeable image, video, and web page wallpapers that can be tweaked at any time!


How do I install Komorebi?

Two ways:

Packaged install (easy)

  1. Download Komorebi from the Komorebi releases page.
  2. Install Komorebi using your favorite package installer (aka. double click on it)
  3. Launch Komorebi!

Manual Installing (advanced)

Run the following:

sudo add-apt-repository ppa:gnome3-team/gnome3 -y
sudo add-apt-repository ppa:vala-team -y
sudo add-apt-repository ppa:gnome3-team/gnome3-staging -y
sudo apt install cmake valac libgtk-3-dev libgee-0.8-dev libclutter-gtk-1.0-dev libclutter-1.0-dev libwebkit2gtk-4.0-dev libclutter-gst-3.0-dev
git clone
cd komorebi
mkdir build && cd build
cmake .. && sudo make install && ./komorebi

Change Wallpaper & Desktop Preferences

To change desktop preferences or your wallpaper, right click anywhere on the desktop to show the menu.


How do I create my own wallpaper?

Komorebi provides a simple tool to create your own wallpapers! Simply, open your apps and search for 'Wallpaper Creator'


You can use either an image, a video, or a web page as a wallpaper and you have many different options to customize your very own wallpaper!


If you installed a packaged version of Komorebi

  1. Open Terminal
  2. sudo apt remove komorebi

If you manually installed Komorebi

  1. Open Terminal
  2. cd komorebi/build
  3. sudo make uninstall

Questions? Issues?

Komorebi is slow. What can I do about it?

Komorebi includes support for video wallpapers that might slow your computer down. You can disable support for video wallpapers in 'Desktop Preferences' → uncheck 'Enable Video Wallpapers'.

note: you need to quit and re-open Komorebi after changing this option

After uninstalling, my desktop isn't working right (blank or no icons)

The latest Komorebi should already have a fix for this issue. If you've already uninstalled Komorebi and would like to fix the issue, simply run this (in the Terminal): curl -s | bash -s

If your issue has not already been reported, please report it here and I'll try my best to fix them.

Why does Komorebi install files in a macOS-like structure?

Komorebi was originally intended to run on an unreleased OS project. Since many people already use Komorebi, an update could potentially break Komorebi and custom-made wallpapers.

It is possible to change the file structure with code changes and a postinst script but I'd rather keep it as is for now or if you have the time to make one, feel free to do so and submit a PR!

Status of Development

Komorebi still receives updates but they are not as frequent due to my involvement in other open-source projects.

Thanks To:

Pete Lewis (@PJayB) for adding mult-monitor support