wallblur

wallblur is a simple shell script that creates a faux blurred background effect for your linux desktop without needing a compositor.

Getting Started

Dependencies

In order to use the script, you will need to make sure you have imagemagick, hsetroot (or any command line program that sets a wallpaper, such as feh) and wmctrl installed.

Note

Make sure that you stop any existing application that is responsible for setting your wallpaper.

The script will automatically resize your wallpaper while maintaining aspect ratio so that it fits your display's resolution. Don't worry, it will not modify the original file.

Running wallblur

Usage: wallblur -[i,o] image/directory
Detail:
	-i	Normal mode;
	-o	One-shot mode, Wallblur will not close with the terminal,
		nor will it display messages and will kill any previous instance of this script;

the manual way

You can run wallblur by running the following command:

path/to/wallblur.sh -i 'path/to/wallpaper.jpeg' &

or entering a folder that contains only images, wallblur will take an image of that folder at random

path/to/wallblur.sh -i 'path/to/wallpapers/folder' &

or passing the program to be used to set the wallpaper

custom_command="feh --bg-fill" path/to/wallblur.sh -i 'path/to/wallpaper.jpeg' &

If you are copying and pasting the script instead of downloading the script. Make sure you make it executable by using the following command:

chmod +x path/to/wallblur.sh

automatically start wallblur on startup

If you would like to start wallblur on startup automatically, assuming you are on an X11 windowing system, add the following line to your .xprofile file:

path/to/wallblur.sh -o 'path/to/wallpaper.jpeg' &

Replacing path/to/ with the actual path where the script is residing.

And if you are using i3wm, you can add this line to your config:

exec --no-startup-id path/to/wallblur.sh -o path/to/wallpaper.jpeg &