Skip to content

rugglcon/python-backgroundchanger

Repository files navigation

Background Changer

A small program in Python 3 that grabs a random photo from Unsplash according to your screen resolution and sets it as your background.

Further testing

This hasn't yet been tested on Windows or Mac (being worked on), but it works for Ubuntu Linux. Any commands I might have gotten wrong to set it as your background, please feel free to fix those or add more!

Dependencies

This is pretty light on dependencies, but you will need to make sure you have a couple things:

  • tkinter - a python GUI toolkit, but is only used to get the screen resolution. This is usually installed via a system package.
  • requests - python module for HTTP requests.
  • pywal - generates color schemes and used for changing the wallpaper.

Optional Dependencies

  • feh, if you use a Linux system that's not Ubuntu or Elementary OS. This is not in PyPi, it'll be in your distros repos.

Installation and Usage

NOTE: For Mac, first test if you have tkinter directly installed with your Python version first:

python3
>>> import tkinter

If that doesn't cause an error, you're good. If it does, follow this Stack Overflow Post to get that correctly set up. Then you can continue with the installation:

pip install backgroundchanger

Usage

backgroundchanger

# To view the help menu
backgroundchanger -h
# or
backgroundchanger --help

How to contribute?

For issue and PR guidelines, see CONTRIBUTING.md.

About

A simple background changer using Unsplash API

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages