{"id":13722002,"url":"https://github.com/thehamkercat/Telegram_VC_Bot","last_synced_at":"2025-05-07T14:31:00.691Z","repository":{"id":41293440,"uuid":"326388546","full_name":"TheHamkerCat/Telegram_VC_Bot","owner":"TheHamkerCat","description":"Telegram Voice Chat Bot Written In Python Using Pytgcalls \u0026 Pyrogram.","archived":true,"fork":false,"pushed_at":"2022-12-04T15:07:14.000Z","size":5741,"stargazers_count":367,"open_issues_count":0,"forks_count":743,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-12T22:36:12.807Z","etag":null,"topics":["bot","heroku","heroku-telegram","jiosaavn","music","pyrogram","pyrogram-bot","pytgcalls","python","song","telegram","telegram-bot","telegram-musicbot","telegram-vcbot","tgcalls","tgvcbot","theme","youtube"],"latest_commit_sha":null,"homepage":"https://t.me/tgvcsupport","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheHamkerCat.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}},"created_at":"2021-01-03T11:14:43.000Z","updated_at":"2025-02-26T11:22:34.000Z","dependencies_parsed_at":"2023-01-23T01:15:09.932Z","dependency_job_id":null,"html_url":"https://github.com/TheHamkerCat/Telegram_VC_Bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHamkerCat%2FTelegram_VC_Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHamkerCat%2FTelegram_VC_Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHamkerCat%2FTelegram_VC_Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHamkerCat%2FTelegram_VC_Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheHamkerCat","download_url":"https://codeload.github.com/TheHamkerCat/Telegram_VC_Bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252895538,"owners_count":21821179,"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":["bot","heroku","heroku-telegram","jiosaavn","music","pyrogram","pyrogram-bot","pytgcalls","python","song","telegram","telegram-bot","telegram-musicbot","telegram-vcbot","tgcalls","tgvcbot","theme","youtube"],"created_at":"2024-08-03T01:01:23.551Z","updated_at":"2025-05-07T14:30:59.496Z","avatar_url":"https://github.com/TheHamkerCat.png","language":"Python","readme":"# Telegram Voice-Chat Bot [PyTGCalls] [![Mentioned in Awesome Telegram Calls](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/tgcalls/awesome-tgcalls)\n\nTelegram Voice-Chat Bot To Play Music With Pytgcalls From Various Sources In Your Group.\n\n\u003cimg src=\"https://dl.hamker.in/files/8sug65vr.png\" width=\"500\" height=\"300\"\u003e\n\n\n## Requirements\n\n### Account requirements\n- A Telegram account to use as the music bot, **You cannot use regular bot accounts, as they cannot join voice chats. *It must be a user account.***\n- API_ID and API_HASH for that account.\n- The account must be an admin of the chat, with _Manage Voice Chats_ and _Delete Messages_ permissions.\n\n### Environment requirements\n- Linux-based OS. **You cannot run this on Windows natively, Use WSL**\n- Python 3.9 or later.\n- ffmpeg package, look below for instructions.\n\n\n## Run (Assuming you have a debian-based distro)\n\n\n\n```sh\n$ git clone https://github.com/thehamkercat/Telegram_VC_Bot\n$ cd Telegram_VC_Bot\n$ sudo apt-get install ffmpeg\n$ pip3 install -U pip\n$ pip3 install -U -r requirements.txt\n$ cp sample_config.py config.py\n```\nEdit **config.py** with your own values.\n\n```sh\n$ python3 main.py\n```\n\n## Heroku\n\nRead this -\u003e https://t.me/TGVCSupport/17542\n\n#### Generate String session [IMPORTANT]\n\nDownload this file [generate_string_session.py](https://raw.githubusercontent.com/thehamkercat/Telegram_VC_Bot/master/generate_string_session.py)\n\n\n```sh\n$ pip3 install pyrogram TgCrypto\n$ python3 generate_string_session.py\n```\nFork this repository and change name of `sample_config.py` to `config.py`\nThen you will need get a session string, copy it, then press heroku deploy button.\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/thehamkercat/Telegram_VC_Bot/tree/master)\n\n\nSend [commands](https://github.com/thehamkercat/Telegram_VC_Bot/blob/master/README.md#commands) to bot to \nplay music.\n\n\n## Docker\n\n```sh\n$ git clone https://github.com/thehamkercat/Telegram_VC_Bot \u0026\u0026 cd Telegram_VC_Bot\n$ cp sample.env .env\n```\nEdit **.env** with your own values.\n\n```sh\n$ sudo docker build . -t tgvc-bot\n$ sudo docker run tgvc-bot\n```\nTo stop use `CTRL+C`\n\n\n## Commands\nCommand | Description\n:--- | :---\n/help | Show Help Message.\n/skip | Skip Any Playing Music.\n/play [SONG_NAME] | To Play A Song Using Saavn.\u003cbr\u003eService used can be changed in config (`DEFAULT_SERVICE`).\n/play youtube/saavn [SONG_NAME] | To Play A Song Using Specific Service.\n/play [with reply to an audio file] | To Play A Song With TG Audio File.\n/queue | Check Queue Status.\n/delqueue | Deletes Queue List and Playlist.\n/playlist [songs name separated by line] | Start Playing Playlist.\n/joinvc | Join Voice Chat.\n/leavevc | Leave Voice Chat.\n/volume [1-200] | Adjust Volume.\n/pause | Pause Music.\n/resume | Resume Music.\n\n\n## Note\n\n1. If you want any help you can ask [here](https://t.me/tgvcsupport)\n\n## Credits\n\n1. [@MarshalX](https://github.com/MarshalX), For [TGCalls](https://github.com/MarshalX/tgcalls)\n2. Thanks to everyone who contributed to the project.\n","funding_links":[],"categories":["Open Source bots"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthehamkercat%2FTelegram_VC_Bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthehamkercat%2FTelegram_VC_Bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthehamkercat%2FTelegram_VC_Bot/lists"}