How streamish/music-server works
Music Server is a self-hosted, multi-user music backend that indexes audio files and serves library data and playback through its own API and Synology AudioStation/QNAP Music Station compatibility APIs. The principal workflow is configured music folders → scheduled scanning and metadata extraction → indexed library in SQLite → client browsing, retrieval, and streaming. Admin functions manage accounts, root paths, and indexer settings; user APIs expose library and session operations. The graph uses README statements and shown source references; unsampled endpoint wiring and storage behavior are not inferred.
Main entry points: api.module.ts API routing · indexer.service.ts Indexer scheduler · app.module.ts Music server · user.module.ts User library API
Components 20
Server runtime
- Music server
src/app.module.ts - Configuration
src/config/config.service.ts - SQLite database
src/database/database.module.ts
Music indexing
- Indexer scheduler
src/indexer/indexer.service.ts - Album indexing
src/indexer/index-album.service.ts - Association indexing
src/indexer/index-association.service.ts - Track indexing
src/indexer/index-track.service.ts
Library data
- Library queries
src/library/library.service.ts
Standard APIs
- Accounts and sessions
src/database/entities/account.entity.ts - Authentication
src/authentication/authentication.service.ts - API routing
src/api/api.module.ts - User library API
src/api/user/user.module.ts - Admin API
src/api/admin/admin.module.ts - Guest API
src/api/guest/guest.module.ts - Audio streaming
src/api/user/stream-file/stream-file.service.ts
NAS compatibility
- Synology API
src/api/synology-audiostation/synology.module.ts - Synology capabilities
src/api/synology-audiostation/query.service.ts - QNAP API
src/api/qnap-musicstation/qnap.module.ts
Other components
- Music clients
- Music folders
Connections 24
- Music server → API routing: loads routes
src/app.module.ts - Music server → Configuration: loads config
src/app.module.ts - Music server → SQLite database: loads database
src/app.module.ts - Music server → Indexer scheduler: loads indexer
src/app.module.ts - API routing → User library API: registers
src/api/api.module.ts - API routing → Admin API: registers
src/api/api.module.ts - API routing → Guest API: registers
src/api/api.module.ts - API routing → Synology API: registers
src/api/api.module.ts - API routing → QNAP API: registers
src/api/api.module.ts - Music clients → API routing: requests
README.md - Music folders → Indexer scheduler: scans metadata
README.md - Indexer scheduler → Album indexing: delegates
src/indexer/indexer.service.ts - Indexer scheduler → Association indexing: delegates
src/indexer/indexer.service.ts - Indexer scheduler → Track indexing: delegates
src/indexer/indexer.service.ts - Indexer scheduler → SQLite database: stores index
README.md - Library queries → SQLite database: queries entities
src/library/library.service.ts - User library API → Library queries: serves library
- User library API → Authentication: authenticates sessions
- Authentication → Accounts and sessions: reads account data
src/authentication/authentication.service.ts - Synology API → Synology capabilities: queries capabilities
- Music clients → Synology API: uses compatible API
README.md - Music clients → QNAP API: uses compatible API
README.md - User library API → Audio streaming: serves audio
- Music clients → Audio streaming: streams tracks
README.md