/VCBOT

Primary LanguageTypeScriptGNU Affero General Public License v3.0AGPL-3.0

Calls Music Remix Mentioned in Awesome Telegram Calls Mentioned in Awesome grammY

Stream in Telegram calls using GramTGCalls.


Features

  • Various sources to stream from:
    • Custom URLs.
    • YouTube playlists.
    • Small audio files and voice messages.
    • YouTube videos (no duration limit, even live videos).
  • Stream in multiple chats simultaneously, with their own queues.
  • Control volume.
  • Friendly responses.
  • Doesn't create files.
  • Multilingual.

Running

  1. Copy example.env to .env and fill it with your credentials.
  2. Install dependencies and build:
npm install
  1. Start:
npm start

Deploying to the cloud

Deploy to Heroku

Configuring

  • BOT_TOKEN: Telegram bot token.
  • STRING_SESSION: A GramJS/Telethon string session. You can generate one here.
  • API_ID: Telegram app ID.
  • API_HASH: Telegram app hash.
  • LOCALE: An available bot language. Default: en.
  • MAX_PLAYLIST_SIZE: Max YouTube playlist size. Default: 10.
  • COOKIES: Cookies for YouTube requests. Default: none.

Commands

stream

Aliases: s, play, p

Takes a custom input, audio file, voice message or YouTube video/playlist link/ID and streams/queues it.

Custom inputs should be passed like this:

/stream custom your_custom_input

playlist

Aliases: pl, list

Streams a YouTube playlist.

shuffle

Aliases: sh, mix

Shuffles the items in the queue.

now

Aliases: ns, cs, np, cp

Displays the currently streamed item.

volume

Aliases: vol, v

Sets the volume.

pause

Pauses the stream.

resume

Aliases: re, res, continue

Resumes the stream.

mute

Aliases: m

Mutes the stream.

unmute

Aliases: um

Unmutes the stream.

skip

Aliases: next

Skips the current stream.

leave

Aliases: stop

Clears the queue and removes the bot from the call.

Available languages

bn    Bengali
ckb   Central Kurdish
de    German
en    English
es    Spanish
fa    Farsi
id    Indonesian
ml    Malayalam
pt_BR Brazilian Portuguese
si    Sinhalese
tr    Turkish

Contributing

New languages, bug fixes and improvements following our contribution guidelines are warmly welcomed!

Inspiration

License

GNU Affero General Public License v3.0

Read more