Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
bgs - back ground setter
bgs is an extremely fast and small background setter for X.

In order to build bgs you need the Xlib and Imlib2 header files.

Edit to match your local setup (bgs is installed into
the /usr/local namespace by default).

Afterwards enter the following command to build and install bgs (if
necessary as root):

    make clean install

Running bgs
Add the following line to your .xinitrc to start bgs using startx:

    bgs <image> &

In order to connect bgs to a specific display, make sure that
the DISPLAY environment variable is set correctly, e.g.: bgs <image> &

(This will start bgs on display :1 of the host

In order to have a different image on each monitor you can specify
multiple images (one per monitor), e.g.: bgs <image1> <image2> &

(This will display image1 on monitor 1 and image2 on monitor 2.)