Cosmic-Onion/ColorWallpaper

Minimalist wallpaper generator

ColorWallpaper

The plan is to sync this with awesome to generate new wallpapers on new load

A Minimalist wallpaper generator

Get the latest release

Generates wallpapers such as: Generated with:
python -m color_wallpaper --color black --output example.png --formats empty HEX rgb --resolution 960x540 --scale 2

Requirements

• Python 3.6+
• PIL

Usage

Direct generation: python ColorWallpaper.py --option[s]

Options:

• -h/--help
  • Display help and exit

File options

• -o/--output PATH
  • Used to specify image output path.
  • Default: out.png
• -y/--yes
  • Forces overwrite of --output

Color options

• -c/--color COLOR
  • Used to specify Background color. Also accepts random which picks random named color.
  • Default: random
• -c2/--color2 COLOR
  • Used to specify text color. Also accepts inverted which is the inverse of --color.
  • Default: inverted
• -d/--display NAME
  • Overrides the display name of the --color. Empty string disables the name row.
• --min-contrast CONTRAST
  • Min contrast of --color and --color2, if --color2 is inverted. Will raise if this can not be satisfied.
  • Default: 1
• --overlay-color COLOR
  • Used to specify color of potential overlay, like icons or text.
• --overlay-contrast CONTRAST
  • Min contrast of --color and --overlay-color. Will raise if this can not be satisfied.
  • Default: 1

Display options

• -r/--resolution RESOLUTION
  • Used to specify image resolution.
  • Default: 1920x1080.
• -s/--scale SCALE
  • The size of the highlight (128px) will be multiplied by this.
  • Default: 3
• -f/--formats [FORMAT ...]
  • Declares the order and formats to display
  • Default: empty HEX rgb

Argument formats

• COLOR
  • #Hex: Three or six hexadecimal digits optionally starting with #.
  • R,G,B: Three comma separated numbers in range 0-255.
  • Valid name of a color.
• CONTRAST
  • A float in range 1-21.
• RESOLUTION
  • Two positive integers greater or equal to 150, separated by x or :.
• FORMAT
  • Self explanatory: hex, rgb, hsv, hsl, cmyk
  • empty: Empty row.
  • #hex: hex, but starting with #
  • #HEX, HEX: Like hex, but uppercase

Contribute

Setup environment

python -m pip install -r requirements.txt
python -m pip install -r requirements-dev.txt
pre-commit install

Run tests

python -m unittest discover