Package: image-titler
Image TitlerThe Image Titler is a tool which provides options for generating thumbnails for various social media platforms.
Currently, the tool has a predefined style which looks roughly like the following image:To see more examples, check out ourlist of samples.How to RunThe following code snippet demonstrates a few ways you might use the script:pipinstallimage-titler# Installs the scriptimage-titler# Runs as defaultimage-titler--title"Hello, World!"# Adds a custom titleimage-titler--output_path"path/to/output"# Sets the output pathimage-titler--path"path/to/image"# Sets the image pathimage-titler--tier"free"# Sets the membership tier which changes the rectangle bordersimage-titler--logo_path"path/to/logo"# Adds a 145x145 logo to the lower left corner of the imageimage-titler--batch# Runs the program in batch mode on a directoryimage-titler--font"path/to/font"# Changes the default title fontimage-titler--sizeYouTube# Changes the aspect ratio of the output fileimage-titler--no_title# Do not add titleAlternatively, you can spin up the GUI version of the software as of 2.0.0 as follows:image-titler-gui# Options can be used to preload GUI as of 2.2.0image-titler-gui--title"Hello, World!"# Adds a custom titleimage-titler-gui--output_path"path/to/output"# Sets the output pathimage-titler-gui--path"path/to/image"# Sets the image pathimage-titler-gui--tier"free"# Sets the membership tier which changes the rectangle bordersimage-titler-gui--logo_path"path/to/logo"# Adds a 145x145 logo to the lower left corner of the imageimage-titler-gui--batch# Runs the program in batch mode on a directoryimage-titler-gui--font"path/to/font"# Changes the default title fontimage-titler-gui--sizeYouTube# Changes the aspect ratio of the output fileimage-titler-gui--no_title# Do not add titleDefault BehaviorCurrently, the image-titler script makes a few assumptions about the images it
processes automatically:This tool scrapes file names for image titles. To do this, it assumes
file names are written in kebab-case where each word is separated by a hyphen.
Then, words are extracted and title cased before being printed on the image.The color of the title bars defaults to The Renegade Coder Red (201, 2, 41, 255).
If you'd like a different color, the script automatically extracts the most dominant
color from logos. At this time, there is no way to customize bar color.Added elements have fixed position. Logos will always appear in the bottom left.
Titles will always appear in the top right.There are likely other default behaviors not documented here. Feel free to experiment
with the tool and share any issues you find.Full List of OptionsHere's a description of all the option used in the samples above.OptionDomainDescription--batch, -bTrue/FalseTurns on batch processing--font, -fAny valid font fileOverrides the default title font--logo_path, -lAny valid image fileLoads a logo onto the input image--output_path, -oAny valid directoryDetermines where files will be saved (has no effect in GUI)--path, -pAny valid file or directoryLoads the input image (or directory when in batch mode)--size, -sChoose between "Twitter", "WordPress", and "YouTube"Sets the aspect ratio of the output image--tier, -rChoose between "free" (silver) or "premium" (gold)Adds a border color to the title--title, -tAny stringOverrides the automatic title feature--no_title, -nDo not add titlePython Version CompatibilityAs this utility has grown and changed, it has also changed its
support for different versions of Python.Python3.123.113.103.93.8image-titler >= 2.5yesyesimage-titler 1.8 - 2.4yesyesyesimage-titler <= 1.8