https://github.com/kylepw/wikiwall

Python CLI that customizes your macOS desktop background with beautiful artwork.
https://github.com/kylepw/wikiwall

cli commandline desktop-wallpaper macos macosx python wallpaper wikiart

Last synced: about 1 year ago
JSON representation

Python CLI that customizes your macOS desktop background with beautiful artwork.

• Host: GitHub
• URL: https://github.com/kylepw/wikiwall
• Owner: kylepw
• License: mit
• Created: 2019-02-26T13:07:19.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-26T20:54:16.000Z (over 3 years ago)
• Last Synced: 2025-05-13T02:14:12.785Z (about 1 year ago)
• Topics: cli, commandline, desktop-wallpaper, macos, macosx, python, wallpaper, wikiart
• Language: Python
• Homepage: https://wikiwall.readthedocs.io
• Size: 14.8 MB
• Stars: 7
• Watchers: 0
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
========

wikiwall

========

.. image:: https://travis-ci.com/kylepw/wikiwall.svg?branch=master

    :target: https://travis-ci.com/kylepw/wikiwall

.. image:: https://readthedocs.org/projects/wikiwall/badge/?version=latest

	:target: https://wikiwall.readthedocs.io/en/latest/?badge=latest

	:alt: Documentation Status

.. image:: https://coveralls.io/repos/github/kylepw/wikiwall/badge.svg?branch=master

	:target: https://coveralls.io/github/kylepw/wikiwall?branch=master

*wikiwall* is a CLI that downloads a random image from Wikiart's Hi-Res page and sets it as your desktop background in macOS.

.. image:: https://github.com/kylepw/wikiwall/blob/master/docs/_static/example.gif

	:align: center

Features

--------

- Easily customize your desktop with new hi-res artwork from the command line.

- Update your wallpaper periodically with your favorite scheduler.

Requirements

------------

- Python 3.6 or higher

- macOS

Installation

------------

::

	$ pip3 install wikiwall

If you want, set your wallpaper to change every night with launchd: ::

	$ git clone https://github.com/kylepw/wikiwall.git && cd wikiwall

	$ sed -i.bak -e "s|WIKIWALL|$(which wikiwall)|g" wikiwall.plist

	$ cp wikiwall.plist ~/Library/LaunchAgents

	$ launchctl load ~/Library/LaunchAgents/wikiwall.plist

Usage

-----

::

	$ wikiwall --help

	Usage: wikiwall [OPTIONS] COMMAND [ARGS]...

  	  Set desktop background in macOS to random WikiArt image.

	Options:

  	  --dest TEXT      Download images to specified destination.

  	  --limit INTEGER  Number of files to keep in download directory. Set to -1

   	                   for no limit. Default is 10.

  	  --debug          Show debugging messages.

  	  --help           Show this message and exit.

	Commands:

  	  show  Show previous downloads in Finder.

Todo

----

- Set wallpaper on a desktop not currently being viewed.

- Add support for other operating systems.

- Provide preview of image before setting as background.

License

-------

`MIT License `_