Skip to content
Wallpaper automation tool
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
wpctl

README.md

wpctl

Wallpaper Control is a minimalist wallpaaper automation tool for linux based on Unsplash

Getting Started

It is working with Unsplash Api

  • Minimalist 100 lines of code zero dependency
  • Auto resolution detection
  • Multi monitor handling
  • Tested on Ubuntu 18.04 with GNOME Desktop

Prerequisities

sudo apt-get install wget notify-send

Installing

sudo wget --quiet https://github.com/mozanunal/wpctl/releases/download/0.0.2/wpctl \
          -O /usr/local/bin/wpctl && \
          sudo chmod +x /usr/local/bin/wpctl

Try the application

user@user:$ wpctl
Please provide a valid wallpaper source
Usage:
wpctl <SOURCE>
       random
       daily
       collection
       topic1,topic2
user@user:$ wpctl random
--> Random is selected as source.
https://source.unsplash.com/random/1920x1080
--> From source 'random' wallpaper set. 1920 x 1080

Wallpapers can automatically updated using crontab. Write following command and add line according to your favorite configuration

crontab -e

Every hours pick a random wallpaper

0 * * * * wpctl random

Every day get daily photo as wallpaper

0 10 * * * wpctl daily

Every 15 mins pick a cat image as your wallpaper

*/15 * * * * wpctl cat

Every 3 hours pick a blue image as your wallpaper

0 */3 * * * wpctl blue

Uninstalling

Remove binaries

sudo rm /usr/local/bin/wpctl

Remove picture

rm -rf $HOME/wpctl

Authors

  • Mehmet Ozan Ünal

License

  • MIT

Acknowledgments

You can’t perform that action at this time.