your codes should sing for themselves
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
README.md
app.html
index.html
package.json
webpack.config.build.js
webpack.config.js

README.md

code sonata

You created them, you gave them life, you know exactly what they look like. But, have you ever wonder what your codes sound like?

Now it's time to bring them up and sing for you!

How?

By a spells I learned from Fizban...

No, seriously, how?

Each line of code represent a period of time, the whole file can be treat as a music sheet if we transform line content into notes and read the file from top to bottom.

The pipeline is:

[file] --> (composer)
  --> [raw values] --> (instrument)
    --> [notes] --> (sound engine)
      --> [sound]
  • file: the original file
  • raw values: a composer will transfer a file into an array of raw values. Every composer has its own algorithm and recipe, as long as the outputs are integer.
  • notes: instrument will transfers the raw values into an array of frequency and length by the given parameters like root, octave range, bpm and scale.
  • sound: sound engine will play notes via Web Audio API.

Composers

Currently we have two composers in town:

  • simpleComposer: he will transfer codes to notes by this algorithm:

    • one note per line, rest if the current line is blank.
    • value is the length of "dried text", means "non-blank" characters.
    • timing and length depend on amount of "spicer" ({}()[]) appears in the line. if n, note length is n % gridDivision units, start offset is gridDivision - (n % gridDivision) units.
    • indent length decides which octave range the note is in
  • bassComposer: he will transfer codes to notes by this algorithm:

    • value is the length of indent length / 2, if the current line has the same value with previous line, merge them to get a longer note.

Current Config

So with current config, we have a track composed by bass-composer with triangle waveshape oscillator plays on the left side and a track composed by simple-composer with square waveshap oscillator plays on the right side. Finally, a simple reverb is added on mixbus.

Future plan

  • more scales
  • more built-in composers
  • user-defined custom composer
  • able to add/edit/remove tracks, composers and effects
  • navigatable minimap