How hydrened/heko works
Heko Player is an Electron desktop music player. The renderer workflow initializes the account and opens the playlist manager; playlist actions support managing and ordering playlists, while the current-playlist view represents selected and merged playlists. The renderer API also reaches the remote Heko service, and the main process exposes desktop capabilities through a preload bridge. The graph preserves the visible account, artist, song, playlist, playback, and desktop-API areas. Some main-process wiring and manager behavior are not shown in excerpts, so uncertain relationships are omitted.
Main entry points: app.ts App lifecycle · api.ts Main API · utils.api.ts Renderer API · playlist-manager.events.ts Playlist events
Components 22
Player interface
- Renderer entry
src/ts/renderer/main.ts - App lifecycle
src/ts/renderer/app.ts
Library management
- Account manager
src/ts/renderer/account-manager/account-manager.ts - Playlist manager
src/ts/renderer/playlist-manager/playlist-manager.ts - Playlist events
src/ts/renderer/playlist-manager/playlist-manager.events.ts - Playlist ordering
src/ts/renderer/playlist-manager/playlist-manager.ordering.ts - Current playlist
src/ts/renderer/current-playlist-manager/current-playlist-manager.ts - Current playlist events
src/ts/renderer/current-playlist-manager/current-playlist-manager.events.ts - Song manager
src/ts/renderer/song-manager/song-manager.ts - Artist manager
src/ts/renderer/artist-manager/artist-manager.ts
Desktop integration
- Renderer API
src/ts/renderer/utils/utils.api.ts - Main API
src/ts/main/api/api.ts - File dialogs
src/ts/main/api/api.dialog.ts - File access
src/ts/main/api/api.files.ts - Temporary files
src/ts/main/api/api.temp.ts - Preload bridge
src/ts/main/preload.ts - Desktop window
src/ts/main/window.ts - Main process
src/ts/main/index.ts
Interface presentation
- Player document
src/index.html - Player styles
src/css/main.css
Other components
- Listener
- Heko service
Connections 23
- Listener → Renderer entry: uses
- Renderer entry → App lifecycle: starts
src/ts/renderer/main.ts - App lifecycle → Account manager: initializes
src/ts/renderer/app.ts - App lifecycle → Playlist manager: opens
src/ts/renderer/app.ts - App lifecycle → Song manager: creates
src/ts/renderer/app.ts - App lifecycle → Artist manager: creates
src/ts/renderer/app.ts - App lifecycle → Current playlist: creates
src/ts/renderer/app.ts - App lifecycle → Renderer API: registers lifecycle
src/ts/renderer/app.ts - Playlist manager → Playlist events: uses events
src/ts/renderer/playlist-manager/playlist-manager.ts - Playlist events → Playlist ordering: dispatches input
src/ts/renderer/playlist-manager/playlist-manager.events.ts - Playlist ordering → Renderer API: sets position
src/ts/renderer/playlist-manager/playlist-manager.ordering.ts - Playlist events → Renderer API: updates opened state
src/ts/renderer/playlist-manager/playlist-manager.events.ts - Playlist events → Heko service: requests playlist actions
- Renderer API → Heko service: posts requests
src/ts/renderer/utils/utils.api.ts - Renderer API → Preload bridge: uses desktop bridge
src/ts/renderer/utils/utils.api.ts - Main process → Desktop window: imports
src/ts/main/index.ts - Main process → Main API: imports
src/ts/main/index.ts - Main API → File dialogs: registers
src/ts/main/api/api.ts - Main API → File access: registers
src/ts/main/api/api.ts - Main API → Temporary files: registers
src/ts/main/api/api.ts - Preload bridge → Main API: exposes API
- Renderer entry → Player document: renders in
- Player document → Player styles: uses styles