TeleTuneBot

A Telegram bot for music and audio management, built with Python and Pyrogram.

Prerequisites

• Python 3.11 or higher
• Docker
• MongoDB instance
• Telegram Bot Token
• Spotify API credentials

Environment Variables

Create a .env file based on .example.env

Installation

Using Docker (Recommended)

1. Clone the repository:

git clone https://github.com/sophic00/TeleTuneBot.git
cd TeleTuneBot

2. Create and configure your .env file:

cp .example.env .env
# Edit .env with your credentials

3. Build and run with Docker:

docker build -t teletunebot .
docker run --name bot teletunebot

Manual Installation

1. Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install dependencies:

pip install -r requirements.txt

3. Run the bot:

python -m teletunebot

Development

The project uses:

• uv for dependency management
• Docker for containerization
• MongoDB for data storage
• Pyrogram for Telegram integration

Project Structure

teletunebot/
├── helper/         # Helper functions and utilities
├── plugins/        # Bot command plugins
├── config.py       # Configuration settings
├── __init__.py     # Package initialization
└── __main__.py     # Entry point

Tools and Libraries

• Pyrogram
• MongoDB
• Spotify API
• uv