How morgan-mordata/morsounds-audio-indexer works
This is a command-line audio-analysis and source-separation tool that prepares analysis data for realtime visualization. Users invoke analysis, separation, pipeline, inspection, or conversion commands; the pipeline separates audio and analyzes both the original and separated files. Analysis extracts continuous features and peaks, then writes versioned MessagePack or optional JSON data. Inspection plots saved analyses, and conversion switches formats. The README also describes Unity Timeline readers, but no reader implementation appears in the supplied tree; unsampled subsystems are represented only where the README supports them.
Main entry points: __main__.py Command dispatch · analysis.py Feature analysis · separation.py Source separation · utils.py File and serialization utilities
Components 15
Command entry
- Command dispatch
sonosthesia_audio_pipeline/__main__.py - Combined pipeline
sonosthesia_audio_pipeline/pipeline.py
Audio processing
- Feature analysis
sonosthesia_audio_pipeline/analysis.py - Source separation
sonosthesia_audio_pipeline/separation.py
Analysis files
- File and serialization utilities
sonosthesia_audio_pipeline/utils.py - Versioned analysis files
sonosthesia_audio_pipeline/utils.py - Format conversion
sonosthesia_audio_pipeline/conversion.py - Schema validation
sonosthesia_audio_pipeline/check.py - Output schemas
schemas/schema-version2.json
Inspection and readers
- Analysis inspection
sonosthesia_audio_pipeline/inspection.py - Feature plots
sonosthesia_audio_pipeline/inspection.py - Unity Timeline reader
Other components
- Audio-tool user
- Librosa audio features
- Demucs separation
Connections 22
- Audio-tool user → Command dispatch: invokes commands
README.md - Command dispatch → Feature analysis: dispatches analysis
sonosthesia_audio_pipeline/__main__.py - Command dispatch → Source separation: dispatches separation
sonosthesia_audio_pipeline/__main__.py - Command dispatch → Combined pipeline: dispatches pipeline
sonosthesia_audio_pipeline/__main__.py - Command dispatch → Analysis inspection: dispatches inspection
sonosthesia_audio_pipeline/__main__.py - Command dispatch → Format conversion: dispatches conversion
sonosthesia_audio_pipeline/__main__.py - Combined pipeline → Source separation: calls separation
sonosthesia_audio_pipeline/pipeline.py - Combined pipeline → Feature analysis: calls analysis
sonosthesia_audio_pipeline/pipeline.py - Feature analysis → Librosa audio features: extracts features
sonosthesia_audio_pipeline/analysis.py - Feature analysis → File and serialization utilities: uses file helpers
sonosthesia_audio_pipeline/analysis.py - Feature analysis → Versioned analysis files: writes results
sonosthesia_audio_pipeline/analysis.py - Source separation → Demucs separation: runs separation
sonosthesia_audio_pipeline/separation.py - Source separation → File and serialization utilities: finds input files
sonosthesia_audio_pipeline/separation.py - Source separation → Versioned analysis files: creates separated audio
README.md - Format conversion → File and serialization utilities: reads and writes
sonosthesia_audio_pipeline/conversion.py - Format conversion → Versioned analysis files: converts formats
sonosthesia_audio_pipeline/conversion.py - Analysis inspection → File and serialization utilities: loads analysis data
sonosthesia_audio_pipeline/inspection.py - Analysis inspection → Versioned analysis files: reads analysis
sonosthesia_audio_pipeline/inspection.py - Analysis inspection → Feature plots: plots features
sonosthesia_audio_pipeline/inspection.py - Unity Timeline reader → Versioned analysis files: reads alongside audio
README.md - Schema validation → File and serialization utilities: loads packed data
sonosthesia_audio_pipeline/check.py - Schema validation → Output schemas: validates against
sonosthesia_audio_pipeline/check.py