How itheroken/lunera works
This repository appears to be an Electron music player. Its central workflow is desktop playback: the app coordinates audio extraction and streaming through two engine families, with yt-dlp as a resolution backend. Separate service branches cover playlist transfer and matching, audio scenes, game overlays, and updates. The README is empty, and the excerpts do not show most IPC handlers or UI wiring; dashed links mark likely integration points that cannot be verified from the sampled calls.
Main entry points: main.js Electron app · StreamEngine.js LSE engine · TurboEngine.js LTE engine · audioExtractor.js Audio extraction
Components 27
Desktop app
- Electron app
main.js
Audio playback
- Audio extraction
services/audioExtractor.js - LSE engine
services/lse/core/StreamEngine.js - LSE settings
services/lse/config/defaultSettings.js - Network manager
services/lse/core/NetworkManager.js - Metadata cache
services/lse/cache/MetadataCache.js - Extractor registry
services/lse/extractors/ProviderRegistry.js - Local extractor
services/lse/extractors/LocalExtractor.js - Direct media
services/lse/extractors/DirectMediaExtractor.js - HLS extractor
services/lse/extractors/HLSExtractor.js - DASH extractor
services/lse/extractors/DASHExtractor.js - LTE engine
services/lte/core/TurboEngine.js - Extraction queue
services/lte/extraction/ExtractionQueue.js - Turbo cache
services/lte/extraction/ExtractionCache.js - Format selector
services/lte/extraction/FormatSelector.js - yt-dlp manager
services/lte/extraction/YtDlpManager.js - Stream manager
services/lte/streaming/StreamManager.js - yt-dlp service
services/ytdlpService.js
Music services
- Playlist transfer
services/playlistTransfer.js - Spotify matching
services/spotifyMatch.js - Public collections
services/publicCollection.js - Import dialog
services/importDialog.js
Player features
- Audio scenes
services/audioScene.js - Original scenes
services/originalAudioScene.js - Game overlay
services/gameOverlay.js - App updater
services/appUpdater.js
Other components
- Listener
Connections 28
- Listener → Electron app: uses
- Electron app → Audio extraction: routes playback
main.js - Electron app → LSE engine: integrates
- Electron app → LTE engine: integrates
- Electron app → Playlist transfer: integrates
- Electron app → Public collections: integrates
main.js - Electron app → Game overlay: creates overlay
main.js - Electron app → App updater: starts updater
main.js - Audio extraction → LSE engine: uses
- Audio extraction → LTE engine: uses
- LSE engine → LSE settings: normalizes settings
services/lse/core/StreamEngine.js - LSE engine → Metadata cache: reads and writes
services/lse/core/StreamEngine.js - LSE engine → Network manager: uses network
services/lse/core/StreamEngine.js - LSE engine → Extractor registry: dispatches extractors
services/lse/core/StreamEngine.js - LSE engine → Local extractor: registers extractor
services/lse/core/StreamEngine.js - LSE engine → Direct media: registers extractor
services/lse/core/StreamEngine.js - LSE engine → HLS extractor: registers extractor
services/lse/core/StreamEngine.js - LSE engine → DASH extractor: registers extractor
services/lse/core/StreamEngine.js - LTE engine → Turbo cache: uses cache
services/lte/core/TurboEngine.js - LTE engine → Extraction queue: queues extraction
services/lte/core/TurboEngine.js - LTE engine → Format selector: selects format
services/lte/core/TurboEngine.js - LTE engine → yt-dlp manager: resolves media
services/lte/core/TurboEngine.js - LTE engine → Stream manager: manages streams
services/lte/core/TurboEngine.js - yt-dlp manager → yt-dlp service: delegates resolution
services/lte/extraction/YtDlpManager.js - Playlist transfer → Spotify matching: matches tracks
services/playlistTransfer.js - Electron app → Import dialog: integrates
- Electron app → Audio scenes: integrates
- Electron app → Original scenes: integrates