Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
badbox-tv-audit — Audits Android TV and Google TV devices over ADB for BadBox, XCPE and Vo1d malware, with a VPN traffic sentinel, IoC blocklists and reversible remediation. | Kitploit
Tools/GitHubGitHub/mafarricos/badbox-tv-audit
Android SecurityDefensive ToolsIndicator of Compromise (IOC) ManagementVulnerability ScannersIoT SecurityNetwork ForensicsForensicsMalware AnalysisMobile SecurityHardware & IoT SecurityIncident ResponseDNS Analysis
102 days agoNot yet reviewed

Most Popular

View all →

Discover the most used tools by our community.

Explore all tools

Browse our collection of tools

View all tools →
Share
GitHubmafarricos/badbox-tv-audit

badbox-tv-audit

Audits Android TV and Google TV devices over ADB for BadBox, XCPE and Vo1d malware, with a VPN traffic sentinel, IoC blocklists and reversible remediation.

View Repository

Android TV & Google TV Forensic Suite (BadBox, XCPE, Vo1d & Malware Remediation)

Platform Python License Zero-AI Rules App Remediation Logging

An autonomous, dual-layer forensic, malware removal, and reversible remediation suite (CLI + native Android TV app with local loopback VPN sentinel) engineered to audit, detect, verify, neutralize, and restore Android TV, Google TV, and generic streaming devices compromised by supply-chain trojans, botnets, and malware (BadBox, XCPE, Vo1d, Fuyao, Videostrong/SZBBOYS, and Residential Proxyware).

Language: English (Default) | Para a versão em Português (PT-PT), consulte README.pt.md | 📱 Tested Devices Registry | 🔬 Architecture Decisions (ADRs) | 📜 Third-Party Notices


🎯 Why this tool?

Thousands of budget Android TV boxes and Smart TVs arrive pre-infected straight from the factory or become compromised via malicious streaming apps and trojanized firmware. The malware typically:

  1. Silently turns off Google Play Protect by forcing package_verifier_user_consent = -1.
  2. Installs persistent trojans and backdoors (such as Vo1d, BadBox, or XCPE) into the /system or /vendor partition (surviving factory resets).
  3. Secretly runs residential proxyware SDKs (turning your home TV into an illegal proxy exit node and reselling your home Internet bandwidth) and performs hidden background ad-fraud.

This suite provides two complete audit & cleanup paths:

  • For Everyday Users (No PC required, Remote D-Pad only): Install the APK on your TV via USB flash drive or browser. The app runs the scan, displays the verdict, and exposes the red "NEUTRALIZE THREATS" button. For system implants that cannot be deleted without ADB, the app activates a persistent VpnService Quarantine Sinkhole Mode that blocks malicious network traffic directly on the TV.
  • For Technicians & AI Agents (Via PC / ADB): 100% silent and automated pipeline (audit_security.py) featuring subnet discovery, token-saving pure JSON mode, mandatory backups, APK quarantining, and injection-safe parameterized rollback.

📱 1. Preparing Your TV (Enable Developer Options & ADB)

Before running tools or dispatching an AI Agent, enable ADB Debugging on your TV so it can be audited over Wi-Fi:

A. Standard Android TV (Android 9, 10, 11 - e.g. Xiaomi, Strong, generic boxes):

  1. Go to Settings (gear icon) -> Device Preferences -> About.
  2. Scroll down to Build.
  3. Press the OK / Center button 7 times until the screen confirms: "You are now a developer!".
  4. Go back to Device Preferences -> Developer Options.
  5. Enable USB Debugging and (if available) Network Debugging.
  6. When prompted on the TV screen "Allow USB debugging from this computer?", select "Always allow from this computer" and confirm OK.

B. Google TV (Android 12, 14 - e.g. Chromecast, realme, Thomson, TCL):

  1. Navigate to your profile icon (top right) -> Settings.
  2. Select System -> About.
  3. Scroll to Android TV OS build.
  4. Press the remote's OK button 7 times to unlock Developer Options.
  5. Return to System -> Developer Options.
  6. Enable USB Debugging.
  7. Confirm the authorization pop-up on the TV screen.

[!WARNING] 🔒 Security Best Practice (Turn OFF Debugging when finished):
Leaving ADB / USB Debugging permanently enabled on your home Wi-Fi network exposes a management port (5555) that other devices or malicious apps on the local network could theoretically probe.
Always remember to turn OFF USB Debugging in Developer Options once the audit and remediation are complete!


🤖 2. Dispatching an AI Agent (Antigravity, Claude Code, Grok, Cursor, Copilot)

This repository includes self-contained operational guidelines in AGENTS.md that modern AI coding agents automatically follow. You don't need to manually configure Python, install drivers, or write commands.

[!IMPORTANT] 🛡️ Safe Autonomous Workflow for AI Agents:
Always instruct the AI Agent to run --quick-scan (100% read-only diagnosis) first. Review the technical findings and the remediation plan before executing --remediate.

Simply open your AI Agent and send this single prompt:

Clone https://github.com/Mafarricos/badbox-tv-audit.git, read AGENTS.md, and audit my Android TV at IP <TV_IP>.

(Tip: If you do not know your TV's IP address, ask the agent: ...read AGENTS.md, discover my Android TV devices on subnet 192.168.1.0/24, and audit them.)

The agent will autonomously:

  1. Clone the repository and review AGENTS.md for forensic instructions.
  2. Connect over pure-Python ADB (no external ADB installation required).
  3. Execute the 6-layer static scan and live VPN network sentinel.
  4. Generate a sanitized anonymous audit report (community_audit_submission.json) ready to help update the infected devices database.

📺 The Native Android TV App (app/)

The application is localized automatically (Portuguese if device is set to Portuguese; English for all other languages) and is 100% D-Pad navigable:

  1. Button 1: SCAN TV BOX (STATIC): Audits /oem/, /vendor/, Play Protect integrity, trojan artifacts (Vo1d, XCPE), and inspects package signatures in seconds.
  2. Button 2: MONITOR NETWORK (VPN): Local loopback sentinel alerting in real time:
    • RED ([CRITICAL]): If the TV initiates connections to known C2 servers or malicious domains.
    • ORANGE ([SUSPICIOUS]): If a connection is made to a known botnet/proxy port without matching a known C2 IP/domain.
    • YELLOW ([ANOMALY]): If unusual high-port network traffic is detected while the TV is idle.
    • Note on Network Connectivity during Monitoring: During the VPN Sentinel window, DNS queries (UDP port 53) are actively inspected and forwarded so malware domain lookups succeed, while direct TCP/UDP data packets are inspected and dropped in the loopback interface. Consequently, general internet browsing/streaming is temporarily paused while the monitor is active and immediately resumes once the VPN is stopped.

  3. Button 3: NEUTRALIZE THREATS (Appears when anomalies are detected):
    • User Packages & Updates (/data/app): Launches sequential uninstallation prompts.
Download Tool