Files
interpretations/README.md
T
kennethreitz 782cf0075a Reorder album, README tracklist as linked table with tuning
Album arc: opener → cool down → world → energy peak → emotional
heart → exploration → sacred → closing. Track names link to source.
Table shows key, BPM, tuning system, vibe.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 12:51:23 -04:00

102 lines
4.7 KiB
Markdown

```
_ _ _ _ _
(_)_ __ | |_ ___ _ __ _ __ _ __ | |_ __ _| |_(_) ___ _ __ ___
| | '_ \| __/ _ \ '__| '_ \| '__/ _ \ __/ _` | __| |/ _ \| '_ \/ __|
| | | | | || __/ | | |_) | | | __/ || (_| | |_| | (_) | | | \__ \
|_|_| |_|\__\___|_| | .__/|_| \___|\__\__,_|\__|_|\___/|_| |_|___/
|_| ~ written in python ~
```
# Interpretations
An album of compositions written in Python using [pytheory](https://github.com/kennethreitz/pytheory).
Each track is a `.py` file. Run it to hear it.
![](https://kennethreitz.org/static/images/interpretations-player.png)
## Usage
```bash
uv sync
uv run play
```
On first run, you'll be prompted to render all tracks to WAV (parallel, ~3-4 min). After that, playback is instant.
**Interactive player** — animated track picker with album order:
```bash
uv run play # pick from list
uv run play tracks/the_temple.py # play specific track
```
**Picker controls:**
| Key | Action |
|-----|--------|
| `↑`/`↓` | Navigate (wraps around) |
| `Enter` | Play track (from WAV cache if available) |
| `r` | Render selected track to WAV |
| `a` | Play all tracks in album order |
| `R` | Render all tracks (4 parallel workers) |
| `q` | Quit |
**Playback options:**
```bash
uv run play tracks/acid_reign.py --from 17 --to 32 # measure range
uv run play tracks/the_temple.py --from-time 3:30 # seek to time
uv run play tracks/ghost_protocol.py --solo arp,kick # solo parts
uv run play tracks/deep_time.py --mute wind # mute parts
uv run play tracks/the_temple.py --pitch 440 # override tuning
uv run play tracks/acid_reign.py --bpm 160 # override tempo
uv run play tracks/silk_road.py --loop 3 # loop playback
```
**Export & inspect:**
```bash
uv run play tracks/raga_midnight.py -o raga.wav # export WAV
uv run play tracks/the_interruption.py --info # show metadata
uv run play tracks/the_interruption.py --parts # list parts
uv run play --list # list all tracks
```
`Ctrl+C` to stop playback.
See the [changelog](CHANGELOG.md) for detailed track history.
## Tracklist
| # | Track | Key | BPM | Tuning | Vibe |
|---|-------|-----|-----|--------|------|
| 1 | [Raga Midnight](tracks/raga_midnight.py) | D Phrygian | 90 | shruti / just | Sitar raga with 808 drop |
| 2 | [Shruti Lofi](tracks/shruti_lofi.py) | D minor | 75 | shruti / just | Microtonal lo-fi hip hop |
| 3 | [Ghost Protocol](tracks/ghost_protocol.py) | F minor | 128 | equal | Portishead → Strobe |
| 4 | [Silk Road](tracks/silk_road.py) | D minor | 95 | equal | World music caravan |
| 5 | [The Observatory](tracks/the_observatory.py) | G minor | 112 | equal | Chapel through shortwave |
| 6 | [Acid Reign](tracks/acid_reign.py) | A minor | 140 | equal | Dual 303 acid |
| 7 | [Beast Mode](tracks/beast_mode.py) | G minor | 135 | equal | Trap + sitar hook |
| 8 | [Apex](tracks/apex.py) | Eb minor | 140 | equal | Koto hook, wavefold bass |
| 9 | [Voltage](tracks/voltage.py) | F minor | 138 | equal | Raw oscillators |
| 10 | [An Exception Occurred](tracks/an_exception_occurred.py) | Eb major→minor | 80 | equal | Mental health arc |
| 11 | [Voices](tracks/voices.py) | F# minor | 65 | equal | Auditory hallucinations |
| 12 | [Intrusive](tracks/intrusive.py) | Bb minor | 92 | equal | Invasive thoughts |
| 13 | [Gravity](tracks/gravity.py) | C minor | 88 | equal | Hip hop + eastern |
| 14 | [The Interruption](tracks/the_interruption.py) | D minor | 85 | equal | String quartet vs DnB |
| 15 | [Sleight of Hand](tracks/sleight_of_hand.py) | D minor | 100 | equal | Nine genre shifts |
| 16 | [Waveforms](tracks/waveforms.py) | F minor | 118 | equal | Synth showcase |
| 17 | [Emergence](tracks/emergence.py) | E minor | 100 | equal | Acoustic births electronic |
| 18 | [Chakra](tracks/chakra.py) | G→C→E major | 60→135 | shruti / A=432 | Root to crown journey |
| 19 | [The Temple](tracks/the_temple.py) | A Phrygian | 65 | shruti / A=432 | Devotional reverb |
| 20 | [The Dialogue](tracks/the_dialogue.py) | E Phrygian | 75 | shruti / A=432 | Human + machine |
| 21 | [Cathedral](tracks/cathedral.py) | D minor | 60 | equal | Ancient stone |
| 22 | [Tape Memory](tracks/tape_memory.py) | Db minor | 90 | equal | Mellotron + new synths |
| 23 | [Music Box Factory](tracks/music_box_factory.py) | G major | 108 | equal | Tuned percussion only |
| 24 | [Deep Time](tracks/deep_time.py) | B minor | 40 | just | 7.5 min ambient drone |
## License
ISC