How umnik1/yaamp works
Yaamp is an Electron desktop player that brings Yandex Music into a Webamp/Winamp interface. The main workflow is: the user chooses music in the player, Electron IPC handlers request tracks from Yandex Music, and the resulting track data is sent to the renderer for playback. The README also documents HTTP remote control, Discord presence, skins, equalizer, Milkdrop visualization, persistence, hotkeys, and platform controls. Some of these subsystems are represented from README documentation because their implementation was not sampled; those relationships are documented rather than inferred from imports.
Main entry points: webamp.bundle.js Webamp UI · music-handlers.js Music handlers · app-handlers.js App handlers · api-server.js HTTP API
Components 22
Desktop shell
- Electron lifecycle
main.js - Main window
src/node/main-window.js - IPC registration
src/node/ipc/index.js - App handlers
src/node/ipc/app-handlers.js - Settings storage
src/node/user-data.js
Music workflow
- Playback state
src/node/playback-state.js - Music handlers
src/node/ipc/music-handlers.js - Yandex Music
Webamp player
- Renderer
src/renderer.ts - Webamp UI
src/webamp/webamp.bundle.js - Audio playback
webamp/packages/webamp/js/media/index.ts - Playlist
webamp/packages/webamp/js/components/PlaylistWindow/TrackList.tsx - Skins and windows
webamp/packages/webamp/js/components/App.tsx - Equalizer
webamp/packages/webamp/js/components/EqualizerWindow/index.tsx - Milkdrop visualizer
webamp/packages/webamp/js/components/MilkdropWindow/index.tsx - Player state
webamp/packages/webamp/js/selectors.ts
Control integrations
- HTTP API
src/node/api-server.js - Discord presence
src/node/discord.js - Remote controller
- Winamp hotkeys
webamp/packages/webamp/js/hotkeys.ts - Touch Bar
src/node/touch-bar.js
Other components
- Listener
Connections 25
- Listener → Webamp UI: controls
- Electron lifecycle → Main window: creates
main.js - Electron lifecycle → HTTP API: starts
main.js - Electron lifecycle → Settings storage: loads settings
main.js - IPC registration → Music handlers: registers
src/node/ipc/index.js - IPC registration → App handlers: registers
src/node/ipc/index.js - Music handlers → Yandex Music: requests tracks
src/node/ipc/music-handlers.js - Music handlers → Playback state: updates
src/node/ipc/music-handlers.js - Music handlers → Main window: sends renderer events
src/node/ipc/music-handlers.js - App handlers → HTTP API: configures
src/node/ipc/app-handlers.js - App handlers → Playback state: reads playback
src/node/ipc/app-handlers.js - Renderer → Webamp UI: loads
src/renderer.ts - Webamp UI → Audio playback: uses playback
- Webamp UI → Playlist: renders
- Webamp UI → Skins and windows: renders
webamp/packages/webamp/js/components/App.tsx - Webamp UI → Equalizer: renders
- Webamp UI → Milkdrop visualizer: renders
- Webamp UI → Player state: selects state
- Webamp UI → Music handlers: invokes music actions
- HTTP API → Main window: controls playback
- Remote controller → HTTP API: sends requests
- Webamp UI → Winamp hotkeys: supports shortcuts
- Webamp UI → Settings storage: persists settings
- Music handlers → Discord presence: updates presence
src/node/ipc/music-handlers.js - App handlers → Touch Bar: controls playback
src/node/ipc/app-handlers.js