Skip to content
← all projects
● 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.

View the source.