Skip to content
SUDEEPBOTSPublic

About

⚡ VCFighter — High-Performance Telegram Multi-Client Voice Chat Engine powered by Pyrogram v2, PyTgCalls, Real-Time Audio DSP, FFmpeg Weapons & Auto-Shield.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

VCFighter Banner

⚡ VCFighter Engine

Next-Generation Telegram Multi-Client Voice Chat Combat & Audio DSP Platform

CI Status Docker Validation Python Version License: MIT Pyrogram v2 PyTgCalls Database Support Group Channel

Features • Architecture • DSP Arsenal • Deploy • VPS Guide • Config • Commands • Web Studio


📖 Overview

VCFighter is a high-performance, asynchronous Telegram voice chat engine engineered for combat, multi-userbot coordination, and real-time audio digital signal processing (DSP). Built with Pyrogram v2 and PyTgCalls, VCFighter allows you to record live voice from active calls, apply real-time FFmpeg filters, and loop the audio back into the voice chat with instantaneous zero-buffering response.

Whether managing multi-account userbot armies or utilizing high-gain volume overdrive and acoustic delay feedback, VCFighter provides complete dominance over Telegram voice chats.


✨ Key Features

  • 🎙️ Live Voice Recording & Auto-Loop: Records your microphone input while speaking and automatically loops the recorded stream the second you release your mic.
  • 📩 Direct DM Voice Injection: Send any voice note or audio file in private DM to the bot, and it instantly streams into the designated target voice chat.
  • 👥 Multi-Userbot Army: Seamlessly spawn, manage, and coordinate multiple assistant client accounts across multiple groups simultaneously.
  • 🎛️ FFmpeg DSP Arsenal: Inline interactive /config panel controlling Volume Overdrive (up to 400%), Earthquake Bass Boost, Demon/Chipmunk pitch shifting, and Ghost Reverb.
  • 🛡️ Auto-Shield Defense: Built-in connection keep-alive loops, flood protection, and automatic reconnects ensure uninterrupted streams during group voice chat raids.
  • 🍃 MongoDB Atlas Persistence: Secure cloud storage for userbot sessions, group targets, active weapon presets, and permission levels.
  • 🐳 Containerized Deployment: Pre-configured Docker, Docker Compose, PM2, Heroku, and Render blueprints.

🏗️ Architecture & DSP Pipeline

The diagram below illustrates how VCFighter processes incoming microphone audio and streams it into Telegram voice chats with real-time DSP modulation:

flowchart TD
    User["🎙️ Voice Chat Speaker / DM Note"] --> Recorder["📡 WebRTC Voice Chat Recorder"]
    Recorder --> AudioCache["💾 Low-Latency In-Memory Audio Buffer"]
    
    AudioCache --> DSP{"🎛️ FFmpeg DSP Filter Graph"}
    DSP -->|Volume Booster| Vol["🔊 Gain Overdrive (up to 400%)"]
    DSP -->|Harmonic Boost| Bass["🎸 Bass Shaper (+40dB Earthquake)"]
    DSP -->|Formant Shift| Pitch["👹 Demon / Chipmunk Pitch Rate"]
    DSP -->|Acoustic Space| Echo["🦇 Multi-Tap Reverb & Limiter"]
    
    Vol --> PyTgCalls["⚡ PyTgCalls Stream Pipeline"]
    Bass --> PyTgCalls
    Pitch --> PyTgCalls
    Echo --> PyTgCalls
    
    PyTgCalls --> VoiceChat["🔊 Telegram Group Voice Chat (Loopback)"]
    PyTgCalls -.-> UserbotCluster["👥 Multi-Userbot Army (Synced Broadcast)"]
Loading

🎛️ FFmpeg Audio Weapons

VCFighter features an extensive suite of audio manipulation weapons configurable in real-time via /config:

Weapon Range Impact
Volume Overdrive 1.0x - 4.0x Pushes audio volume beyond hardware limitations without digital clipping
Bass Boost 0 - 40 dB Normal → Heavy (+15dB) → Earthquake (+30dB) → 💀 MAX (+40dB)
Pitch Control 0.7x - 1.6x Normal (1.0x), Demon (0.7x deep formant), Chipmunk (1.6x hyper-speed)
Dynamic Compressor On / Off Levels dynamic range for punchy, crystal-clear vocal presence
Hard Limiter On / Off Prevents harsh digital distortion at extreme overdrive volumes
Echo & Reverb On / Off Ghost Protocol mode with multi-tap delay feedback loops

🚀 One-Click Deployment

Deploy your instance of VCFighter instantly:

Deploy to Heroku

Deploy to Heroku

Deploy to Render

Deploy to Render


🐳 Docker Deployment

Run VCFighter on any server with Docker Compose:

# 1. Clone repository
git clone https://github.com/SUDEEPBOTS/VCFIGHTER.git
cd VCFIGHTER

# 2. Configure environment
cp sample.env .env
nano .env  # Enter your credentials

# 3. Start container with Docker Compose
docker compose up -d --build

# 4. View live logs
docker compose logs -f

🖥️ VPS Manual Installation

1. Prerequisites (Ubuntu / Debian)

sudo apt update && sudo apt upgrade -y
sudo apt install python3 python3-pip python3-venv git ffmpeg aria2 curl nodejs npm -y

2. Clone & Setup Repository

git clone https://github.com/SUDEEPBOTS/VCFIGHTER.git
cd VCFIGHTER

# Create Python virtual environment
python3 -m venv venv
source venv/bin/activate

# Upgrade pip & install dependencies
pip install -U pip setuptools wheel
pip install -r requirements.txt

3. Configure Variables

cp sample.env .env
nano .env

4. Launch using PM2 Process Manager

# Install PM2 globally
npm install -g pm2

# Start VCFighter
pm2 start start --name "vcfighter"

# Save configuration to survive reboots
pm2 save
pm2 startup

⚙️ Environment Configuration

Variable Description Mandatory Example
API_ID Telegram API ID from my.telegram.org Yes 1234567
API_HASH Telegram API Hash from my.telegram.org Yes a1b2c3d4e5f6...
BOT_TOKEN Bot token created with @BotFather Yes 8123456789:AAF...
MONGO_URI MongoDB Atlas database connection string Yes mongodb+srv://user:pass@cluster...
OWNER_ID Telegram user ID of primary bot owner Yes 6889753421
STARTUP_SESSIONS Comma-separated Pyrogram v2 string sessions for userbots Optional BQB...,BQC...
LOG_CHANNEL Telegram supergroup or channel log ID (-100...) Optional -1001234567890
SUDO_USERS Comma-separated list of authorized sudo user IDs Optional 123456,789012
DEFAULT_MODE Default streaming trigger mode (dm or auto) Optional dm

🎮 Command Catalog

⚔️ Combat & Voice Controls

Command Arguments Description Access
/join <chat_id> Forces assistant userbots into target group voice chat Sudo / Owner
/leave <chat_id> Disconnects assistant userbots from active voice chat Sudo / Owner
/auto — Toggles Auto Mode (records mic while speaking, loops on release) Sudo / Owner
/dm — Toggles DM Mode (forwards voice note from bot DM into active VC) Sudo / Owner
/config — Opens interactive inline DSP panel (Bass, Pitch, Overdrive, Reverb) Sudo / Owner
/stop — Immediately stops active stream and clears voice cache Sudo / Owner
/userbots — Displays status and ping of all connected userbot clients Owner
/raid <chat_id> Initiates synchronized audio broadcast across userbots Sudo / Owner

🛡️ Security & Disclosures

If you discover a security vulnerability within VCFighter, please review our Security Policy. Do not file public GitHub issues for security matters. Instead, contact @heartstealer_x directly.


💖 Contributing & Sponsorship

We love community contributions! Please read our Contributing Guide and Code of Conduct.

To support ongoing development and server infrastructure, consider sponsoring through:


📄 License

Distributed under the MIT License. See LICENSE for complete terms.

Copyright (c) 2026 SUDEEPBOTS. All Rights Reserved.

About

⚡ VCFighter — High-Performance Telegram Multi-Client Voice Chat Engine powered by Pyrogram v2, PyTgCalls, Real-Time Audio DSP, FFmpeg Weapons & Auto-Shield.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages