How shorepine/amy works
AMY is an embeddable fixed-point synthesizer with Python and other bindings. A typical workflow is to send wire messages or events, configure MIDI or synth voices, render audio, and send samples to a host or hardware audio output. The map retains the documented synth families, effects, sequencing, presets, and platform interfaces. Several source files were not sampled, so some subsystem boundaries follow README capabilities; edges are limited to documented or excerpted relationships.
Main entry points: amy.c Synth Engine · amy.h Event and Wire API · __init__.py Python API · pcm.c PCM Sampler
Components 21
Host Interfaces
- Python API
amy/__init__.py - FM Patch Tools
amy/fm.py - Juno Patch Tools
amy/juno.py - Godot Binding
godot/src/amy_gdextension.cpp - Daisy Platform
daisy/amy_daisy.cpp - JavaScript Bridge
src/amy_connector.js
Events and MIDI
- Event and Wire API
src/amy.h - MIDI Handling
src/amy_midi.c - Clock Sequencer
src/sequencer.h
Synthesis Engine
- Synth Engine
src/amy.c - Oscillator Voices
src/oscillators.c - Filters and Effects
src/filters.c - FM Synthesis
src/algorithms.c - Partial Synthesis
src/interp_partials.h - PCM Sampler
src/pcm.c
Audio and Presets
- Patch Presets
src/patches.c - Piano Parameters
amy/piano_params.py - Audio Output
src/pico-audio/audio_i2s.c - Audio Buffers
src/pico-audio/buffer.h - Built-in Samples
src/pcm_samples_gamma808.h
Other components
- Host User
Connections 20
- Host User → Python API: sends commands
README.md - Python API → Event and Wire API: calls native API
amy/__init__.py - FM Patch Tools → Python API: creates patches
amy/fm.py - Juno Patch Tools → Python API: creates patches
amy/juno.py - Godot Binding → Event and Wire API: binds C API
godot/src/amy_gdextension.cpp - Daisy Platform → Event and Wire API: submits events
daisy/amy_daisy.cpp - JavaScript Bridge → Event and Wire API: sends commands
- Event and Wire API → Synth Engine: configures synthesis
README.md - MIDI Handling → Synth Engine: controls voices
README.md - Clock Sequencer → Synth Engine: schedules events
README.md - Synth Engine → Oscillator Voices: renders voices
- Synth Engine → Filters and Effects: applies effects
- Synth Engine → FM Synthesis: renders FM
- Synth Engine → Partial Synthesis: renders partials
- Synth Engine → PCM Sampler: renders samples
- Synth Engine → Patch Presets: uses presets
src/patches.c - Synth Engine → Piano Parameters: supports piano voice
README.md - PCM Sampler → Built-in Samples: reads samples
- Synth Engine → Audio Output: outputs audio
- Audio Output → Audio Buffers: uses buffers
src/pico-audio/audio_i2s.c