Skip to main content

Wallpaper Getter and Setter

Project description


Set your background on multiple monitors to random images from Unsplash, mikedrawsdota, and more.


Multiwall works with Python 3.

python -m pip install multiwall


python -m multiwall
python -m multiwall --query "plants"

The default source is Unsplash, use the --source flag to change it.

python -m multiwall --source 'mikedrawsdota'

As a Desktop Shortcut

  1. Create a file wallpaper.pyw with the following contents:

    import multiwall
  2. Set it to Open With "C:\Windows\pyw.exe"


# 4k monitor + 1080p monitor (5760x2160 picture)
python -3 -m multiwall --monitors "3440x1440,1920x1080"


# 4k monitor + portait monitor
python -m multiwall --monitors "3440x1440,1440x2560"


Planned Features

  • [*] Automatic monitor size detection
  • [*] Custom search parameters
  • [*] Save images without setting wallpaper
  • Favorite images

Updating PyPi

python -m pip install wheel twine
python bdist_wheel
python -m twine upload --skip-existing dist/*

Creating executable

python -m pip install pyinstaller
pyinstaller --onefile --icon=app.ico "Change Wallpaper.pyw"



  • Fixed typo introduced in 1.5


  • Changed resize method to scale and crop images to avoid overlap.
  • Fixed image placement method to support more monitor layouts.
  • Broke the package with a typo :(


  • Changed resize method to fit the width of the monitors.


  • Added screeninfo to required packages, works on fresh install now.

Project details

Download files

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

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

multiwall-1.8-py3-none-any.whl (5.8 kB view hashes)

Uploaded py3

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