How ygyg4255-dotcom/music-player works
Player Music is a Windows floating music timer. The user enters a song and duration; the app searches the Music folder first, opens a local match in its default player or falls back to a YouTube result in Brave, then synchronizes a monotonic countdown with the matching Windows media session. The graph also preserves settings, startup opt-in, and the floating interface. Several implementation details are unsampled, so those links rely on README statements; uncertain internal calls are omitted.
Main entry points: app.py App wiring · island.py Floating island · orchestrator.py Playback orchestrator · youtube.py YouTube fallback
Components 19
Floating interface
- Floating island
src/music_player/island.py - App wiring
src/music_player/app.py - Visual theme
src/music_player/theme.py
Song playback
- Playback orchestrator
src/music_player/playback/orchestrator.py - Local song search
src/music_player/local_search.py - Default-app playback
src/music_player/playback/local.py - Playback source interface
src/music_player/playback/base.py - YouTube fallback
src/music_player/youtube.py
Timer and sync
- Countdown timer
src/music_player/timer.py - Media-session control
src/music_player/media_control.py
Preferences and startup
- Settings storage
src/music_player/settings.py - App configuration
src/music_player/config.py - Windows startup opt-in
src/music_player/startup.py
Other components
- User
- Windows default player
- YouTube
- Brave browser
- Windows media sessions
- Windows Run registry
Connections 23
- User → Floating island: enters song and duration
README.md - Floating island → App wiring: requests start
README.md - App wiring → Playback orchestrator: starts search workflow
src/music_player/app.py - Playback orchestrator → Local song search: searches locally
src/music_player/playback/orchestrator.py - Playback orchestrator → Default-app playback: opens local match
README.md - Default-app playback → Windows default player: opens audio file
src/music_player/playback/local.py - App wiring → YouTube fallback: configures fallback
src/music_player/app.py - YouTube fallback → YouTube: fetches search results
README.md - YouTube fallback → Brave browser: opens watch page
README.md - YouTube fallback → Windows default player: uses system browser if needed
README.md - Playback orchestrator → Playback source interface: tracks playback source
src/music_player/playback/orchestrator.py - App wiring → Countdown timer: starts and resumes
src/music_player/app.py - Floating island → Countdown timer: starts countdown
src/music_player/island.py - Countdown timer → App wiring: signals expiry
src/music_player/app.py - App wiring → Media-session control: syncs playback state
src/music_player/app.py - Media-session control → Windows media sessions: monitors and controls
README.md - App wiring → Floating island: updates status
src/music_player/app.py - Floating island → Visual theme: uses styling
src/music_player/island.py - App wiring → Settings storage: loads and saves
src/music_player/app.py - Settings storage → App configuration: gets settings location
src/music_player/settings.py - Floating island → Settings storage: restores saved state
README.md - App wiring → Windows startup opt-in: wires opt-in
src/music_player/app.py - Windows startup opt-in → Windows Run registry: sets Run value
README.md