● active
$ TIROK Music
A self-hosted music player that turns audio from a Telegram channel into a searchable, streamable library.
A Telegram channel as a music library
TIROK Music uses FastAPI and Telethon to index audio from a public Telegram channel, cache files on disk, and serve them through a browser-based player. Its frontend uses HTML, CSS, and JavaScript without a build step.
Features
- Audio streaming with seeking, cover art, and background track preloading.
- Search, sorting, favorites, shuffle, repeat, and keyboard shortcuts.
- Media Session integration for playback controls outside the page.
- A streaming ZIP endpoint for downloading the library.
- Four visual themes, including terminal and study modes.
Engineering focus
Media delivery, caching, and a responsive playback interface. The service uses a JSON index instead of a database and includes Docker Compose configuration, configurable visitor limits, and bounded concurrent ZIP downloads.