Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jcppman/code-player

your codes should sing for themselves
https://github.com/jcppman/code-player

computational-art web-app

Last synced: 12 days ago
JSON representation

your codes should sing for themselves

Awesome Lists containing this project

README

        

# 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