Something went wrong. Try again.
Monorepo for Aesthetic.Computer aesthetic.computer
Something went wrong. Try again.
JavaScript
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368// menu.mjs — the pop menu. Single declarative registry of every// instrument, fx, percussion voice, bed, vocal pipeline, scale, and form// that lives in /pop. Adding an entry here makes it pickable from the// `pop play` CLI and any future track scaffold.//// Categories:// instruments — tonal voices. signature: mixEventX(ev, out, opts)// where ev = { startSec, midi, durSec, gain }// fx — buffer transforms. signature: applyX(buf, opts)// (mutates buf in place; supports startSec/endSec opts)// percussion — AC percussion kit (one-shot triggers)// beds — continuous textures (still inline per-lane)// master — bus/master chain stages (reverb, sidechain, softclip)// pitch_time — offline pitch/time transforms (autotune, rubberband)// vocal — TTS + alignment + per-word placement pipelines// scales — interval sets keyed by tonic// forms — arrangement templates (trance-bbd, chorale-16, …)// sample_sources — provenance registry: source repos + every sourced// sample committed into a lane (CC0/public-domain only)//// The CLI loader only handles `instruments` + `fx` today; the rest is// here so the menu stays the single source of truth as we wire more.
import { resolve, dirname } from "node:path";import { fileURLToPath } from "node:url";
const HERE = dirname(fileURLToPath(import.meta.url));const POP = resolve(HERE, "..");
export const MENU = { instruments: { supersaw: { file: "dance/synths/supersaw.mjs", export: "mixEventSupersaw", presets: ["lead", "pad", "stab"], lane: "dance", params: ["voices", "detuneCents", "attack", "decay"], blurb: "JP-8000 detuned-saw stack (7 voices)", }, sinepower: { file: "dance/synths/sinepower.mjs", export: "mixEventSinePower", presets: ["lead", "pad", "stab"], lane: "dance", params: ["partials", "attack", "decay"], blurb: "stacked harmonic sines, no aliasing", }, skrill: { file: "dance/synths/skrill.mjs", export: "mixEventSkrill", presets: ["growl", "talk", "reese", "screech", "sub"], lane: "dance", params: ["modRatio", "fmIndex", "vowelA", "vowelB", "lfo", "q", "drive", "crush", "subGain"], blurb: "FM talking-bass w/ swept formants", }, hoover: { file: "hippyhayzard/synths/hoover.mjs", export: "mixEventHoover", presets: ["whoop", "stab", "hazard", "pad"], lane: "hippyhayzard", params: ["voices", "detune", "whoop", "cutoff", "q", "drive", "subGain"], blurb: "Alpha-Juno 'mentasm' w/ pitch whoop", }, zitar: { file: "hippyhayzard/synths/zitar.mjs", export: "mixEventZitar", presets: ["sitar", "lead", "drone", "dry"], lane: "hippyhayzard", params: ["stretch", "damp", "jawari", "taraf", "symGain", "chikari"], blurb: "Karplus-Strong sitar + jawari buzz", }, marimba: { file: "marimba/synths/marimba.mjs", export: "mixEventMarimba", presets: ["rosewood", "kelon", "bass", "staccato", "roll", "xylophone", "vibraphone", "vibraphone_off", "glockenspiel", "gamelan", "woodblock", "kalimba"], lane: "marimba", params: ["partials", "decays", "mallet", "resQ", "resGain", "strike", "tremHz", "decayMul"], blurb: "modal tuned-percussion (marimba/vibes/glock/gamelan)", }, },
fx: { wobble: { file: "dance/synths/fx.mjs", export: "applyWobble", params: ["target", "rate", "depth", "baseCutoffHz", "waveform"], blurb: "LFO on amp or filter (trance/dubstep wub)", }, bitcrush: { file: "dance/synths/fx.mjs", export: "applyBitcrush", params: ["bits", "downsample", "mix"], blurb: "bit-depth + sample-rate reduction", }, flange: { file: "dance/synths/fx.mjs", export: "applyFlange", params: ["rate", "depthMs", "baseDelayMs", "feedback", "mix"], blurb: "LFO-swept delay line w/ feedback", }, ringmod: { file: "dance/synths/fx.mjs", export: "applyRingMod", params: ["freq", "carrier", "waveform", "mix"], blurb: "ring modulation — sine/tri/square or any audio as carrier", }, vocoder: { file: "dance/synths/fx.mjs", export: "applyVocoder", params: ["modulator", "bands", "loFreq", "hiFreq", "q", "attackMs", "releaseMs", "mix"], blurb: "channel vocoder — modulator's spectrum spoken by the carrier", }, },
// ── declared but not yet wired into the play CLI ─────────────────────
percussion: { note: "AC percussion kit — `playPercussion(sound, letter, opts)`. Lives in system/public/aesthetic.computer/lib/percussion.mjs.", voices: ["kick", "snare", "clap", "snap", "hat-c", "hat-o", "ride", "crash", "splash", "cowbell", "block", "tambo"], },
beds: { ocean: { lane: "chillwave", blurb: "pink-noise LP w/ slow 8s wave LFO", inline: "chillwave/bin/render.mjs" }, "noise-sweep": { lane: "chillwave", blurb: "very slow white-noise filter sweep", inline: "chillwave/bin/render.mjs" }, "sacred-drone": { lane: "big-pictures", blurb: "3-voice human-hum drone w/ breath LFO", inline: "big-pictures/bin/sacred-drone.mjs" }, "cool-sine": { lane: "big-pictures", blurb: "sub + pad + sparkle sine layer", inline: "big-pictures/bin/cool-sine-layer.mjs" }, sinebells: { lane: "shared", blurb: "struck bell partials, T60 decay", inline: "bin/melody-bells.mjs" }, },
master: { "stereo-reverb": { lane: "jungle", blurb: "Freeverb-lite (comb + allpass)", inline: "jungle/bin/render.mjs" }, sidechain: { blurb: "kick-triggered duck on sub/pad", inline: "per-lane (implicit envelope gate)" }, softclip: { file: "dance/synths/fx.mjs", export: "softClip", params: ["drive"], blurb: "tanh saturation glue" }, },
pitch_time: { autotune: { file: "bin/autotune.py", blurb: "WORLD f0 snap (note/frame)", params: ["key", "scale", "strength", "preserve", "glide-ms"] }, "score-pitch": { file: "bin/score-pitch.mjs", blurb: "MIDI-driven rubberband pitch shift" }, "score-stretch": { file: "bin/score-stretch.mjs", blurb: "rubberband time-fit (no pitch shift)" }, "pitchsnap-world": { file: "bin/pitchsnap_world.py", blurb: "WORLD pitch correction variant" }, },
analysis: { "envelope-follower": { file: "dance/synths/fx.mjs", export: "envelopeFollower", params: ["attackMs", "releaseMs"], blurb: "amplitude contour → 0..1 control curve (pair: invertControl)", }, "pitch-track": { file: "lib/analysis.mjs", export: "pitchTrack", params: ["fmin", "fmax", "hopMs", "winMs", "clarityGate"], blurb: "audio → per-frame f0 / MIDI pitch curve (autocorrelation)", }, "audio-gate": { file: "lib/analysis.mjs", export: "audioGate", params: ["threshold", "attackMs", "releaseMs", "minGapMs"], blurb: "amplitude onset trigger — beatbox a mic to fire samples", }, "single-study": { file: "study/study.py", params: ["out", "title", "artist"], blurb: "finished single, outside in — master/structure/arrangement/harmony report + figures", }, "study-compare": { file: "study/compare.py", params: ["out"], blurb: "several study reports side by side — timelines, band balance, loudness", }, "study-map": { file: "study/map.py", blurb: "bar-by-bar song map from a study report — chord lane, phrase keys, band heat", }, },
vocal: { "jeffrey-pvc": { file: "bin/say.mjs", blurb: "ElevenLabs jeffrey-pvc TTS (stability ≥ 0.5)", params: ["speed", "style", "stability", "similarity"] }, "score-render": { file: "bin/score-render.mjs", blurb: "per-word vocal placement onto a .np score" }, "mfa-align": { file: "bin/mfa-align.mjs", blurb: "Montreal Forced Aligner word/phoneme timing" }, "sacred-hum": { file: "big-pictures/bin/sacred-drone.mjs", blurb: "3-voice non-vocal human-hum drone" }, },
scales: { minor: [0, 2, 3, 5, 7, 8, 10], major: [0, 2, 4, 5, 7, 9, 11], "minor-pent": [0, 3, 5, 7, 10], "major-pent": [0, 2, 4, 7, 9], dorian: [0, 2, 3, 5, 7, 9, 10], phrygian: [0, 1, 3, 5, 7, 8, 10], chromatic: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], },
forms: { "trance-bbd": { lane: "dance", blurb: "breakdown → build → drop (138 bpm minor)" }, "chorale-16": { lane: "hippyhayzard", blurb: "16-bar Bach chorale, borrowed iv + deceptive cadence" }, "ballad-32": { lane: "hippyhayzard", blurb: "32-bar nightcore-ballad form (~1:28)" }, "williams-aba": { lane: "hellsine", blurb: "ABA' heroic-leitmotif arc, climax key lift" }, "jungle-16": { lane: "jungle", blurb: "16-bar chopped-break (jungletón / raggasol / rodando)" }, "fib-meter": { file: "lib/meter.mjs", export: "fibMeter", blurb: "Fibonacci bar/measure division & addition (fibPartition, fibSequence)" }, "species-counterpoint": { file: "lib/counterpoint.mjs", export: "generateFirstSpecies", blurb: "Fux first-species counterpoint — checker + backtracking generator" }, },
modulation: { "ad-env": { blurb: "linear attack → exponential decay (AC sound.synth contract)" }, "lfo": { blurb: "sine/tri/square · free Hz or beat-synced (1/8, 1/4, 1/8t, 1/8d)" }, "pitch-env": { blurb: "bend-down → spring-up (the hoover 'whoop')", file: "hippyhayzard/synths/hoover.mjs" }, "breakpoint-env": { blurb: "[{time, ...params}] linear-interp ramps; honored by fx + beds", file: "dance/synths/fx.mjs" }, "vibrato": { blurb: "sine pitch mod, rate + depth (cents)" }, },
score: { ".np": { blurb: "notepat — `NOTE:syllable*beats` cells, space-separated; sections via `verse N` / `#`" }, "midi-to-np": { file: "bin/midi_to_np.py", blurb: "MIDI file → .np converter" }, "musicxml-to-np": { file: "bin/musicxml_to_np.py", blurb: "MusicXML → .np converter (preferred for hymn imports)" }, "os-to-np": { file: "bin/os_to_np.py", blurb: "Open Score → .np converter" }, "audio-to-rhythm": { file: "bin/audio-to-rhythm.mjs", blurb: "WAV onsets → quantized drum .np (beatbox a loop)" }, "note-subdiv": { file: "lib/meter.mjs", export: "subdivideNp", blurb: "split .np notes into 1/2·1/4·1/8·1/16 subdivisions" }, ".txt": { blurb: "paired lyric file, one line per .np section" }, },
// ── sourced audio — provenance registry ────────────────────────────── // Every sourced (non-synthesised) sample used in a track is logged // here with its origin + license. Commercial-safe rule (SCORE.md): // CC0 / public-domain / project-owned only — tracks ship to Spotify. // repos — the source data repositories samples are pulled from // used — concrete samples committed into a lane's assets/ sample_sources: { repos: { freesound: { blurb: "Freesound API — CC0-filtered text search + preview download", api: "https://freesound.org/apiv2/", creds: "aesthetic-computer-vault/freesound/credentials.json", filter: 'license:"Creative Commons 0"', }, "archive.org": { blurb: "Internet Archive — CC0 / publicdomain-zero items only", verify: "check each item's licenseurl; 'license: none' ≠ public domain", }, "ac-zoo": { blurb: "project-owned AC zoo sample bank", path: "fedac/native/samples/zoo/", }, }, used: { "imab-real-kick": { lane: "imab", file: "imab/samples/real/kick.wav", source: "freesound #259518 — “kick3” by soneproject", license: "CC0", url: "https://freesound.org/s/259518/", blurb: "house kick — hitbaker real kit (four on the floor)", }, "imab-real-snare": { lane: "imab", file: "imab/samples/real/snare.wav", source: "freesound #695700 — “drumhit_Clap12” by DigitalUnderglow", license: "CC0", url: "https://freesound.org/s/695700/", blurb: "clap-snare backbeat body — hitbaker real kit", }, "imab-real-clap": { lane: "imab", file: "imab/samples/real/clap.wav", source: "freesound #388543 — “Clap 02.wav” by totalcult", license: "CC0", url: "https://freesound.org/s/388543/", blurb: "hand clap layer on 2 & 4 — hitbaker real kit", }, "imab-real-hat-closed": { lane: "imab", file: "imab/samples/real/hat-closed.wav", source: "freesound #513363 — “HH Cl 02.wav” by pomeroyjoshua", license: "CC0", url: "https://freesound.org/s/513363/", blurb: "closed hat eighths — hitbaker real kit", }, "imab-real-hat-open": { lane: "imab", file: "imab/samples/real/hat-open.wav", source: "freesound #842867 — “Hat_Open-03” by crosley_bendix", license: "CC0", url: "https://freesound.org/s/842867/", blurb: "open hat offbeats — hitbaker real kit", }, "imab-real-shaker": { lane: "imab", file: "imab/samples/real/shaker.wav", source: "freesound #607221 — “Shekere Strike.wav” by jonopodmore", license: "CC0", url: "https://freesound.org/s/607221/", blurb: "shekere sixteenths, staged wide — hitbaker real kit", }, "imab-tex-spokes": { lane: "imab", file: "imab/samples/real/spokes.wav", source: "freesound #384187 — “Click Tick.wav” (same source as marimba spoke-click)", license: "CC0", url: "https://freesound.org/s/384187/", blurb: "bike-spoke tick — verse 16ths, orbiting the head", }, "imab-tex-fan": { lane: "imab", file: "imab/samples/real/fan.wav", source: "freesound #867208 — “whirring” by 6James", license: "CC0", url: "https://freesound.org/s/867208/", blurb: "fan whir — sustained bed through break/finale, slow orbit + filter wobble", }, "imab-tex-cards": { lane: "imab", file: "imab/samples/real/cards.wav", source: "freesound #817574 — “shuffle05” by SilverDubloons", license: "CC0", url: "https://freesound.org/s/817574/", blurb: "card riffle — door transitions", }, "imab-tex-material": { lane: "imab", file: "imab/samples/real/material.wav", source: "freesound #641380 — “Clothing Ruffle 03-2.wav” by WhiteFire43", license: "CC0", url: "https://freesound.org/s/641380/", blurb: "cloth ruffle — close verse texture", }, "manhattan-siren": { lane: "marimba", file: "marimba/assets/manhattan-siren.mp3", source: "freesound #223824 — “Wail and Yelp.mp3” by WBJB1", license: "CC0", url: "https://freesound.org/s/223824/", blurb: "NYC police siren (wail + yelp) — chromatic chordal pads", }, "spoke-click": { lane: "marimba", file: "marimba/assets/spoke-click.mp3", source: "freesound #384187 — “Click Tick.wav”", license: "CC0", url: "https://freesound.org/s/384187/", blurb: "single tick — bike-spoke/train-track click percussion, 16th-grid", }, "bluejay-call": { lane: "marimba", file: "marimba/assets/bluejay-call.mp3", source: "freesound #848096 — “Corvids - Blue Jay, Take 2”", license: "CC0", url: "https://freesound.org/s/848096/", blurb: "blue jay call — midpoint perc-drop breakdown", }, "bluejay-warble": { lane: "marimba", file: "marimba/assets/bluejay-warble.mp3", source: "freesound #848094 — “Corvids - Blue Jay, Warble”", license: "CC0", url: "https://freesound.org/s/848094/", blurb: "blue jay warble — midpoint perc-drop breakdown", }, "ac-stamp": { lane: "marimba", file: "marimba/assets/ac-stamp.mp3", source: "AC /api/say — jeffrey-pvc voice, “aesthetic dot computer”", license: "project-owned", url: "", blurb: "spoken aesthetic.computer audio stamp — ducked + crushed at the midpoint", }, "gong": { lane: "marimba", file: "marimba/assets/gong.mp3", source: "freesound #260972 — “Massive Gong.mp3”", license: "CC0", url: "https://freesound.org/s/260972/", blurb: "one huge gong hit — opens the track (pitched down 3 st)", }, "kick-tom": { lane: "marimba", file: "marimba/assets/kick-tom.mp3", source: "freesound #581467 — “Fractanimal Acoustic Drum Kit, Low Tom 1”", license: "CC0", url: "https://freesound.org/s/581467/", blurb: "sampled low tom — the 3/4 beat (replaced the synth kick)", }, "helpabeach-ocean": { lane: "chillwave", file: "chillwave/out/.waves.wav (gitignored)", source: "freesound #352356 — “Gentle small waves lapping on shore.wav” by Alex_hears_things", license: "CC0", url: "https://freesound.org/s/352356/", blurb: "close-mic calm sandy-shore lapping — the helpabeach ocean bed", }, }, },};
async function loadByEntry(entry) { if (!entry?.file || !entry?.export) return null; if (!entry.file.endsWith(".mjs")) return null; const mod = await import(resolve(POP, entry.file)); return mod[entry.export] ?? null;}
export async function loadInstrument(name) { const e = MENU.instruments[name]; if (!e) throw new Error(`unknown instrument: ${name}`); const fn = await loadByEntry(e); if (!fn) throw new Error(`instrument ${name} not loadable from ${e.file}:${e.export}`); return fn;}
export async function loadFx(name) { const e = MENU.fx[name] || MENU.master[name]; if (!e) throw new Error(`unknown fx: ${name}`); const fn = await loadByEntry(e); if (!fn) throw new Error(`fx ${name} not loadable from ${e.file}:${e.export}`); // softClip has signature (buf, drive); wrap to the (buf, opts) contract. if (name === "softclip") return (buf, opts = {}) => fn(buf, opts.drive ?? 1.0); return fn;}