white-generator 1.3.0

Utility for a generation of memes

Features

• a generation of memes (in PNG format);

• a support of plain and graphic backgrounds;

• a specification of a text rectangle;

• a support of horizontal and vertical text alignments;

• a read of memes texts from a file (each text is separated from another by a double newline);

• a support single-line and multiline memes texts;

• a protection against duplicate memes texts;

• a support of a watermark (it’s optional);

• meme settings:

  • background:

    • color;

    • width;

    • height;

    • image (it supports same formats as Pillow library);

  • text:

    • font (it supports only TrueType fonts);

    • size;

    • color;

    • left;

    • rigth;

    • top;

    • bottom;

    • horizontal alignment;

    • vertical alignment;

  • watermark:

    • font (it always uses the text font);

    • text;

    • size;

    • color.

Installation

$ pip install white-generator

Usage

$ white-generator -v | --version
$ white-generator -h | --help
$ white-generator [options] (-f FONT_FILE | --font-file FONT_FILE) (-i INPUT_FILE | --input-file INPUT_FILE) (-o OUTPUT_PATH | --output-path OUTPUT_PATH)

Options:

• -v, --version — show the version message and exit;

• -h, --help — show this help message and exit;

• -i INPUT_FILE, --input-file INPUT_FILE — the path to the file with notes;

• -o OUTPUT_PATH, --output-path OUTPUT_PATH — the path for generated images;

• -l TEXT_LEFT, --text-left TEXT_LEFT — the left text position (default: 0);

• -t TEXT_TOP, --text-top TEXT_TOP — the top text position (default: 0);

• -R TEXT_RIGHT, --text-right TEXT_RIGHT — the horizontal text limit (-1 for a background width use; default: -1);

• -B TEXT_BOTTOM, --text-bottom TEXT_BOTTOM — the vertical text limit (-1 for a background height use; default: -1);

• -a {left,center,right}, --text-horizontal-align {left,center,right} — the text horizontal alignment (default: center);

• -A {top,center,bottom}, --text-vertical-align {top,center,bottom} — the text vertical alignment (default: center);

• -W IMAGE_WIDTH, --image-width IMAGE_WIDTH — the image width (default: 640);

• -H IMAGE_HEIGHT, --image-height IMAGE_HEIGHT — the image height (default: 480);

• -b IMAGE_BACKGROUND_COLOR, --image-background-color IMAGE_BACKGROUND_COLOR — the image background color (default: #ffffff);

• -I IMAGE_BACKGROUND_IMAGE, --image-background-image IMAGE_BACKGROUND_IMAGE — the path to the background image (default: none);

• -f FONT_FILE, --font-file FONT_FILE — the path to the font file;

• -s FONT_SIZE, --font-size FONT_SIZE — the font size (default: 25);

• -c FONT_COLOR, --font-color FONT_COLOR — the font color (default: #000000);

• -w WATERMARK_TEXT, --watermark-text WATERMARK_TEXT — the watermark text (empty for disable; default: empty);

• -S WATERMARK_SIZE, --watermark-size WATERMARK_SIZE — the watermark font size (default: 12);

• -C WATERMARK_COLOR, --watermark-color WATERMARK_COLOR — the watermark font color (default: #808080);

• -d DATABASE_FILE, --database-file DATABASE_FILE — the path to the database file (default: notes.db).