📻 Telegram Radio Player V3

---

🎧 What is it?

A modern Telegram bot to stream nonstop Radio, Music, and YouTube Lives directly into Group or Channel Voice Chats.

Live in production at:

• 📡 AsmSafone Channel
• 🎵 AsmSupport Group

---

🚀 Features

• 🎶 Playlist with queuing and 24/7 radio support
• 🔴 YouTube Live stream support
• 🔁 Auto-fallback to radio when playlist ends
• 🔄 Persistent playback even after Heroku restarts
• ⏱️ Show current audio playback position
• 🕹️ Interactive controls via buttons and commands
• ⬇️ Download audio from YouTube
• 🏷️ Dynamic VC title updates with song name
• ⚡ Pre-download next tracks to ensure smooth playback

---

☁ Deploy Instantly

💜 Deploy to Heroku

Note: Set Heroku region to Europe for better stability.

⚡ Deploy to Railway

Ensure a voice chat is started in your group/channel before deploying.

---

🔧 Configuration

Required ENV Vars

API_ID, API_HASH, BOT_TOKEN, SESSION_STRING, CHAT_ID

Optional ENV Vars

LOG_GROUP, AUTH_USERS, STREAM_URL, MAXIMUM_DURATION,
REPLY_MESSAGE, ADMIN_ONLY, HEROKU_API_KEY, HEROKU_APP_NAME

🔗 Live Stream URLs | ⚙️ Generate SESSION_STRING

---

📦 Requirements

• Python >= 3.6
• FFmpeg Installed
• Telegram API + String Session
• User Account as Admin in VC

---

🖥️ Run Locally (VPS)

# Install dependencies
sudo apt install git curl python3-pip ffmpeg -y

# Clone & setup
git clone https://github.com/AsmSafone/RadioPlayerV3
cd RadioPlayerV3
pip3 install -r requirements.txt

# Set .env values
# Run the bot
python3 main.py

---

📄 License

GNU AGPLv3
Copyright (c) 2021  Asm Safone

---

🙌 Credits

• @AsmSafone
• @delivrance - Pyrogram
• @MarshalX - PyTgCalls
• All Contributors

---