How steve2312/yuuna-client works
Yuuna is an Electron music player for songs extracted from osu! beatmaps, with Beatconnect-powered in-app search and beatmap downloads. The main workflow is to discover beatmaps, download them, use the local library, and play or preview audio. The renderer is organized around service-backed UI areas; the sampled player service also coordinates media-session and Discord presence integrations. Several feature components and services are listed but unsampled, so their internal call relationships are left unverified rather than inferred.
Main entry points: App.tsx App shell · PlayerService.ts Player service · Outlet.tsx Page outlet · Search.tsx Beatmap search
Components 21
Desktop shell
- Electron main
src/main/index.ts - Renderer entry
src/renderer/main.tsx - App shell
src/renderer/components/App.tsx - Navigation
src/renderer/components/Navigation.tsx - Window chrome
src/renderer/components/Window.tsx - Page outlet
src/renderer/components/Outlet.tsx
Beatmap discovery
- Beatmap search
src/renderer/components/Search.tsx - Search results
src/renderer/components/SearchCard.tsx - Search service
src/renderer/services/SearchService.ts - Beatconnect API
Library and downloads
- Downloads view
src/renderer/components/Downloads.tsx - Download service
src/renderer/services/DownloadService.ts - Song library
src/renderer/components/Library.tsx - Library service
src/renderer/services/LibraryService.ts
Playback and integrations
- Player controls
src/renderer/components/Player.tsx - Player service
src/renderer/services/PlayerService.ts - Preview service
src/renderer/services/PreviewService.ts - Media session
src/renderer/services/MediaSessionService.ts - Discord presence
src/renderer/utils/DiscordRichPresence.ts - Song model
src/renderer/types/Song.ts
Other components
- Listener
Connections 20
- Listener → App shell: uses
- Renderer entry → App shell: renders
src/renderer/main.tsx - App shell → Window chrome: renders
src/renderer/components/App.tsx - App shell → Navigation: renders
src/renderer/components/App.tsx - App shell → Page outlet: renders
src/renderer/components/App.tsx - App shell → Downloads view: renders
src/renderer/components/App.tsx - App shell → Player controls: renders
src/renderer/components/App.tsx - Page outlet → Beatmap search: routes to
- Beatmap search → Search service: queries
- Beatmap search → Search results: shows results
- Search service → Beatconnect API: searches
- Search service → Download service: starts downloads
- Downloads view → Download service: shows status
- Page outlet → Song library: routes to
- Song library → Library service: reads library
- Player controls → Player service: controls
- Player service → Preview service: cancels preview
src/renderer/services/PlayerService.ts - Player service → Media session: updates metadata
src/renderer/services/PlayerService.ts - Player service → Discord presence: updates presence
src/renderer/services/PlayerService.ts - Player service → Song model: uses
src/renderer/services/PlayerService.ts