How shynobisuikast/kaaninhos-mp3 works
kaaninho’s mp3 is an Electron desktop music player. The renderer presents playback, search, queue and playlist workflows; it requests YouTube search and stream resolution from the main process, then plays tracks through AudioManager. Local files, playlist importing, mini-player controls, themes, global shortcuts and the basketball mini-game are additional capabilities. Edges follow excerpted calls or README descriptions; unsampled renderer and main-process details limit some connections.
Main entry points: renderer.js Player UI · main.js Electron main · playlistImporter.js Playlist importer · playlist.js Playlist manager
Components 20
Desktop shell
- Electron main
main.js - YouTube search
- Global shortcuts
main.js - Mini-player window
main.js
Playback experience
- Player UI
src/js/renderer.js - Audio engine
src/js/audioManager.js - Playback queue
src/js/renderer.js - Audio effects
src/js/audioManager.js - Themes
src/js/renderer.js
Music library
- Local music
src/js/renderer.js - Cover extraction
main.js - Playlist manager
src/js/playlist.js - Playlist files
src/js/playlist.js - Playlist import UI
src/js/renderer.js - Playlist importer
src/js/playlistImporter.js
Player extras
- Basketball game
src/js/game.js
Other components
- Listener
- yt-dlp streams
- Spotify playlists
- YouTube playlists
Connections 23
- Listener → Player UI: uses
README.md - Player UI → Electron main: requests search
README.md - Electron main → YouTube search: searches tracks
main.js - Player UI → Electron main: requests stream
main.js - Electron main → yt-dlp streams: resolves stream
main.js - Player UI → Audio engine: plays tracks
src/js/renderer.js - Player UI → Playback queue: manages tracks
README.md - Player UI → Local music: selects files
README.md - Player UI → Electron main: requests cover
src/js/renderer.js - Electron main → Cover extraction: extracts artwork
main.js - Player UI → Playlist manager: manages playlists
src/js/renderer.js - Playlist manager → Playlist files: reads and writes
src/js/playlist.js - Player UI → Playlist import UI: imports playlists
README.md - Playlist import UI → Electron main: requests import
main.js - Electron main → Playlist importer: dispatches import
main.js - Playlist importer → Spotify playlists: fetches playlist
src/js/playlistImporter.js - Playlist importer → YouTube playlists: extracts tracks
src/js/playlistImporter.js - Player UI → Global shortcuts: receives controls
README.md - Global shortcuts → Player UI: dispatches keys
main.js - Player UI → Mini-player window: resizes window
main.js - Player UI → Audio effects: sets effects
README.md - Listener → Themes: chooses theme
README.md - Listener → Basketball game: plays mini-game
README.md