/crude-twitch-viewer-bot

Twitch live viewer bot GUI with playwright. Spawns low-resolution muted Chrome instances with proxy & user-agent. Requires HTTP proxies.

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

Crude Twitch Viewer Bot (CTVBot)

format & lint

Disclaimer: For educational purpose only. Any discussion of illegal use will be deleted immediately!

Small GUI tool that spawns muted Google Chrome instances via Playwright, each with a different user-agent and HTTP proxy connection. Each instance navigates to the twitch channel, activates theater mode and adheres itself to the available screen space. Settings in localStorage ensure the lowest possible resolution.

Read the comprehensive wiki for a detailed tutorial, usage tips and troubleshooting steps.

☕ You can sponsor me a coffee if you enjoy this tool and want to support its continued development.

Important

  • You need to provide your own private HTTP proxies to the proxy_list.txt
    Buy trusted proxies here or follow the Webshare.io Proxies Guide.
  • Chrome needs to be already installed on your system.
  • Tested with instance count: Headless ~100, headful ~30.
  • Tested on Windows 10. Linux and macOS is experimental.
  • CPU load and bandwidth can get heavy. Channels with 160p work best.

In Action

Color codes of the square boxes

⬛ - Instance is spawned. 🟨 - Instance is buffering. 🟩 - Instance is actively watching.

Headful Spawning


(If you go headless, the browser windows will be invisible)

Usage Windows

Read the comprehensive wiki for a detailed tutorial, usage tips and troubleshooting steps.

Quickstart Steps

Download the one-file executable for Windows from the latest CTVB release.

  1. Extract zip file to a folder.
  2. Add your private proxies to proxy_list.txt
    Buy trusted proxies here or follow the Webshare.io Proxies Guide.
  3. Start executable and wait for the GUI to appear.
  4. Spawn instances patiently.

Interactions with the square boxes

🖱️ Left click: Refresh page.
🖱️ Right click: Destroy instance.
🖱️ Left click + CTRL: Take screenshot (saved in root folder).