A flexible music programming language powered by math.

usage:

blip [play [FILENAME | -c SHEET_MUSIC] [-i EXPR] [-l EXPR] -n NOTE[,...] [-v CHAR=VALUE] | export [FILENAME | -c SHEET_MUSIC] [-i EXPR] [-l EXPR] -n NOTE[,...] [-v CHAR=VALUE] [-f FORMAT] [-o FILENAME] | help [syntax | examples | example <n> | formats]]


modes:
    play - play a song
        FILENAME
            name of the file to use as the sheet music [default: standard in]
        -c SHEET_MUSIC
            sheet music to read instead of reading a file
        -n NOTE[,...], --notes NOTE[,...]
            available notes: a list of comma-separated alphabetical note names
        -i EXPR, --instrument EXPR
            signal expression (instrument) to generate music samples (you can use the floating-point number t for the current time in seconds, n for the indice of the currently playing note in the list of available notes starting with 0 and N for the number of available notes)  [default: "sin(2*pi()*(442+442*((n+1)/N))*t)"]
        -l EXPR, --length EXPR
            expression to generate note length in seconds  [default: "2^(2-log(2, l))*(60/T)"]
        -v VARIABLE=VALUE, --variable VARIABLE=VALUE
            add a variable named VARIABLE (an single letter) for the sheet music and all expressions and set its initial value to VALUE (you can override n, t, l and T which is the only way to set the initial tempo)
        -m NAME:EXPANSION, --macro NAME:EXPANSION
            add a macro named NAME (single character, must not be alphanumeric) which expands to EXPANSION when called in the sheet music
        -s NAME:VARIABLE=EXPR, --slope NAME:VARIABLE=EXPR
            add a slope expression named NAME which replaces the value of VARIABLE with the result of EXPR each frame (EXPR can use all available variables and instrument variables plus the variables α for the initial value of VARIABLE, β for the final value and Δ for the total duration of the specific slope)

    export - export a song to an audio file or stdout
        FILENAME
            name of the file to use as the sheet music [default: standard in]
        -c SHEET_MUSIC
            sheet music to read instead of reading a file
        -n NOTE[,...], --notes NOTE[,...]
            available notes: a list of comma-separated alphabetical note names
        -i EXPR, --instrument EXPR
            signal expression (instrument) to generate music samples (you can use the floating-point number t for the current time in seconds, n for the indice of the currently playing note in the list of available notes starting with 0 and N for the number of available notes)  [default: "sin(2*pi()*(442+442*((n+1)/N))*t)"]
        -l EXPR, --length EXPR
            expression to generate note length in seconds  [default: "2^(2-log(2, l))*(60/T)"]
        -v VARIABLE=VALUE, --variable VARIABLE=VALUE
            add a variable named VARIABLE (an single letter) for the sheet music and all expressions and set its initial value to VALUE (you can override n, t, l and T which is the only way to set the initial tempo)
        -m NAME:EXPANSION, --macro NAME:EXPANSION
            add a macro named NAME (single character, must not be alphanumeric) which expands to EXPANSION when called in the sheet music
        -s NAME:VARIABLE=EXPR, --slope NAME:VARIABLE=EXPR
            add a slope expression named NAME which replaces the value of VARIABLE with the result of EXPR each frame (EXPR can use all available variables and instrument variables plus the variables α for the initial value of VARIABLE, β for the final value and Δ for the total duration of the specific slope)
        -f, --format FORMAT
            audio format to use [default: mp3 or raw if the codec is unavailable]
            see "help formats"
        -o, --output FILENAME
            output file [default: standard out]

    help - help menu
        syntax
            show a help message about expression and sheet music syntax
        examples
            show a list of expression and sheet music examples
        example <n>
            show the nth example from the list provided by --examples
        formats
            show a list of available formats for audio export