Skip to main content

Wallpaper changer for Linux, get images from Wallhaven, Unsplash and others!

Project description

Wallger: The Wallpaper Changer

License: MIT Code style: black Code style: black

(To see a better quality version click on the gif)

Install Instructions

At the moment Walger only supports Gnome, Mate and any Window Manager(i3wm, bspwm, etc). If you are on a Window Manger you need to:

  • Install feh (Adapt it to your distribution):
sudo pacman -S feh

If you are In Gnome or Mate you don't need to do that.

  • Clone the repository somewhere:
git clone https://github.com/ultirequiem/wallger ~/Documents/wallger
  • Install the requirements:
cd ~/Documents/wallger ; pip3 install -r requirements.txt
  • Copy the example config in ~/.config/wm-wallpaper-changer/:
cp ~/Documents/wallger/doc/config.json ~/.config/wallger/config.json
  • Choose the Wallpaper provider you want and place the resolution of your monitor in the configuration file. You can investigate a little more about the parameters that the configuration receives in docs.
  • Set an alias:
echo alias wallger='python3 ~/Documents/wallger/main.py' >> ~/.bashrc

Done! Now you can call wallger everywhere. If you want to see some interesting use cases check this.

If you have Python3.10 you may be wanna try this branch: https://github.com/UltiRequiem/wallger/tree/python310

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wallger-0.5.1.tar.gz (3.9 kB view hashes)

Uploaded Source

Built Distribution

wallger-0.5.1-py3-none-any.whl (4.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page