https://github.com/h1b0b0/kick-viewerbot

Tools with a graphical interface to create fictitious viewers on your live streams
https://github.com/h1b0b0/kick-viewerbot

bot easy-to-use interface kick kick-viewbot kick-viewer-bot python viewer

Last synced: 5 months ago
JSON representation

Tools with a graphical interface to create fictitious viewers on your live streams

Host: GitHub
URL: https://github.com/h1b0b0/kick-viewerbot
Owner: H1B0B0
License: mit
Created: 2023-06-14T16:51:14.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2025-11-10T19:12:54.000Z (8 months ago)
Last Synced: 2025-11-10T21:05:45.887Z (8 months ago)
Topics: bot, easy-to-use, interface, kick, kick-viewbot, kick-viewer-bot, python, viewer
Language: TypeScript
Homepage:
Size: 3.39 MB
Stars: 79
Watchers: 3
Forks: 20
Open Issues: 2
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt

Awesome Lists containing this project

README

# Kick Viewer Bot

A powerful web application for generating Kick views using proxy rotation technology. Built with a **Flask/SocketIO** backend and **Next.js** frontend communicating via WebSocket.

## Warning

⚠️ **EDUCATIONAL PURPOSE ONLY** ⚠️

This software is provided strictly for educational and research purposes. Using this tool to manipulate viewing metrics may violate Kick's Terms of Service and applicable laws. The developers assume no responsibility for misuse of this software.

## Table of Contents

- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Development Setup](#development-setup)
- [How to use with macOS](#how-to-use-with-macos)
- [Screenshots](#screenshots)
- [License](#license)

## Features

- 🚀 High-performance multi-threading system supporting up to 1000 concurrent connections
- 🔄 Intelligent proxy rotation with automatic failover mechanisms
- 🌐 Comprehensive proxy protocol support (HTTP, SOCKS4, SOCKS5)
- 🌐 **Proxy-tunneled WebSocket connections** — each viewer appears from a unique IP
- 📊 Real-time analytics dashboard with performance metrics
- 📱 Responsive and intuitive web interface
- 🔥 **Stability Mode** — long-lived connections with auto-reconnection
- 🔔 **Automatic update notifications** when a new version is available
- ⚙️ Advanced configuration options for power users

## Requirements

- Python 3.9+
- Node.js 18+
- Modern web browser with JavaScript enabled
- Stable internet connection
- (Optional) Custom proxy list for enhanced performance

## 💻 Installation

1. Download the latest release executable from the [releases page](https://github.com/H1B0B0/Kick-Viewerbot/releases)
2. Run `KickViewerBOT` — **no admin privileges required**
3. Configure your viewing preferences and proxy settings
4. Start the bot and monitor real-time statistics

## 🛠️ Development Setup

### 1. Clone & install dependencies

```shell
git clone https://github.com/H1B0B0/Kick-Viewerbot.git
cd Kick-Viewerbot
```

**Backend (Python):**

```shell
pip install -r requirements.txt
```

**Frontend (Node.js):**

```shell
cd frontend
npm install
```

### 2. Run the development servers

You need **two terminals** running simultaneously:

**Terminal 1 — Backend:**

```shell
python ./backend/main.py
```

**Terminal 2 — Frontend:**

```shell
cd frontend
npm run dev
```

The frontend dev server runs on `http://localhost:3000` and communicates with the backend via WebSocket.

## How to use with macOS

1. Download the macOS build from the [releases page](https://github.com/H1B0B0/Kick-Viewerbot/releases)
![macOS version](./images/macos_file.png)
2. When launching, you may encounter a security warning
![macOS block message](./images/macos_block.png)
3. Navigate to `System Settings` → `Privacy & Security`. Click `Open Anyway`
![Enable macOS application](images/enable_macos.png)
4. Confirm by clicking `Open Anyway` in the dialog
![Execute the app](./images/use_macos.png)
5. The application will start. Configure your settings and enjoy 🚀

## 📸 Screenshots

Dashboard Overview
Channel Configuration
Advanced Settings
Performance Analytics