How tryliner/desktop works
Liner is an Electron desktop music-streaming player. Users authenticate, browse or search the catalog, manage a library, and play tracks with synchronized lyrics and reactive visuals. The graph also captures desktop integrations and supporting services. Several feature implementations were not sampled, so their internal call paths are omitted; README-documented backend behavior is labeled explicitly.
Main entry points: playerEngine.ts Playback coordinator · App.tsx App shell and routes · main.ts Electron main process · api.ts Liner API client
Components 23
App and discovery
- App shell and routes
src/app/App.tsx - Authentication
src/features/auth/ui/LoginPage.tsx - Home recommendations
src/features/home/ui/HomePage.tsx - Catalog search
src/features/search/hooks/useSearchAll.ts - Artist and collection pages
src/features/collection/ui/CollectionPage.tsx - Library and playlists
src/features/library/ui/PlaylistPage.tsx
Playback experience
- Playback coordinator
src/features/player/engine/playerEngine.ts - Audio runtime
src/features/player/engine/playerRuntime.ts - Player controls and views
src/features/player/ui/MiniPlayer.tsx - Synced lyrics
src/features/lyrics/hooks/useLyricsAnimator.ts - Reactive visuals
src/features/player/engine/kawarpEngine.ts - Cover art
src/features/covers/lib/coverArt.ts
Desktop capabilities
- Electron main process
electron/main.ts - Connectivity diagnostics
src/features/connectivity/lib/diagnostics.ts - Overlay player
src/features/overlay/hooks/useOverlaySync.ts - Touch Bar controls
src/features/touchbar/hooks/useTouchBarSync.ts - Application updates
src/features/updater/store/updaterStore.ts
Shared services
- Liner API client
src/shared/api/api.ts - Local media and metadata
src/shared/storage/linerDb.ts - Query cache
src/shared/cache/queryCache.ts - Request and cover signing
electron/crypto.ts - Rust signing core
signer/src/crypto.rs
Other components
- Listener
Connections 29
- Listener → App shell and routes: opens
- App shell and routes → Authentication: routes to
- App shell and routes → Home recommendations: routes to
- App shell and routes → Artist and collection pages: routes to
- App shell and routes → Library and playlists: routes to
- App shell and routes → Player controls and views: routes to
- Listener → Catalog search: searches catalog
- Catalog search → Liner API client: queries
- Library and playlists → Liner API client: loads playlists
- Listener → Player controls and views: controls playback
- Playback coordinator → Audio runtime: commands
src/features/player/engine/playerEngine.ts - Playback coordinator → Liner API client: requests playback data
src/features/player/engine/playerEngine.ts - Playback coordinator → Local media and metadata: reads lyrics cache
src/features/player/engine/playerEngine.ts - Playback coordinator → Synced lyrics: parses lyrics
src/features/player/engine/playerEngine.ts - Playback coordinator → Query cache: checks lyrics cache
src/features/player/engine/playerEngine.ts - Player controls and views → Playback coordinator: delegates playback
- Audio runtime → Listener: streams music
README.md - Liner API client → Listener: provides catalog and lyrics
README.md - Playback coordinator → Reactive visuals: uses audio visuals
- Electron main process → Request and cover signing: invokes signer
electron/main.ts - Request and cover signing → Rust signing core: uses Rust signing core
- Electron main process → Connectivity diagnostics: provides diagnostics
- Electron main process → Overlay player: supports overlay window
- Electron main process → Touch Bar controls: supports Touch Bar
- Electron main process → Application updates: delivers update events
- Listener → Connectivity diagnostics: runs diagnostics
- Listener → Overlay player: uses overlay
- Listener → Touch Bar controls: uses controls
- Cover art → Request and cover signing: signs cover URLs