How thirteen-labs/deep-player works
Deep Player is a local-first media player: users scan device media into a local library, browse music and video collections, then play, organize, and cache items for offline use. The app’s Expo Router screens invoke library and playback services; SQLite and Zustand hold library and player state. README documents playlists, favorites, history, queue controls, video playback, permissions, and offline caching. Some subsystem paths are directories because their individual implementation files were not sampled; their links are documented capabilities, not inspected calls.
Main entry points: music.tsx Music browsing · app App routes · store.ts Library operations · player-store.ts Player state and queue
Components 21
App experience
- App routes
src/app - Music browsing
src/app/music.tsx - Video browsing
src/app/videos - Artist and album views
src/app/artists - Folders and home
src/app/folders.tsx - User settings
src/app/user.tsx - Track rows
src/components/ui/track-row.tsx
Library and organization
- Library scanner
src/lib/library/scan.ts - Metadata reader
src/lib/metadata.ts - Library operations
src/lib/db/store.ts - SQLite database
src/lib/db/schema.ts - Track sorting
src/utils/track-sorting.ts - Playlists and favorites
src/lib/db/store.ts - Offline cache
src/lib/library/cache.ts
Playback
- Now playing controls
src/components/ui/now-playing-card.tsx - Player state and queue
src/stores/player-store.ts - Audio engine
src/lib/audio/player.ts - Video playback
src/app/videos
Local services and settings
- Media permissions
src/lib/permissions.ts - Themes
src/constants/theme.ts
Other components
- Listener
Connections 27
- Listener → App routes: uses
README.md - App routes → Music browsing: routes to
README.md - App routes → Video browsing: routes to
README.md - App routes → Artist and album views: routes to
README.md - App routes → Folders and home: routes to
README.md - App routes → User settings: routes to
README.md - Music browsing → Library scanner: scans library
src/app/music.tsx - Music browsing → Metadata reader: reads tags
src/app/music.tsx - Music browsing → Library operations: browses tracks
src/app/music.tsx - Artist and album views → Library operations: browses tracks
src/app/artists/[name].tsx - Video browsing → Library operations: browses videos
src/app/videos/index.tsx - Library scanner → SQLite database: imports assets
README.md - Library operations → SQLite database: reads and writes
src/lib/db/store.ts - Playlists and favorites → SQLite database: persists collections
README.md - Music browsing → Playlists and favorites: manages tracks
README.md - Music browsing → Track sorting: sorts tracks
src/app/music.tsx - Music browsing → Track rows: renders tracks
src/app/music.tsx - Track rows → Player state and queue: offers playback actions
- Now playing controls → Player state and queue: controls
src/components/ui/now-playing-card.tsx - Player state and queue → Audio engine: controls audio
src/stores/player-store.ts - Player state and queue → Library operations: persists playback
src/stores/player-store.ts - Player state and queue → Playlists and favorites: updates queue
README.md - Video browsing → Video playback: plays videos
README.md - Music browsing → Offline cache: warms offline cache
- Offline cache → Library operations: stores local URIs
src/lib/library/cache.ts - User settings → Media permissions: manages access
README.md - User settings → Themes: selects theme
README.md