How blacksnowmartin/project-m works
Project-M is a loosely assembled music-creation toolkit centered on extracting a melody from audio, then refining or sequencing musical material. The sampled GUI loads or accepts a dropped audio file, extracts pitches, converts them to MIDI values, plots the pitches, and can save either output. A separate Python sequencer supports grid-based playback and pattern save/load and JSON import/export; the tree also contains a web sequencer and Spleeter materials. These appear as separate capabilities: sampled code does not establish connections between them. Several listed tools are unsampled, so their internal behavior and wiring are omitted.
Main entry points: melody_extractor_gui.py Melody GUI · MSequencer.py Desktop sequencer
Components 11
Melody Extraction
- Melody GUI
melody_extractor_gui.py - Pitch output
melody_extractor_gui.py - MIDI output
melody_extractor_gui.py - Note quantization
quantize.py - Pitch plotting script
Melody.py
Sequencing
- Desktop sequencer
MSequencer.py - Saved patterns
MSequencer.py - Note synthesizer
MSequencer.py - Web sequencer
Music-Grid-Sequencer/index.html
Audio Tools
- Spleeter materials
Spleeter/Spleeter.md
Other components
- Audio creator
Connections 5
- Audio creator → Melody GUI: loads audio
melody_extractor_gui.py - Melody GUI → Pitch output: saves pitches
melody_extractor_gui.py - Melody GUI → MIDI output: saves MIDI
melody_extractor_gui.py - Audio creator → Desktop sequencer: edits patterns
MSequencer.py - Desktop sequencer → Saved patterns: reads and writes
MSequencer.py