How acharyasoumya02/telegram-music-addon-main works
This is a self-hosted BitChord music-provider addon: a private Telegram channel is the library, and BitChord resolves tracks through the addon before requesting byte-range audio. The main runtime is concentrated in index.js, which handles channel indexing, metadata, matching, caching, and HTTP endpoints; downloader.js supports channel search and imports from MusicsHunters. The README documents additional deduplication, Atmos detection, and chatter-cleaning capabilities. Excerpts are partial, so some subsystem links are documented rather than verified in source.
Main entry points: index.js HTTP API · downloader.js Channel Search
Components 16
BitChord API
- HTTP API
index.js - Track Search
index.js - ISRC Lookup
index.js - Stream Resolution
index.js
Library and Playback
- Range Audio
index.js - Telegram Library
- Library Index
index.js - Metadata and Atmos
index.js - Preamble Cache
index.js
Channel Tools
- Channel Listener
index.js - Dedup and Cleanup
index.js
Search and Import
- Channel Search
downloader.js - Picker and Download
downloader.js
Other components
- BitChord
- MusicsHunters Bot
- Channel User
Connections 22
- BitChord → HTTP API: requests endpoints
README.md - HTTP API → Track Search: routes search
index.js - HTTP API → ISRC Lookup: routes ISRC
index.js - HTTP API → Stream Resolution: routes stream
index.js - Track Search → Library Index: matches tracks
index.js - Track Search → Preamble Cache: prewarms match
index.js - ISRC Lookup → Library Index: resolves recording
index.js - Stream Resolution → Library Index: finds track
index.js - Stream Resolution → Range Audio: provides audio URL
README.md - Range Audio → Telegram Library: reads byte ranges
README.md - Range Audio → Preamble Cache: serves cached start
index.js - Channel User → Telegram Library: uploads audio
README.md - Telegram Library → Channel Listener: delivers channel events
- Channel Listener → Metadata and Atmos: parses audio
README.md - Metadata and Atmos → Library Index: indexes metadata
README.md - Channel Listener → Dedup and Cleanup: checks duplicates
README.md - Dedup and Cleanup → Telegram Library: deletes duplicates
README.md - Channel User → Channel Search: sends search command
README.md - Channel Search → MusicsHunters Bot: searches bot
downloader.js - Channel Search → Picker and Download: opens picker
downloader.js - Picker and Download → MusicsHunters Bot: requests selected audio
downloader.js - Picker and Download → Telegram Library: forwards audio
downloader.js