How m4ndril/ioke works
IOkê is a local-first karaoke application: users add songs, the PC prepares tracks and lyrics, and the player presents a timed sing-along. For parties, phones join a queue and control the TV stage. The graph preserves documented add-on, package, key/MIDI, and cloud-separation capabilities. Several backend and frontend modules were not sampled; those subsystems are represented at their exact tree paths, with relationships included only where supported by the README or excerpts.
Main entry points: library.py Song library and queue · server.py HTTP server · player.js Karaoke player · separador_nuvem.py Cloud separation jobs
Components 23
App and library
- HTTP server
server.py - Song library and queue
karaoke/library.py - App database
karaoke/db.py
Song preparation
- Media and metadata
karaoke/midia.py - Lyrics and alignment
karaoke/aligner.py - Cover artwork
karaoke/artwork.py - Vocal separation
karaoke/separation.py
Playback and party
- Karaoke player
web/js/player.js - Party queue and scoring
karaoke/party.py - TV stage
karaoke/stage.py - Phone accounts
karaoke/accounts.py - Phone interface
web/js/mobile.js - Key and MIDI
karaoke/transpose.py
Extensions and exchange
- Add-on management
karaoke/complementos/__init__.py - Add-on routes
karaoke/complementos/api.py - Karaoke packages
karaoke/pacotes.py
Cloud and settings
- Cloud separation jobs
karaoke/nuvem/separador_nuvem.py - Cloud account and costs
karaoke/nuvem/conta.py - Settings and language
karaoke/config.py
Other components
- PC user
- Phone users
- Local song files
- Modal cloud
Connections 25
- PC user → HTTP server: adds songs
README.md - Local song files → Song library and queue: ingests files
README.md - HTTP server → Song library and queue: queues and manages
server.py - Song library and queue → Media and metadata: prepares media
karaoke/library.py - Song library and queue → Lyrics and alignment: aligns lyrics
karaoke/library.py - Song library and queue → Cover artwork: gets cover
karaoke/library.py - Song library and queue → Vocal separation: separates vocals
karaoke/library.py - Cloud separation jobs → Cloud account and costs: uses credentials
karaoke/nuvem/separador_nuvem.py - Cloud separation jobs → Modal cloud: submits jobs
karaoke/nuvem/separador_nuvem.py - Song library and queue → Cloud separation jobs: uses cloud option
karaoke/library.py - PC user → Karaoke player: selects a song
README.md - Karaoke player → HTTP server: requests song data
web/js/player.js - Karaoke player → Key and MIDI: changes key
README.md - PC user → TV stage: opens TV stage
README.md - Phone users → Phone interface: joins party
README.md - Phone interface → HTTP server: uses phone APIs
- HTTP server → Phone accounts: registers account routes
server.py - HTTP server → Party queue and scoring: serves party actions
server.py - TV stage → Party queue and scoring: shows party state
- PC user → Add-on management: installs add-ons
README.md - HTTP server → Add-on routes: serves add-on routes
server.py - Add-on management → Add-on routes: exposes add-on API
- PC user → Karaoke packages: exchanges packages
README.md - Song library and queue → App database: persists song state
- HTTP server → Settings and language: reads configuration
server.py