boostio

This is a music composition program orginally made with the goal to make it easier to make music for the rvasec badge. It's not exactly 1to1 with the audio api on the badge (particularly the noise instrument doesn't translate over).

If you are working on songs for the badge, it may make sense to create your songs in parts and take advantage of the badge music api to arrange the parts.

There's currently no file loading in the app. To create a new file, pass the desired filepath as an argument. e.g.

./boostio ./examples/another_song.json

Features

(some features are based on badge audio requirements)

• 8 voices
• square, sin, saw, triangle, noise instruments
• voice filter
• voice solo/mute
• validation that shows if you're trying to play more than one note in a voice at a time
• bpm control
• scale selection
• scale highlighting
• scale folding
• note preview on selection or placement
• save to json
• export to c (for badge code)
• export to wav
• extendable lua api for plugin support
• undo/redo
• shift+drag copy note

ctr+s will save a json file and export a wav and c file.

Building

Download the git submodules (only necessary on first run):

git submodule update --init --recursive

run cmake:

bash ./run_cmake.sh

build the project:

cd ./buid/Linux/
make

(technically this should be runnable on mac and windows as well, but I haven't done much testing around that)

Plugins

boostio is very plugin driven. by default boostio will look in ~/.local/share/boostio/ for your plugins and ~/.config/boostio for your config file. You can overwrite these directories by setting BOOSTIO_BINARY_DIR and BOOSTIO_CONFIG_DIR. e.g. (if you want to set those directories while dev'ing you could do)

# use whatever path your clone the repo to
export BOOSTIO_CONFIG_DIR=/home/$USER/build/boostio/lua/config
export BOOSTIO_BINARY_DIR=/home/$USER/build/boostio/lua

If you clone this repo and run bash ./scripts/copy_lua.sh it should copy the appropriate files to the appropriate dirs. If you don't have these files in place, you will likely just see a grey window when you run the app.

Writing Plugins

Take a look at ./boostio.lua to see the function signatures of the lua api.

Improvements

There are several areas that could benefit from optimizations...

There's also some good room for adding features via plugins. e.g. it would be cool if you could edit further details about a note (like phase, decay, duty cycle, amplitude, etc...) It would be nice to improve the experience around the noise instrument or bring that in line with what's going on on the badge.

Feel free to noodle around with it and suggest things or contribute.