{"id":13989124,"url":"https://github.com/AsmSafone/RadioPlayerV3","last_synced_at":"2025-07-22T10:31:07.405Z","repository":{"id":37945051,"uuid":"394210346","full_name":"AsmSafone/RadioPlayerV3","owner":"AsmSafone","description":"An Advanced Telegram Bot to Play Radio \u0026 Music in Voice Chat.  This is Also The Source Code of The Bot Which is Being Used For Playing Radio in @AsmSafone Channel ❤️  https://radiostay.com - over 100000 online radio stations around the world","archived":false,"fork":false,"pushed_at":"2025-05-03T11:06:33.000Z","size":128,"stargazers_count":487,"open_issues_count":3,"forks_count":883,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-05-23T11:25:47.185Z","etag":null,"topics":["bot","hacktoberfest","hacktoberfest-accepted","music","music-player","music-player-bot","music-player-python","python","radio","radio-player","radioplayer","telegram","telegram-bot","telegram-radio-player","tgvcbot","vc-bot","voice-chat"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AsmSafone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-08-09T08:25:13.000Z","updated_at":"2025-05-13T13:58:40.000Z","dependencies_parsed_at":"2024-01-18T04:09:05.137Z","dependency_job_id":"d32ce527-9be8-45d3-8c84-f87430fc592d","html_url":"https://github.com/AsmSafone/RadioPlayerV3","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AsmSafone/RadioPlayerV3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FRadioPlayerV3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FRadioPlayerV3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FRadioPlayerV3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FRadioPlayerV3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AsmSafone","download_url":"https://codeload.github.com/AsmSafone/RadioPlayerV3/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FRadioPlayerV3/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266475015,"owners_count":23934856,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","hacktoberfest","hacktoberfest-accepted","music","music-player","music-player-bot","music-player-python","python","radio","radio-player","radioplayer","telegram","telegram-bot","telegram-radio-player","tgvcbot","vc-bot","voice-chat"],"created_at":"2024-08-09T13:01:31.915Z","updated_at":"2025-07-22T10:31:07.379Z","avatar_url":"https://github.com/AsmSafone.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# 📻 Telegram Radio Player V3\n\n[![Mentioned in Awesome Telegram Calls](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/tgcalls/awesome-tgcalls)\n[![Stars](https://img.shields.io/github/stars/AsmSafone/RadioPlayerV3?style=flat\\\u0026color=blue)](https://github.com/AsmSafone/RadioPlayerV3/stargazers)\n[![Forks](https://img.shields.io/github/forks/AsmSafone/RadioPlayerV3?style=flat\\\u0026color=green)](https://github.com/AsmSafone/RadioPlayerV3/network/members)\n[![Issues](https://img.shields.io/github/issues/AsmSafone/RadioPlayerV3)](https://github.com/AsmSafone/RadioPlayerV3/issues)\n[![Closed Issues](https://img.shields.io/github/issues-closed/AsmSafone/RadioPlayerV3)](https://github.com/AsmSafone/RadioPlayerV3/issues?q=is%3Aissue+is%3Aclosed)\n[![Pull Requests](https://img.shields.io/github/issues-pr/AsmSafone/RadioPlayerV3)](https://github.com/AsmSafone/RadioPlayerV3/pulls)\n[![Contributors](https://img.shields.io/github/contributors/AsmSafone/RadioPlayerV3?style=flat)](https://github.com/AsmSafone/RadioPlayerV3/graphs/contributors)\n[![Repo Size](https://img.shields.io/github/repo-size/AsmSafone/RadioPlayerV3?color=red)](https://github.com/AsmSafone/RadioPlayerV3)\n[![Commit Activity](https://img.shields.io/github/commit-activity/m/AsmSafone/RadioPlayerV3)](https://github.com/AsmSafone/RadioPlayerV3/commits/main)\n[![License](https://img.shields.io/github/license/AsmSafone/RadioPlayerV3)](LICENSE)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=LightYagami28_RadioPlayerV3\\\u0026metric=security_rating)](https://sonarcloud.io/summary/new_code?id=LightYagami28_RadioPlayerV3)\n[![Updates](https://img.shields.io/badge/Updates-Telegram%20Channel-green)](https://t.me/AsmSafone)\n[![Support](https://img.shields.io/badge/Support-Group-blue)](https://t.me/AsmSupport)\n\n---\n\n## 🎧 What is it?\n\nA modern Telegram bot to stream nonstop Radio, Music, and YouTube Lives directly into Group or Channel Voice Chats.\n\nLive in production at:\n\n* 📡 [AsmSafone Channel](https://t.me/AsmSafone)\n* 🎵 [AsmSupport Group](https://t.me/AsmSupport)\n\n---\n\n## 🚀 Features\n\n* 🎶 Playlist with queuing and 24/7 radio support\n* 🔴 YouTube Live stream support\n* 🔁 Auto-fallback to radio when playlist ends\n* 🔄 Persistent playback even after Heroku restarts\n* ⏱️ Show current audio playback position\n* 🕹️ Interactive controls via buttons and commands\n* ⬇️ Download audio from YouTube\n* 🏷️ Dynamic VC title updates with song name\n* ⚡ Pre-download next tracks to ensure smooth playback\n\n---\n\n## ☁ Deploy Instantly\n\n### 💜 Deploy to Heroku\n\n[![Deploy to Heroku](https://img.shields.io/badge/Deploy%20To%20Heroku-blueviolet?style=for-the-badge\\\u0026logo=heroku)](https://deploy.safone.tech)\n\n\u003e **Note:** Set Heroku region to **Europe** for better stability.\n\n### ⚡ Deploy to Railway\n\n[![Deploy to Railway](https://img.shields.io/badge/Deploy%20To%20Railway-blueviolet?style=for-the-badge\\\u0026logo=railway)](https://railway.app/new/template?template=https%3A%2F%2Fgithub.com%2FAsmSafone%2FRadioPlayerV3\u0026envs=API_ID%2CAPI_HASH%2CBOT_TOKEN%2CSESSION_STRING%2CCHAT_ID%2CLOG_GROUP%2CADMINS%2CADMIN_ONLY%2CMAXIMUM_DURATION%2CSTREAM_URL%2CREPLY_MESSAGE)\n\n\u003e Ensure a voice chat is **started in your group/channel** before deploying.\n\n---\n\n## 🔧 Configuration\n\n### Required ENV Vars\n\n```\nAPI_ID, API_HASH, BOT_TOKEN, SESSION_STRING, CHAT_ID\n```\n\n### Optional ENV Vars\n\n```\nLOG_GROUP, AUTH_USERS, STREAM_URL, MAXIMUM_DURATION,\nREPLY_MESSAGE, ADMIN_ONLY, HEROKU_API_KEY, HEROKU_APP_NAME\n```\n\n\u003e [🔗 Live Stream URLs](https://telegra.ph/Live-Radio-Stream-Links-05-17)  |  [⚙️ Generate SESSION\\_STRING](https://t.me/genStr_robot)\n\n---\n\n## 📦 Requirements\n\n* Python \u003e= 3.6\n* FFmpeg Installed\n* Telegram API + String Session\n* User Account as Admin in VC\n\n---\n\n## 🖥️ Run Locally (VPS)\n\n```bash\n# Install dependencies\nsudo apt install git curl python3-pip ffmpeg -y\n\n# Clone \u0026 setup\ngit clone https://github.com/AsmSafone/RadioPlayerV3\ncd RadioPlayerV3\npip3 install -r requirements.txt\n\n# Set .env values\n# Run the bot\npython3 main.py\n```\n\n---\n\n## 📄 License\n\n```text\nGNU AGPLv3\nCopyright (c) 2021  Asm Safone\n```\n\n---\n\n## 🙌 Credits\n\n* [@AsmSafone](https://github.com/AsmSafone)\n* [@delivrance](https://github.com/delivrance) - Pyrogram\n* [@MarshalX](https://github.com/MarshalX) - PyTgCalls\n* [All Contributors](https://github.com/AsmSafone/RadioPlayerV3/graphs/contributors)\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAsmSafone%2FRadioPlayerV3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAsmSafone%2FRadioPlayerV3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAsmSafone%2FRadioPlayerV3/lists"}