How brandon-james-dev/web-media-manager works
Web Media Manager is a browser-based music library manager and player. Its main user flow is to add or scan a music source, browse and edit the resulting library, manage playlists, and play tracks; optional branches include device synchronization and offline caching. The application also provides theme and visualizer extensions, lyrics tools, and background jobs. The graph combines README-documented capabilities with bootstrap and extension-manager relationships visible in excerpts; several domain implementations were not sampled, so their internal call paths are not asserted.
Main entry points: App.tsx App shell · PluginManager.ts Visualizer plugins · BackgroundService.ts Background jobs · ThemeManager.ts Theme management
Components 26
Application
- App shell
src/App.tsx - Shared UI primitives
src/components/ui/button.tsx - Event dispatch
src/events/index.ts - Localization
src/i18n/resources.ts - Notifications UI
src/components/ui/toast.tsx
Library and Sources
- Library browsing
src/core/browsing - Music sources
src/lib/sources - Library scanning
src/core/scanning - Metadata editing
src/core/metadata - Playlists
src/core/playlists - Theme track list
src/components/theme-widgets/library/TrackList/trackColumns.ts
Playback and Lyrics
- Playback engine
src/providers/PlaybackProvider.tsx - Lyrics tools
src/lib/lyrics-providers
Devices and Jobs
- Device synchronization
src/lib/sync - Offline downloads
src/lib/offline - Background jobs
src/lib/background-jobs/BackgroundService.ts - Job events
src/events/background-job-events.ts - Job notifications
src/events/job-notifications.ts
Themes and Extensions
- Theme management
src/core/themes/ThemeManager.ts - Theme hooks
src/hooks/useThemes.ts - Theme store port
src/core/ports/themes.ts - Visualizer plugins
src/core/visualizers/PluginManager.ts - Plugin settings
src/core/visualizers/manifest/settings.ts - Manifest validation
src/core/visualizers/manifest/validateManifest.ts - Package file port
src/core/ports/packageFiles.ts
Other components
- Listener / Manager
Connections 25
- Listener / Manager → App shell: uses
README.md - App shell → Library browsing: browses
README.md - App shell → Music sources: adds source
README.md - Music sources → Library scanning: scans library
README.md - App shell → Metadata editing: edits metadata
README.md - App shell → Playlists: manages playlists
README.md - App shell → Playback engine: provides playback
src/App.tsx - App shell → Device synchronization: provides sync
src/App.tsx - App shell → Theme management: selects theme
src/App.tsx - Library browsing → Theme track list: displays tracks
- Playback engine → Lyrics tools: shows lyrics
- App shell → Offline downloads: caches audio
README.md - Device synchronization → Background jobs: runs sync jobs
README.md - Offline downloads → Background jobs: runs downloads
README.md - Background jobs → Job events: publishes progress
src/lib/background-jobs/BackgroundService.ts - Job events → Job notifications: drives notices
- Job notifications → Notifications UI: shows notices
- App shell → Visualizer plugins: manages plugins
- Visualizer plugins → Plugin settings: uses settings
src/core/visualizers/PluginManager.ts - Visualizer plugins → Manifest validation: validates manifests
src/core/visualizers/PluginManager.ts - Visualizer plugins → Package file port: stores package files
src/core/visualizers/PluginManager.ts - App shell → Theme hooks: loads themes
src/App.tsx - Theme hooks → Theme management: calls manager
src/hooks/useThemes.ts - Theme management → Theme store port: reads and writes
src/core/themes/ThemeManager.ts - App shell → Event dispatch: connects dispatch
src/App.tsx