🎵 Music Cover Bot

Telegram бот для добавления обложек, названий и исполнителей к MP3 файлам на основе aiogram.

🚀 Возможности

• Добавление обложки к MP3 файлам
• Установка названия трека
• Установка имени исполнителя
• Автоматическое переименование файла в формате "Исполнитель - Название.mp3"
• Сжатие изображений до оптимального размера
• Встраивание метаданных в ID3v2 теги

📋 Требования

• Python 3.11+
• Telegram Bot Token

🛠 Установка

1. Клонируй репозиторий:

git clone https://github.com/ChaChaCode/Mp3Media.git
cd music-cover-bot

2. Создай виртуальную среду:

python -m venv venv
source venv/bin/activate  # Linux/Mac
# или
venv\Scripts\activate     # Windows

3. Установи зависимости:

pip install -r requirements.txt

4. Создай бота через @BotFather и получи токен

5. Замени YOUR_BOT_TOKEN в коде на свой токен

🎯 Использование

1. Запуск бота:

python main.py

2. В Telegram:
   • Отправь команду /start
   • Загрузи MP3 файл
   • Отправь фотографию для обложки
   • Напиши название трека
   • Напиши имя исполнителя
   • Получи готовый файл с метаданными

📝 Команды

• /start - Начать работу с ботом
• /cancel - Отменить текущую операцию

🔧 Технические детали

Библиотеки

• aiogram - Telegram Bot API
• mutagen - Работа с аудио метаданными
• Pillow - Обработка изображений

ID3 теги

• TIT2 - Название трека
• TPE1 - Исполнитель
• APIC - Обложка альбома

Обработка изображений

• Автоматическое сжатие до 500x500 пикселей
• Конвертация в RGB формат
• Оптимизация качества (90%)

📁 Структура проекта

music-cover-bot/
├── main.py              # Основной файл бота
├── requirements.txt    # Зависимости
├── README.md          # Документация
└── temp_files/        # Временные файлы (создается автоматически)

🔒 Безопасность

• Временные файлы автоматически удаляются после обработки
• Данные пользователей не сохраняются после завершения операции
• Изображения сжимаются для оптимизации размера

🐛 Известные ограничения

• Работает только с MP3 файлами
• Обложка в Telegram может не отображаться сразу (нужно скачать файл или переотправить)
• Максимальный размер файлов ограничен Telegram API

🤝 Вклад в проект

1. Форкни репозиторий
2. Создай feature branch
3. Внеси изменения
4. Создай Pull Request

📄 Лицензия

MIT License - см. LICENSE файл