Skip to main content

A Minimalist wallpaper generator

Project description

ColorWallpaper

Build Status Codecov Codacy Badge Code style PyPI version

A Minimalist wallpaper generator

Get the latest release

Generates wallpapers such as: Example Generated with:
python -m color_wallpaper --color black --output https://raw.githubusercontent.com/BranislavBajuzik/ColorWallpaper/master/example.png --formats empty HEX rgb --resolution 960x540 --scale 2

Requirements

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

Project details


Download files

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

Source Distribution

color-wallpaper-1.1.7.tar.gz (27.3 kB view hashes)

Uploaded Source

Built Distribution

color_wallpaper-1.1.7-py3-none-any.whl (39.9 kB view hashes)

Uploaded Python 3

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