Banger Link

Your music companion on Telegram 🎵
Features • Installation • Usage • Deployment

💬 What is Banger Link?

Banger Link is a Telegram bot that bridges the gap between different music streaming services. Share a song link from Apple Music or Spotify, and the bot will find the corresponding YouTube video and let you download the audio.

Perfect for group chats where friends use different music platforms!

✨ Features

• 🔄 Convert Apple Music and Spotify links to YouTube
• ⬇️ Download audio directly in your chat
• 👍👎 Like/Dislike tracks to rate the best bangers
• 📊 Track how many times a song has been shared
• 🗂️ Persistent storage of shared songs
• 🚀 Fast and responsive with modern async code
• 🔒 Privacy-focused (no data collection)

🚀 Installation

Prerequisites

• Python 3.8 or higher
• A Telegram bot token
• A YouTube Data API key

Local Installation

1. Clone the repository

   git clone https://github.com/luisg0nc/banger-link.git
   cd banger-link

2. Create and activate a virtual environment

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

3. Install dependencies

   pip install -r requirements.txt

4. Configure environment variables Copy the example environment file and update it with your credentials:

   cp .env.example .env
   # Edit .env with your API keys

🎮 Usage

Running the Bot

python -m banger_link

Bot Commands

Just send a link to a song from Apple Music or Spotify, and the bot will handle the rest!

• Share a music link in any chat where the bot is added
• Use the buttons to like/dislike tracks
• Download the audio with a single click

🐳 Deployment

Docker

1. Build and run with Docker Compose:

   docker-compose up -d --build

2. Or build manually:

   docker build -t banger-link .
   docker run -d --env-file .env banger-link

Hosting

For production deployment, consider using:

• Heroku
• Railway
• PythonAnywhere
• A VPS with Docker

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Credits

• python-telegram-bot - The best Python library for Telegram bots
• pytube - For YouTube video downloads
• TinyDB - For simple JSON-based storage

---

Made with ❤️ by Luis Gonçalves