How fufu-noir/arcod works
ARCOD is a self-hosted Qobuz music search and high-resolution download application. Users search or paste a music link, choose options, then receive a temporary download link; downloads may be processed on the VPS or an optional home worker. The README documents the end-to-end stages and integrations. Source excerpts confirm selected frontend, server, and worker calls; other relationships below rely on README statements, and unsampled internals are represented only where documented.
Main entry points: processor.ts Job processor · index.ts Fastify API · downloads.ts Download API · search-view.tsx Search and results
Components 23
Web experience
- Search and results
app/search-view.tsx - Authentication
components/auth-provider.tsx - Download history
app/history/page.tsx - Admin controls
app/admin/page.tsx
Music catalog
- Catalog API
server/src/routes/catalog.ts - Qobuz client
lib/qobuz-dl.tsx - Server Qobuz client
lib/qobuz-dl-server.tsx
Download processing
- Download API
server/src/routes/downloads.ts - Job processor
server/src/services/processor.ts - Job scheduler
server/src/services/scheduler.ts - Home worker
home-worker/src/index.ts - Worker processing
home-worker/src/processor.ts - Lyrics metadata
home-worker/src/lyrics.ts
Backend platform
- SQLite jobs
server/src/db/client.ts - Fastify API
server/src/index.ts - Admin and security
server/src/routes/admin.ts - Worker API
server/src/routes/workers.ts
External services
- Qobuz service
- Supabase auth
- AWS Lambda proxy
- Cloudflare R2
server/src/storage/r2.ts
Other components
- Music user
- Temporary download
Connections 30
- Music user → Search and results: searches or pastes
- Search and results → Catalog API: requests catalog
- Catalog API → Qobuz service: queries catalog
- Qobuz client → Qobuz service: queries
- Search and results → Qobuz client: uses search
app/search-view.tsx - Music user → Authentication: signs in
components/auth-provider.tsx - Authentication → Supabase auth: authenticates
components/auth-provider.tsx - Search and results → Download API: requests download
- Download API → SQLite jobs: creates job
- Fastify API → Download API: registers routes
server/src/index.ts - Fastify API → Admin and security: registers routes
server/src/index.ts - Fastify API → Worker API: registers routes
server/src/index.ts - Fastify API → Job processor: starts processing
server/src/index.ts - Fastify API → Job scheduler: starts tasks
server/src/index.ts - Job scheduler → SQLite jobs: loads pending jobs
server/src/index.ts - Job processor → SQLite jobs: reads job state
- Job processor → Qobuz service: downloads tracks
- Job processor → AWS Lambda proxy: proxies requests
- Job processor → Lyrics metadata: adds lyrics
- Job processor → Cloudflare R2: uploads result
- Home worker → Worker API: claims and updates
- Home worker → Worker processing: processes jobs
home-worker/src/index.ts - Worker processing → Qobuz service: downloads tracks
- Worker processing → Cloudflare R2: uploads result
- Download API → Job processor: queues job
- Cloudflare R2 → Temporary download: hosts temporary file
- Music user → Temporary download: receives link
- Download history → Download API: manages downloads
app/history/page.tsx - Admin controls → Admin and security: manages jobs
- Admin and security → SQLite jobs: manages routing and blocks