How imnotshashwat/telegram-music-addon works
Telegram Music Addon is a self-hosted BitChord provider that indexes audio in a private Telegram channel and serves it directly, including range-based playback and WebDAV. The main playback path is BitChord request → track lookup → Telegram-backed audio stream. A separate setup flow authorizes Telegram, selects a channel, and configures network access. Several capabilities are documented but their implementations were not excerpted; those links rely on README evidence, and unsampled details are not inferred.
Main entry points: index.js Track catalog and index · setup-api.js Setup API · setup.js Terminal setup · login.js Telegram login
Components 20
Configuration
- Web setup wizard
public/setup.js - Setup API
setup-api.js - Terminal setup
setup.js - Telegram login
login.js - Runtime configuration
setup-api.js - Setup QR code
setup-api.js
Library and upkeep
- Track catalog and index
index.js - Audio metadata parsing
index.js - Duplicate management
index.js - Chat cleaner
index.js - LRU and preamble cache
index.js
Playback delivery
- Search and ISRC lookup
index.js - Addon manifest
index.js - Range audio streaming
index.js - WebDAV server
index.js
Remote access
- Cloudflare tunnel
tunnel.js
Other components
- Addon operator
- BitChord player
- Telegram MTProto
- Private audio channel
Connections 31
- Addon operator → Web setup wizard: configures
README.md - Web setup wizard → Setup API: calls setup endpoints
public/setup.js - Setup API → Runtime configuration: reads and writes
setup-api.js - Setup API → Telegram MTProto: authorizes and resolves
setup-api.js - Setup API → Cloudflare tunnel: starts tunnel
setup-api.js - Setup API → Setup QR code: generates QR
setup-api.js - Addon operator → Terminal setup: configures
README.md - Terminal setup → Telegram MTProto: logs in and selects channel
setup.js - Terminal setup → Runtime configuration: writes settings
setup.js - Terminal setup → Cloudflare tunnel: starts tunnel
setup.js - Addon operator → Telegram login: authorizes account
login.js - Telegram login → Telegram MTProto: creates session
login.js - Telegram login → Runtime configuration: saves credentials
login.js - Private audio channel → Telegram MTProto: stores audio
README.md - Telegram MTProto → Track catalog and index: provides channel media
README.md - Track catalog and index → Audio metadata parsing: parses track files
README.md - Audio metadata parsing → Track catalog and index: builds search index
README.md - Track catalog and index → Duplicate management: checks duplicates
README.md - Track catalog and index → Chat cleaner: maintains channel
README.md - Track catalog and index → LRU and preamble cache: caches metadata and preambles
index.js - BitChord player → Addon manifest: requests manifest
README.md - BitChord player → Search and ISRC lookup: searches tracks
README.md - Search and ISRC lookup → Track catalog and index: looks up tracks
README.md - BitChord player → Range audio streaming: requests audio ranges
README.md - Range audio streaming → Track catalog and index: resolves track
index.js - Range audio streaming → LRU and preamble cache: reads preamble cache
index.js - Range audio streaming → Telegram MTProto: downloads audio ranges
README.md - BitChord player → WebDAV server: uses WebDAV
README.md - WebDAV server → Track catalog and index: resolves media files
README.md - WebDAV server → Telegram MTProto: streams channel media
README.md - Cloudflare tunnel → BitChord player: exposes HTTPS access
README.md