bcao/README.md

1.3 KiB

bcao

bandcamp album organiser - a python script to organise, rename, and apply cover art to zip files downloaded from bandcamp.

usage

./bcao.py [zip file] [options]

see the help menu (--help) for more.

installing

the astoundingly easy way

requires pipx. this will install and run bcao from a temporary location.

pipx run --spec git+https://git.bune.city/lynnesbian/bcao bcao [album name.zip]

the very easy way

download bcao.pex and run it:

python bcao.pex [album name.zip]

a pex file is a zip that contains everything needed for a python program to run, including its dependencies.

the pretty easy way

requires poetry. installs the package into a virtual environment in the current directory.

git clone https://git.bune.city/lynnesbian/bcao
cd bcao
poetry install
poetry run bcao [album name.zip]

the other way

you don't have to create a virtualenv, but, y'know, you should and all

git clone https://git.bune.city/lynnesbian/bcao
cd bcao
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
python -m bcao [album name.zip]

building it yourself

see build.sh