How fluo6/chordpilot works
ChordPilot turns audio into an editable chord chart, then exports the cleaned result. Users can run that workflow in the Electron desktop app or through the LAN web runtime; both rely on a Python analysis/export backend. The graph preserves documented analysis modes, lyrics, audio processing, editing, session storage, and exports. Some internal wiring is based on the README or SOURCE INDEX references rather than complete excerpts, so uncertain connections are omitted or marked dashed.
Main entry points: chordpilot_analysis.py Chart analysis · shell.js Chart workspace · chordpilot_common.py Analysis utilities · app.js API routes
Components 27
Desktop experience
- Electron host
src/main/main.js - Chart workspace
src/renderer/shell.js - Chart editing
src/renderer/bars.js - Audio timeline
src/renderer/timeline.js - Transpose controls
src/renderer/transpose.js - Stem controls
src/renderer/stems.js - Web session bridge
src/renderer/web-bridge.js - Session dialog
src/renderer/web-session-dialog.js
LAN web runtime
- HTTP server
src/web/server.js - API routes
src/web/app.js - Serial work queue
src/web/work-queue.js - Sessions and media
src/web/storage.js
Audio analysis
- Chart analysis
backend/chordpilot_analysis.py - Audio decoding
backend/chordpilot_audio.py - Chord estimation
backend/chordpilot_chords.py - Lyrics reference
backend/chordpilot_lyrics.py - Stem separation
backend/chordpilot_stems.py
Backend services
- Analysis cache
backend/chordpilot_cache.py - Analysis utilities
backend/chordpilot_common.py - Backend commands
backend/chordpilot_cli.py - Chart export
backend/chordpilot_export.py
Shared runtime
- Audio and process services
src/runtime/chordpilot-services.js - Build metadata
src/runtime/build-info.js
Other components
- Desktop user
- LAN browser user
- Python runtime
- Demucs model
Connections 36
- Desktop user → Electron host: opens app
README.md - Electron host → Chart workspace: presents workflow
- Desktop user → Chart workspace: edits chart
README.md - Chart workspace → Chart editing: edits bars
README.md - Chart workspace → Audio timeline: previews audio
README.md - Chart workspace → Transpose controls: changes key
README.md - Chart workspace → Stem controls: selects stem mode
README.md - Chart workspace → Web session bridge: connects sessions
- Web session bridge → Session dialog: opens session dialog
- Electron host → Audio and process services: creates services
src/main/main.js - Audio and process services → Python runtime: runs backend
README.md - Python runtime → Backend commands: runs commands
README.md - Backend commands → Chart analysis: dispatches analysis
backend/chordpilot_cli.py - Backend commands → Chart export: dispatches export
backend/chordpilot_cli.py - Chart analysis → Audio decoding: loads audio
backend/chordpilot_analysis.py - Chart analysis → Chord estimation: estimates chords
backend/chordpilot_analysis.py - Chart analysis → Analysis cache: reads and writes
backend/chordpilot_analysis.py - Chart analysis → Lyrics reference: generates lyrics
backend/chordpilot_analysis.py - Chart analysis → Stem separation: separates stems
backend/chordpilot_analysis.py - Stem separation → Demucs model: runs separation
README.md - Chart analysis → Analysis utilities: uses utilities
backend/chordpilot_analysis.py - Chord estimation → Analysis utilities: uses utilities
backend/chordpilot_chords.py - Audio decoding → Analysis utilities: uses utilities
backend/chordpilot_audio.py - Analysis cache → Analysis utilities: uses utilities
backend/chordpilot_cache.py - Stem separation → Audio decoding: loads audio
backend/chordpilot_stems.py - Stem separation → Analysis cache: uses stem cache
backend/chordpilot_stems.py - Lyrics reference → Analysis utilities: uses utilities
backend/chordpilot_lyrics.py - Chart export → Analysis utilities: uses utilities
backend/chordpilot_export.py - LAN browser user → HTTP server: opens workflow
README.md - HTTP server → API routes: creates API
src/web/server.js - HTTP server → Sessions and media: initializes storage
src/web/server.js - HTTP server → Serial work queue: creates queue
src/web/server.js - API routes → Sessions and media: stores sessions and media
src/web/app.js - API routes → Serial work queue: enqueues work
src/web/app.js - API routes → Audio and process services: processes audio
src/web/app.js - API routes → Build metadata: serves version
src/web/app.js