Package: bandcrash
BandcrashBandcrash is a standalone program that automatically encodes an album of songs into a bunch of different formats for distribution on various platforms, such asitch.io, or for hosting on your own website.See it in action!FeaturesOutput as mp3, ogg, FLAC, and web preview (HTML5+mp3 at a lower bitrate)Optionally upload everything to your page on itch usingbutlerHigh-quality encoding and metadata, with support for cover songs, per-track artwork, embedded lyrics, and moreWeb player also supports per-track artworkUsagePlease seethe online documentationfor installation and usage instructions.ContributingDevelopment environment notesIf you are developing under Windows, you will probably need to use a POSIX environment under Windows (such asmsysorGit Bash) rather than WSL.If you are developing under macOS, please use auniversal2build of Python (such as the ones installable frompython.org) and you need to ensure that you've created your environment against that (e.g.poetry env use /usr/local/bin/python3.11).RoadmapSee thegithub issuesfor details, but roughly:Local GUI and/or web UI to make setting up thealbum.jsoneasier (and easier installation, especially on Windows!)Various player improvementsEasy embedding into websites (opengraph et al)FAQHow is this different from blamscamp, scritch, etc.?Blamscampandscritchare both great programs for publishing previews of already-encoded on itch.io and other websites! However, their functionality is only to bundle prepared audio files into a web-based player, and they don't presently handle encoding or tagging, two things that are historically tedious and difficult to do well.Bandcrash is a full end-to-end system for preparing an album for both sale and preview online in a variety of formats.What about Faircamp?Faircampdoes handle the end-to-end encoding and processing and builds a quite beautiful static website! If you just want to build a site to host your music and handle your own payments, it's totally usable for that.Bandcrash is for people who want to be able to host their downloads and web-based preview on existing marketplaces such asitch.io,gumroad,ko-fi, etc., or who want to be able to embed their preview on their website under their own terms, rather than being beholden to a specific static site template.What player does Bandcrash use?At present, it defaults to usingCamptown, a player built specifically for Bandcrash. However, I do plan on eventually making it possible to choose from a variety of player engines, including Blamscamp and Scritch.What happened to pyBlamscamp?Back when this project started, it was named pyBlamscamp as the intention was to be basically a Python version of the blamscamp GUI which would also handle encoding steps for you, but it very quickly drifted away from that and became something else.For a while, Bandcrash used a fork of the blamscamp player, but at this point that has been entirely removed.Why make a local GUI instead instead of a web app?You already have your large .wav files on your local hard drive. Your local drive is also a good place to keep your previous encoding results. Your local computer also has a lot more space available than a typical cloud server, doesn't have to juggle cloud storage credentials, doesn't have to worry about the security of the server running the encoder app, the cost of running servers or paying for cloud storage, and so on.Basically, it's easier for everyone.Sometimes local apps are just Better™.That said, Bandcrash is also embeddable as a library, so someone could conceivably build a web-based system that uses it for encoding and tagging files.CreditsMain code:@fluffy-critterOriginal player code and this project's name:@blackle