szastupov / musicbot

Telegram Music Catalog Bot

Music Catalog Bot

This Telegram bot maintains a user generated catalog of music.

How does it work? You simply send audio file (from Telegram Desktop, Web or OSX) to the bot and it's added to the public catalog. All tracks are indexed and available for everyone from any Telegram client.

Technical side

The bot doesn't store any media, instead it only keeps track metadata, while the files are hosted on Telegram servers.

It's written in Python 3, powered by aiotg framework and uses MongoDB for index.

You can easily run your own instance with docker-compose:

musicbot:
  image: szastupov/musicbot
  restart: always
  links:
    - mongo
  environment:
    - BOT_NAME=MusicCatalogBot
    - API_TOKEN=Telegram API token
    - BOTAN_TOKEN=Optional botan token
    - MONGO_HOST=mongo
mongo:
  image: mongo
  restart: always

Or directly with docker:

$ docker pull szastupov/musicbot
$ docker run -e "API_TOKEN=YOUR_TOKEN" \
             -e "BOT_NAME=BotPlaygroundBot" \
             -e "MONGO_HOST=mongo" \
             --link mongo:mongo \
             szastupov/musicbot

Or you can run it manually, the requirements are specified in requirements.txt, you know the rest.