A handy little tool for creating nice, uniform, scalable photo borders with text. Powered by Python with ImageMagick!
- Profile driven using TOML based configuration files
- Run multiple export profiles in a single command
- Customisable title, year and creator name
- Change your fonts, font colour and font weight
- Set colours for the border and text independently
- Supports resizing images during export
- Supports exporting to jpeg, png and tiff formats
- Selectable JPEG export quality
- Python 3.10+
- ImageMagick
Grab ImageMagick for your platform first as it's needed for the Wand library bindings:
- Windows: https://docs.wand-py.org/en/0.6.11/guide/install.html#install-imagemagick-on-windows
- Mac: https://docs.wand-py.org/en/0.6.11/guide/install.html#install-imagemagick-on-mac
- Linux: https://docs.wand-py.org/en/0.6.11/guide/install.html#install-imagemagick-on-debian-ubuntu
- Clone the repo
- (Optional) Create a virtual environment:
python -m venv .venv - Install required Python packages:
pip3 install -r ./requirements.txt. Note thatpip3might just bepipon your system. - Run a minimal command:
python .\border.py "C:\\Photography\\Export\\Full Border\\img014.jpg" "My Sample Caption" 2023
Note that you will always need to provide at least the input file path, the image title and the year the image was taken. These arguments are positional. You can add the --profiles parameter to run a custom configuration, or several at once like: --profiles default profile1 profile2.
(.venv) PS C:\Photography\scripts> python .\border.py "C:\\Photography\\Export\\Full Border\\img014.jpg" "My Sample Caption" 2023 --profiles default
Running profile: default
Input image:C:\Photography\Export\Full Border\img014.jpg
Output image:C:\Photography\Export\Full Border\img014_b.jpg
Input resolution: 6499x4874
Saved output image successfully
All done!