How bishtvineet/pwa_music_app_backend works
This NestJS backend serves a client-side music archiving workflow: validate a YouTube URL, fetch metadata, then stream transcoded MP3 audio and headers to the client for offline storage. It also supports thumbnail proxying and cookie updates. The graph includes README-documented cover-art muxing, though the sampled audio implementation shows ID3v2.3 tags but not cover-art processing; the JPEG stage is therefore shown as unverified. Relationships reflect sampled calls and explicit README data-flow statements.
Main entry points: converter.controller.ts Converter API · youtube.service.ts Metadata extraction · app.module.ts Application modules · audio.service.ts Audio stream service
Components 16
API and routing
- Converter API
src/modules/converter/converter.controller.ts - URL validation
src/common/pipes/youtube-url.pipe.ts - Application modules
src/app.module.ts
YouTube ingestion
- Metadata extraction
src/modules/youtube/youtube.service.ts - Video metadata DTO
src/modules/youtube/dto/video-info.dto.ts - yt-dlp
Audio processing
- Audio stream service
src/modules/audio/audio.service.ts - FFmpeg transcoder
- JPEG cover-art mux
src/modules/audio - MP3 stream and tags
src/modules/audio/audio.service.ts
Client support
- Cookie update endpoint
src/modules/converter/converter.controller.ts - Runtime cookie files
- Thumbnail proxy
src/modules/converter/converter.controller.ts
Other components
- React PWA
- Thumbnail image host
- IndexedDB storage
Connections 19
- React PWA → Converter API: calls API
README.md - Converter API → URL validation: validates URL
src/modules/converter/converter.controller.ts - Converter API → Metadata extraction: requests metadata
src/modules/converter/converter.controller.ts - Metadata extraction → yt-dlp: extracts metadata
src/modules/youtube/youtube.service.ts - Metadata extraction → Video metadata DTO: returns metadata
src/modules/youtube/youtube.service.ts - Converter API → Audio stream service: starts download
src/modules/converter/converter.controller.ts - Audio stream service → yt-dlp: fetches audio
src/modules/audio/audio.service.ts - yt-dlp → FFmpeg transcoder: pipes audio
- FFmpeg transcoder → MP3 stream and tags: transcodes audio
src/modules/audio/audio.service.ts - MP3 stream and tags → React PWA: streams MP3
README.md - React PWA → IndexedDB storage: stores audio
README.md - Converter API → Cookie update endpoint: accepts cookie updates
src/modules/converter/converter.controller.ts - Cookie update endpoint → Runtime cookie files: writes cookies
src/modules/converter/converter.controller.ts - Thumbnail proxy → Thumbnail image host: fetches image
src/modules/converter/converter.controller.ts - React PWA → Thumbnail proxy: requests thumbnail
- Application modules → Converter API: registers module
src/app.module.ts - Application modules → Metadata extraction: registers module
src/app.module.ts - Application modules → Audio stream service: registers module
src/app.module.ts - JPEG cover-art mux → MP3 stream and tags: embeds artwork
README.md