search

fluffy-critter / bandcrash

Bandcamp-style batch encoder and web player for independent musicians
MIT License
57 stars 0 forks source link

Liner notes functionality #117

Open fluffy-critter opened 3 months ago

fluffy-critter commented 3 months ago

What is the problem you are trying to solve?

Make it possible to automatically generate PDF-ready liner notes

What solution would you like?

Liner notes build target which will generate an HTML bundle from the lyrics and track information, and which also allows you to insert text fragments like an intro and a preamble, ideally formatted in Markdown.

fluffy-critter commented 3 months ago

Some ideas about how this can work:

The album.json can get a section called "notes" which is a key->value mapping to Markdown files or stringlists, and a slot for a Jinja template (with a reasonable default provided, and examples given in documentation).

At encode time, the metadata gets parsed into a keystore with track info and the "notes" map, with all Markdown and lyrics pre-processed into HTML, and this is passed along to Jinja.

Jinja is also provided with some basic image rendition stuff, so that album and track artwork can be formatted into the resulting output.

At the end, the user has a liner notes directory with index.html and images in it, and then can save to PDF for bundling on Bandcamp/itch/etc.