README.md

cairo-wave

About

Generate valid WAV files in Cairo

Features

• Output WAV file
• Handle bit-depths (4, 8, 16, 24, 32)
• Handle multiple/stereo channels
• Generate square wave form
• Generate sawtooth wave forms
• Generate triangle wave forms
• Generate sine wave forms
• Generate an instrument (see Koji)
• Play Koji notes
• Play Koji midi tracks
• Generate an 4/8-bit low sample rate sound pack (kick, bass, snare, hi-hat)
• Play short melodies

Local testing:

You need mplayer installed and a test that returns the hex of the WAVE file, see tests

./scripts/play.py _8bits
./scripts/play.py test_name

Sepolia testing

Needs a working starkli configured with a Sepolia RPC

python scripts/get_notes.py
mplayer tmp/out.wav

Resources

• WAVE PCM File format
• Unix: man sox, ffprobe file.wave
• WAV Header
• decode header
• generate 8-bit pytho gist
• https://aminet.net/
• sound pack + player
• gameboy 4-bit depth
• http://www.hydrogen18.com/blog/joys-of-writing-a-wav-file.html