Neptunium Viewbot

A modular, single-threaded web automation script designed to run inside Linux environments. It can bot views reliably using Python and Playwright, paired with a physical Android device to dynamically cycle connection states.

Features

• Headless Stealth: Uses a decoupled headless browser engine (headless="shell") that strips automation flags (AutomationControlled) and integrates profile camouflaging to match real desktop configurations.
• Network Rotation Layer: Automatically interfaces with a physical Android device to drop and reassign cellular network interface profiles per cycle.
• Randomized Fingerprints: Dynamically alternates between multiple distinct User-Agent identifiers and screen viewport layouts for every session loop.
• Organic Interaction Profiles: Features variable typing delays and randomized viewing durations to follow a more fluid timeline.
• Modular Codebase: Clean, separated code structure (main.py, browser_session.py, adb_rotator.py) to easily adjust specific logic blocks.
• Integrated Installer: Simple installation shell wrapper that handles virtual environment generation and package distribution dependency conflicts natively.

Requirements

Local Machine

• Operating System: Linux (Debian, Ubuntu, etc.)
• Python Engine: Python 3.10 or newer
• System Utilities: Android Debug Bridge (adb) CLI toolchain

Hardware Tethering (Android Phone)

• Connection Profile: Must be connected via USB to the automation machine.
• Developer Modes: USB Debugging must be enabled in the device's Developer Options.
• Network Settings: USB Tethering must be activated to route your machine's connection through the device's cellular radio.
• Authorization: The computer must be explicitly added to the device's authorized debug profile list (Always allow from this computer).

Installation

Clone the repository to your local directory and run the integrated installer script to provision dependencies, build the isolated environment, and establish system paths:

# Provide script authorization bits
chmod +x install.sh

# Run the system deployment engine
./install.sh

Usage

Once installed, the program binds globally to your shell path and can be called from any destination directory using the following lowercase format:

neptunium <URL> <COUNT>

Example

To bot viewing a specific video 50 consecutive times with 50 fresh network paths:

neptunium https://youtube.com 50