A CLI tool to generate beautiful and compact posters for your favorite albums. Free, open-source and configurable print-it-yourself alternative to commercially available services offered by e.g. ZeitGeistGalerie, RedBubble or Amazon.
InquirerPy - Inter - iTunes Search API - scikit-learn - Pillow - requests - NumPy
- Added overflow checking and mitigation
- Works for all single per-line elements (album title, artist and copyright notice)
Older Versions
- Removed Pylette dependency
- Image color extraction implemented via K-Means-Clustering (initially seemd counterintuitive but results are of higher visual quality than those from median cut)
- Initial release
- Python (tested for > 3.9)
- Inter Typeface
After installing all hard requirements, the simplest way to get the script is to clone the repository and then install the required packages via the requirements.txt file.
- Clone repository
# Clone using web url
git clone https://github.com/maxschroen/artworker.git
# OR clone using GitHub CLI
gh repo clone maxschroen/artworker- Create virtual environment
# Navigate to folder
cd artworker
# Install virtualenv
pip install virtualenv
# Initiate venv
python3 -m venv artworker
# Activate venv
source artworker/bin/activate- Install required packages from
requirements.txt
# Install requirements
pip install -r requirements.txtTo run the script, simply navigate to the root of the repository and run:
# Run script
python main.pyThe script will give you prompts to walk you through the process (see below).
Output is generated as a self-contained .svg file, which will be placed in the /out directory.
To generate a print-friendly file, you can use your favorite SVG rendering engine to open the generated .svg file and export as .png.
A simple way to do this from the console is (assuming you have Inkscape installed), would be:
inkscape --export-type="png" YOUR_FILE_NAME.svg- Fix of known issues and limitations
- Introduction of configurable iTunes QR codes & Spotify scan codes to integrate with the layouts
As the script is in a fairly early stage of development, there currently are some known issues and limitations. These are all on the roadmap and will be fixed at some point.
- Albums with more than 16 tracks are currently not supported. All tracks exceeding this limit will be cut off and missing in the generated file.
- Significantly long track titles will overflow to the right / left or collide with other track titles on the same line.