Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/callsmusic/tgvc-userbot
Telegram voice chat userbot made with Pyrogram and MarshalX/tgcalls with playlist support
https://github.com/callsmusic/tgvc-userbot
calls group-chat music-player-bot pyrogram pytgcalls python telegram telegram-userbot telegram-voice-chat tgcalls voice-chat voice-chats voip
Last synced: 2 months ago
JSON representation
Telegram voice chat userbot made with Pyrogram and MarshalX/tgcalls with playlist support
- Host: GitHub
- URL: https://github.com/callsmusic/tgvc-userbot
- Owner: callsmusic
- License: agpl-3.0
- Archived: true
- Created: 2021-03-02T02:43:18.000Z (almost 4 years ago)
- Default Branch: dev
- Last Pushed: 2022-01-28T12:30:52.000Z (almost 3 years ago)
- Last Synced: 2024-08-04T01:16:05.630Z (6 months ago)
- Topics: calls, group-chat, music-player-bot, pyrogram, pytgcalls, python, telegram, telegram-userbot, telegram-voice-chat, tgcalls, voice-chat, voice-chats, voip
- Language: Python
- Homepage: https://t.me/VCSets
- Size: 123 KB
- Stars: 162
- Watchers: 8
- Forks: 337
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Telegram Voice Chat UserBot [](https://github.com/tgcalls/awesome-tgcalls)
A Telegram UserBot to Play Audio in Voice Chats.
This is also the source code of the userbot which is being used for playing
DJ/Live Sets music in [VC DJ/Live Sets](https://t.me/VCSets) group.
Made with [tgcalls](https://github.com/MarshalX/tgcalls)
and [Pyrogram Smart Plugin](https://docs.pyrogram.org/topics/smart-plugins)
It's recommended to use [tgmusicbot](https://github.com/callsmusic/tgmusicbot)
along with this userbot.
## Introduction
**Features**
- Playlist, queue
- Loop one track when there is only one track in the playlist
- Automatically downloads audio for the first two tracks in the playlist to
ensure smooth playing
- Automatically pin the current playing track
- Show current playing position of the audio
**Plugin**: vc.`player`
Commands only works in groups, userbot account itself and contacts can use any
commands, all members can use common commands after the userbot join the VC
1. Start the userbot, try `!ping`, `!uptime` or `!sysinfo` command to check if
the bot was running
2. send `!join` to a voice chat enabled group chat from userbot account itself
or its contacts, be sure to make the userbot account as group admin and give
it at least the following permissions:
- Delete messages
- Manage voice chats (optional)
3. reply to an audio with `/play` to start playing it in the voice chat, every
member of the group can use common commands such like `/play`, `/current`
and `!help` now.
4. check `!help` for more commands
**Plugin**: vc.`channel`
Almost same as `player` plugin but commands only works in Saved Messages,
`!join` takes arguments to be able to join group or channel voice chats.
**Plugin**: `ping` and `sysinfo`
Commands only works for userbot account itself and its contacts.
## Requirements
- Python 3.6 or higher
- A
[Telegram API key](https://docs.pyrogram.org/intro/quickstart#enjoy-the-api)
and a Telegram account
- Choose plugins you need, install dependencies which listed above and run
`pip install -U -r requirements.txt` to install Python package dependencies
as well
- [FFmpeg](https://www.ffmpeg.org/)
## Run
Choose one of the two methods and run the userbot with
`python userbot.py`, stop with CTRL+c. The following example assume
that you were going to use `vc.player` and `ping` plugin, replace
`api_id`, `api_hash` to your own value.
### Method 1: use config.ini
Create a `config.ini` file
```
[pyrogram]
api_id = 1234567
api_hash = 0123456789abcdef0123456789abcdef
[plugins]
root = plugins
include =
vc.player
ping
sysinfo
```
### Method 2: write your own userbot.py
Replace the file content of `userbot.py`
```
from pyrogram import Client, idle
api_id = 1234567
api_hash = "0123456789abcdef0123456789abcdef"
plugins = dict(
root="plugins",
include=[
"vc.player",
"ping",
"sysinfo"
]
)
app = Client("tgvc", api_id, api_hash, plugins=plugins)
app.start()
print('>>> USERBOT STARTED')
idle()
app.stop()
print('\n>>> USERBOT STOPPED')
```
## Notes
- Read module docstrings of [plugins/](plugins) you are going to use at the
beginning of the file for extra notes
## Self-hosting
This userbot should run fine on any cloud server. Popular choices of cloud
server providers are DigitalOcean, Vultr and Hetzner. You can use one of the
following referral links to sign up on Vultr to give the project author
credits in case you want to try Vultr.
Or [Give100get25 - Vultr](https://www.vultr.com/?ref=8559837-6G)
# License
AGPL-3.0-or-later
```
tgvc-userbot, Telegram Voice Chat Userbot
Copyright (C) 2021 Dash Eclipse
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
```