README.md

Blob Opera Toolkit

Description

Unofficial toolkit to convert MusicXML files into Blob Opera scores with real lyrics, loosely inspired by OverlappingElvis/blob-opera-midi.

Documentation

• Full command documentation.
• Generated module documentation.

Samples

• Adeste Fideles (source, information)
• Symphony No. 9 (Beethoven) (source, information)
• Ave Maria (Schubert) (source, information)
• O Magnum Mysterium (Brian Schmidt) (contributed sample)
• Ave Verum Corpus (Mozart) (contributed sample)
• Cum Sancto Spiritu - Gloria (Vivaldi) (contributed sample)
• Bohemian Rhapsody (Queen) (contributed sample)

📖  Want to contribute a new sample? Click here!

Usage

1. Create a score file: Use MuseScore or similar to create a four-part score (soprano, alto, tenor and bass) with a single line of lyrics and export it to MusicXML. You can download MusicXML files from MuseScore by using this tool.

2. Install the tool:

   pip install blobopera

3. Convert the score file:

   blobopera recording import input.musicxml output.binary

   (Take a look at the command-line options)

4. Upload the recording:

   blobopera recording upload output.binary

5. Visit the generated link with your browser.

Roadmap

• Publish the package
• Add language-specific phoneme translators
• Improve the phoneme relocation logic
• Write granular unit tests
• Extend the documentation

Contributing

1. Clone this repository:

   $ git clone https://github.com/0x2b3bfa0/python-blobopera
   $ cd python-blobopera

2. Install the dependencies with poetry:

   $ poetry install

3. Run the command-line tool:

   $ poetry run blobopera

4. Run the module tests:

   $ poetry run poe all