How cyttorak-j/oli works
Oli is a local-first music player and library manager, with desktop Windows/macOS and an Android alpha client. The main workflow is browsing or searching local and online music, then playing it or downloading it; library scanning, metadata, saved playback state, and playlists support the local collection. The graph also preserves the documented Internet Archive, YouTube, and Android capabilities. Source detail is uneven: some edges come from README statements or SOURCE INDEX references, so unsampled implementation relationships are not expanded.
Main entry points: ipc.ts IPC handlers · index.ts Electron startup · database.ts Library database · search.ts Search service
Components 24
Desktop experience
- App navigation
src/renderer/src/App.tsx - Search page
src/renderer/src/pages/Search.tsx - Player state
src/renderer/src/store/player.ts - Renderer IPC
src/renderer/src/lib/ipc.ts
Desktop services
- Electron startup
src/main/index.ts - IPC handlers
src/main/ipc.ts - Library scan
src/main/services/library.ts - Search service
src/main/services/search.ts - Online providers
src/main/services/provider.ts - Downloads
src/main/services/downloads.ts - Archive access
src/main/services/archive.ts - YouTube engine
src/main/services/ytdlpEngine.ts - Metadata tools
src/main/services/metadataOps.ts - Playlists
src/main/services/playlists.ts - Playback state
src/main/services/playerState.ts - Library database
src/main/services/database.ts
Android client
- Android activity
android/app/src/main/java/com/cyttos/oli/MainActivity.java - Native audio engine
android/app/src/main/java/com/cyttos/oli/OliAudioEngine.java - Background audio
android/app/src/main/java/com/cyttos/oli/OliAudioService.java - Download service
android/app/src/main/java/com/cyttos/oli/OliDownloadService.java - Resumable downloads
android/app/src/main/java/com/cyttos/oli/DownloadEngine.java
Other components
- Listener
- Local music files
- Online catalogs
Connections 34
- Listener → App navigation: uses
README.md - App navigation → Search page: routes to
src/renderer/src/App.tsx - App navigation → Player state: resumes playback
src/renderer/src/App.tsx - Search page → Renderer IPC: requests results
src/renderer/src/pages/Search.tsx - Player state → Renderer IPC: calls
src/renderer/src/store/player.ts - Renderer IPC → IPC handlers: sends requests
- Electron startup → IPC handlers: registers handlers
src/main/index.ts - Electron startup → Library database: initializes
src/main/index.ts - Electron startup → Search service: constructs
src/main/index.ts - Electron startup → Online providers: constructs
src/main/index.ts - Electron startup → Downloads: constructs
src/main/index.ts - Electron startup → Playlists: constructs
src/main/index.ts - Electron startup → Playback state: constructs
src/main/index.ts - IPC handlers → Library scan: dispatches requests
src/main/ipc.ts - IPC handlers → Search service: dispatches requests
src/main/ipc.ts - IPC handlers → Downloads: dispatches requests
src/main/ipc.ts - IPC handlers → Archive access: dispatches requests
src/main/ipc.ts - IPC handlers → Metadata tools: dispatches requests
src/main/ipc.ts - IPC handlers → Playlists: dispatches requests
src/main/ipc.ts - IPC handlers → Playback state: dispatches requests
src/main/ipc.ts - Search service → Library database: queries
src/main/services/search.ts - Search service → Online providers: searches online
src/main/services/search.ts - Library scan → Local music files: scans
README.md - Archive access → Online catalogs: searches and downloads
README.md - YouTube engine → Online catalogs: enables YouTube
README.md - Downloads → Online catalogs: downloads media
README.md - Android activity → Background audio: starts
android/app/src/main/java/com/cyttos/oli/OliAudioService.java - Background audio → Native audio engine: controls playback
android/app/src/main/java/com/cyttos/oli/OliAudioService.java - Android activity → Download service: starts
android/app/src/main/java/com/cyttos/oli/OliDownloadService.java - Download service → Resumable downloads: delegates downloads
android/app/src/main/java/com/cyttos/oli/OliDownloadService.java - Resumable downloads → Online catalogs: fetches media
- Metadata tools → Library database: updates library
- Playlists → Library database: persists playlists
src/main/services/playlists.ts - Playback state → Library database: persists state
src/main/services/playerState.ts