WereSoCool !Now In Stereo! *

A language for binaural, microtonal composition built in Rust.

Make cool sounds. Impress your friends/pets/plants.

Install

You'll need Rust and Cargo. https://www.rust-lang.org/en-US/install.html

You'll need also need portaudio. https://github.com/RustAudio/rust-portaudio

On Mac brew install portaudio brew install pkg-config && cargo clean if you are having problems linking

Parser

https://github.com/xasopheno/weresocool-parser

Grammar:

https://github.com/xasopheno/weresocool-parser/blob/master/src/socool.lalrpop

Run

Listen to something created with the framework

cargo run --release --bin wsc songs/fall/table.socool

Run with -p flag to print a wav file.

cargo run --release --bin wsc songs/fall/table.socool -p

I use ffmpeg to convert to mp3

ffmpeg -i composition.wav composition.mp3

https://www.ffmpeg.org/

For files in songs/* of type .socool ./play dir/filename ./print dir/filename

Building a binary

To build the binary:

cargo build --release --bin wsc

and then you can parse and play files without having to build the binary each time.

./target/release/wsc songs/fall/table.socool -p

Usage

``` USAGE: wsc [FLAGS] [filename]

FLAGS: -d, --doc Prints some documentation -h, --help Prints help information -j, --json Prints file to .json -p, --print Prints file to .wav -V, --version Prints version information

ARGS: filename eg: my_song.socool ```

Test

To run tests for WSC, Parser, AST, and the end-to-end tests run:

./test.sh

Copyright (C) 2019 - Danny Meyer

This program is free software, licensed under the GPLv3 (see LICENSE).