{"id":15145850,"url":"https://github.com/asmsafone/musicplayer","last_synced_at":"2025-04-13T03:59:57.648Z","repository":{"id":37043016,"uuid":"441152020","full_name":"AsmSafone/MusicPlayer","owner":"AsmSafone","description":"A Telegram Music Bot written in Python using Pyrogram and Py-Tgcalls. This is Also The Source Code of The UserBot Which is Playing Music in @S1-BOTS Support Group ❤️","archived":false,"fork":false,"pushed_at":"2024-12-06T10:58:52.000Z","size":1871,"stargazers_count":320,"open_issues_count":3,"forks_count":1155,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-13T03:59:50.670Z","etag":null,"topics":["hacktoberfest","hacktoberfest-accepted","music","music-player","musicbot","musicplayer","player","playlist","soundcloud","spotify","stream-music","telegram","telegram-bot","vcplayer","videostream","youtube"],"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":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-23T11:00:14.000Z","updated_at":"2025-04-09T00:30:58.000Z","dependencies_parsed_at":"2024-06-20T09:58:18.979Z","dependency_job_id":"d872793f-d568-4fee-be51-c1fbeae9cb0a","html_url":"https://github.com/AsmSafone/MusicPlayer","commit_stats":{"total_commits":30,"total_committers":6,"mean_commits":5.0,"dds":0.6,"last_synced_commit":"c26ffb3bbddea8377ecb14b2acc640e574f582e1"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FMusicPlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FMusicPlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FMusicPlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsmSafone%2FMusicPlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AsmSafone","download_url":"https://codeload.github.com/AsmSafone/MusicPlayer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248661706,"owners_count":21141450,"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","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":["hacktoberfest","hacktoberfest-accepted","music","music-player","musicbot","musicplayer","player","playlist","soundcloud","spotify","stream-music","telegram","telegram-bot","vcplayer","videostream","youtube"],"created_at":"2024-09-26T11:43:14.376Z","updated_at":"2025-04-13T03:59:57.604Z","avatar_url":"https://github.com/AsmSafone.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align= center\u003e\u003cb\u003e⭐️ Music Player ⭐️\u003c/b\u003e\u003c/h1\u003e\n\u003ch3 align = center\u003e A Telegram Music Bot written in Python using Pyrogram and Py-Tgcalls \u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://python.org\"\u003e\u003cimg src=\"http://forthebadge.com/images/badges/made-with-python.svg\" alt=\"made-with-python\"\u003e\u003c/a\u003e\n\u003cbr\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/contributors/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"Contributors\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/repo-size/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"Repository Size\"\u003e \u003cbr\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"Forks\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"Stars\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/watchers/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"Watchers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/commit-activity/w/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"Commit Activity\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/AsmSafone/MusicPlayer?style=for-the-badge\" alt=\"Issues\"\u003e\n\u003c/p\u003e\n\n## ✨ \u003ca name=\"features\"\u003e\u003c/a\u003eFeatures\n\n### ⚡️ Fast \u0026 Light\n\nStarts streaming your inputs while downloading and converting them. Also, it\ndoesn't make produce files.\n\n### 👮🏻‍♀️ Safe and handy\n\nRestricts control and sensitive commands to admins.\n\n### 🗑 Clean and spam free\n\nDeletes old playing trash to keep your chats clean.\n\n### 😎 Has cool controls\n\nLets you switch stream mode, loop, pause, resume, mute, unmute anytime.\n\n### 🖼 Has cool thumbnails\n\nResponse your commands with cool thumbnails on the chat.\n\n### 😉 Streams whatever you like\n\nYou can stream audio or video files, YouTube videos with any duration,\nYouTube lives, YouTube playlists and even custom live streams like radios or m3u8 links or files in\nthe place it is hosted!\n\n### 📊 Streams in multiple places\n\nAllows you to stream different things in multiple chats simultaneously. Each\nchat will have its own song queue.\n\n### 🗣 Speaks different languages\n\nMusic Player is multilingual and speaks [various languages](#languages),\nthanks to the translators.\n\n## 🚀 \u003ca name=\"deploy\"\u003e\u003c/a\u003eDeploy\n\n[![Deploy on Heroku](https://www.herokucdn.com/deploy/button.svg)](https://deploy.safone.dev)\n\nNote: `First Fork The Repo Then Click On Deploy To Heroku Button!`\n\n\n## ☁️ \u003ca name=\"self_host\"\u003e\u003c/a\u003eSelf Host\n\n- Legecy Method\n```bash\n$ git clone https://github.com/AsmSafone/MusicPlayer\n$ cd MusicPlayer\n$ sudo apt install git curl python3-pip ffmpeg -y\n$ pip3 install -U pip\n$ pip3 install -U -r requirements.txt\n$ cp sample.env .env\n# \u003c edit .env with your own values \u003e\n$ python3 main.py\n```\nOr you can use this One-Liner to save your time :\n\n```\ngit clone https://github.com/AsmSafone/MusicPlayer \u0026\u0026 cd MusicPlayer \u0026\u0026 sudo apt install git curl python3-pip ffmpeg -y \u0026\u0026 pip3 install -U pip \u0026\u0026 pip3 install -U -r requirements.txt\n```\nMake sure to edit the .env file accordingly,\n```\ncp sample.env .env\n```\nRun it using,\n```\npython3 main.py\n```\n\n- Docker Build Method\n```bash\n$ git clone https://github.com/AsmSafone/MusicPlayer\n$ cd MusicPlayer\n$ cp sample.env .env\n# \u003c edit .env with your own values \u003e\n$ sudo docker build . -t musicplayer\n$ sudo docker run musicplayer\n```\n\n## ⚒ \u003ca name=\"configs\"\u003e\u003c/a\u003eConfigs\n\n- `API_ID`: Telegram app id from https://my.telegram.org/apps.\n- `API_HASH`: Telegram app hash from https://my.telegram.org/apps.\n- `SESSION`: Pyrogram string session. You can generate from [here](https://replit.com/@AsmSafone/genStr).\n- `SUDOERS`: ID of sudo users (separate multiple ids with space).\n- `BOT_TOKEN`: Telegram bot token from https://t.me/botfather. (optional)\n- `QUALITY`: Custom stream quality (high/medium/low) for the userbot in vc. Default: `high`\n- `PREFIX`: Bot commad prefixes (separate multiple prefix with space). Eg: `! /`\n- `LANGUAGE`: An [available](#languages) bot language (can change it anytime). Default: `en`\n- `STREAM_MODE`: An stream mode like audio or video (can change it anytime). Default: `audio`\n- `ADMINS_ONLY`: Put `True` if you want to make /play commands only for admins. Default: `False`\n- `SPOTIFY_CLIENT_ID`: Spotify client id get it from [here](https://developer.spotify.com/dashboard/applications). (optional)\n- `SPOTIFY_CLIENT_SECRET`: Spotify client secret get it from [here](https://developer.spotify.com/dashboard/applications). (optional)\n\n\n## 📄 \u003ca name=\"commands\"\u003e\u003c/a\u003eCommands\n\nCommand | Description\n:--- | :---\n• !ping | Check if alive or not\n• !start / !help | Show the help for commands\n• !mode / !switch | Switch the stream mode (audio/video)\n• !p / !play [song name or youtube link] | Play a song in vc, if already playing add to queue\n• !radio / !stream [radio url or stream link] | Play a live stream in vc, if already playing add to queue\n• !pl / !playlist [playlist link] | Play the whole youtube playlist at once\n• !skip / !next | Skip to the next song\n• !m / !mute | Mute the current stream\n• !um / !unmute | Unmute the muted stream\n• !ps / !pause | Pause the current stream\n• !rs / !resume | Resume the paused stream\n• !list / !queue | Show the songs in the queue\n• !mix / !shuffle | Shuflle the queued playlist\n• !loop / !repeat | Enable or disable the loop mode\n• !lang / language [language code] | Set the bot language in group\n• !ip / !import | Import queue from exported file\n• !ep / !export | Export the queue for import in future\n• !stop / !leave | Leave from vc and clear the queue\n• !update / !restart | Update and restart your music player\n\n## 🗣 \u003ca name=\"languages\"\u003e\u003c/a\u003eLanguages\n\n```text\nar    Arabic\nbn    Bengali\ncn    Chinese\nde    German\nen    English\nfr    French\nhi    Hindi\nja    Japanese\nnl    Dutch\nru    Russian\nte    Telegu\ntr    Turkish\n```\n\n## 💜 \u003ca name=\"contribute\"\u003e\u003c/a\u003eContribute\n\nNew languages, bug fixes and improvements following\n[our contribution guidelines](./CONTRIBUTING.md) are warmly welcomed!\n\n## 🛫 \u003ca name=\"supports\"\u003e\u003c/a\u003eSupports\n\nFor any kind of help join [our support group](https://t.me/AsmSupport) or raise an [issue](https://github.com/AsmSafone/MusicPlayer/issues).\n\n## ✨ \u003ca name=\"credits\"\u003e\u003c/a\u003eCredits\n\n- [Me](https://github.com/AsmSafone) for [Noting](https://github.com/AsmSafone/MusicPlayer) 😬\n- [Dan](https://github.com/delivrance) for [Pyrogram](https://github.com/pyrogram/pyrogram) ❤️\n- [Laky-64](https://github.com/Laky-64) for [Py-TgCalls](https://github.com/pytgcalls/pytgcalls) ❤️\n- And Thanks To All [Contributors](https://github.com/AsmSafone/MusicPlayer/graphs/contributors)! ❤️\n\n## 📃 \u003ca name=\"license\"\u003e\u003c/a\u003eLicense\n\nMusic Player is licenced under the GNU Affero General Public License v3.0.\nRead more [here](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasmsafone%2Fmusicplayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasmsafone%2Fmusicplayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasmsafone%2Fmusicplayer/lists"}