Skip to content

About

Clean, step-by-step Windows 11 guide to enable ADB on Jio STB (JMSC200Av2 & JMSB200A) via local DNS spoofing & Docker containers. Tested on firmwares 22.1.09, 24.1.39, 25.1.9, and older builds (excludes JHS models). Includes foolproof network isolation steps, fallback troubleshooting, and Wi-Fi reset fixes for smooth sideloading.

Resources

Stars

454 stars

Watchers

2 watching

Forks

Repository files navigation

Jio STB ADB Setup Guide (Windows 11 & 10)

A beginner-friendly, clutter-free walkthrough to enable network ADB debugging and sideload custom launchers/apps on supported Jio Set-Top Boxes using a Windows PC and your home Wi-Fi router.

Tip

Need Hands-On Help or Want Vishal Beniwal to Do It For You?

  • Mail-In Service: If you find this guide too technical or complicated, you can ship your box to Vishal Beniwal and he will set it up for you! Pay whatever your heart desires + return shipping.
  • Twitter / X: @ilikechocopies
  • Reddit: u/ilikechocopies
  • Instagram: @soloxsurfer

Note

Supported Hardware & Firmware:

  • JMSC200Av2 and JMSB200A across firmware builds 22.1.09, 24.1.39, 25.1.9, and older.
  • JHS series (JHSC200 v1 / JioOS 2.0) on firmware build stb-jhcs200-11.3.46.

Both box families use the exact same ./stage1.sh workflow. The only difference is in Step 8 (launching the proxy listener).

Tip

Don't Panic If Something Goes Wrong:

  • Box acting up? Factory reset your Jio STB to restore default settings, then start over.
  • Wi-Fi not connecting properly? Open network settings, choose Forget Network, re-enter your password, and reconnect.

Important

Package Installer Limitation (Read This!): Jio disabled the stock Android package installer UI on the box, so you cannot click an APK file directly on the TV to install it. Every app must be installed via ADB from your PC:

adb install "filename.apk"

✨ What Happens After Running the Script?

Once you execute Stage 1, the script performs the following modifications on your Jio STB:

  • 🔓 ADB Enabled: Network ADB is activated (expires in 2037) so you can manage and sideload apps.
  • 🚀 Monet Launcher Activated: Replaces the cluttered stock interface with a clean, customizable TV launcher. The stock launcher is suspended to prevent boot ad reversion.
  • ⚡ Shevery (Shizuku-Compatible API) Installed: Standalone manager granted full permissions (WRITE_SECURE_SETTINGS, DUMP, PACKAGE_USAGE_STATS, AppOps, and battery exemption) so apps can access privileged APIs and ADB can be re-enabled through Shevery if ever disabled after reboot.
  • 🛑 Automatic Updates, TR-069 & Telemetry Removed: com.jio.httpupdate, com.jio.usbupdate, com.jio.tr069client, com.rjil.jio.stb.commandreceiver, com.jio.backgroundscheduler, and JHS com.iwedia.* OTA services are completely uninstalled (or disabled if protected by the ROM).
  • 🚫 Startup Boot Ads Removed: com.jio.stbadservice is completely uninstalled (or disabled if protected) so commercial promo and intro ads are suppressed.

⚡ Quick Navigation


🛠 Prerequisites

Install these utilities on your Windows PC before starting:

Tool Purpose Download
Docker Desktop Hosts local GenieACS backend services Official Download
Python 3 Runs proxy and diagnostic scripts (Add to PATH checked) python.org
Technitium DNS Overrides local domain resolution technitium.com
Git for Windows Bash terminal environment gitforwindows.org

(Note: Android platform-tools ADB binaries are already bundled inside this folder.)


🚀 Step-by-Step Guide

Step 1: Network Pairing

  • Connect your Windows PC to your primary home Wi-Fi.
  • Connect your Jio STB to the same router (via standard Wi-Fi or Ethernet).
  • Do not use Guest Wi-Fi (guest networks isolate connected devices from communicating with each other).

Step 2: Get Host IP

Open Command Prompt (Win + R $\rightarrow$ cmd) and run:

ipconfig

Find Wireless LAN adapter Wi-Fi (or Ethernet if wired) and copy your IPv4 Address (example: 192.168.1.20).

Step 3: Configure STB DNS via USB Bug

Note

An empty USB pendrive is required strictly to access the hidden stock Android settings menu.

  1. Plug any USB thumb drive into the Jio STB.
  2. Turn on the STB $\rightarrow$ Launch My Music $\rightarrow$ Settings $\rightarrow$ Select Eject USB.
  3. Tap Internal Storage $\rightarrow$ Open Apps $\rightarrow$ Select the stock Settings app (gear icon).
  4. Navigate to Network $\rightarrow$ Select your Wi-Fi network $\rightarrow$ Open Advanced IP Settings.
  5. Change IP Settings from DHCP to Static.
  6. Keep IP Address, Gateway, Subnet, and DNS 2 unchanged.
  7. Set DNS 1 to your Windows PC's IPv4 Address from Step 2.
  8. Save and ensure the STB reconnects to your Wi-Fi.

Warning

If the Gateway or IP fields auto-clear upon selecting Static, switch back to DHCP, note the default values, switch to Static, and re-enter them manually before saving.

Step 4: Isolate Network & Temporarily Disable Windows Firewall

  1. Unplug Incoming Internet: Unplug the WAN / incoming fiber cable from your router (keep the router powered on). Both devices must communicate over the local network without active internet access.

  2. Temporarily Disable Windows Defender Firewall:

    [!IMPORTANT] Windows Firewall frequently blocks incoming connections from the STB on port 53 (DNS) and ports 8443/9443 (TLS proxy), causing the exploit to silently fail. Temporarily turn it off:

    1. Press Win + R, type firewall.cpl, and press Enter.
    2. Click "Turn Windows Defender Firewall on or off" on the left menu.
    3. Select "Turn off Windows Defender Firewall (not recommended)" for both Private and Public network settings.
    4. Click OK. (You will re-enable it in Step 12 once finished.)

Step 5: Run Docker

Launch Docker Desktop from your Start Menu and wait until the engine status shows running.

Step 6: Setup Technitium DNS

  1. Open the Technitium console in your browser at http://localhost:5380.
  2. Go to Zones $\rightarrow$ Click Add Zone:
    • Zone Name: jio.com
    • Zone Type: Primary Zone
  3. Click into jio.com $\rightarrow$ Click Add Record:
    • Name: acs.oss
    • Type: A
    • IP Address: Your Windows IPv4 Address from Step 2
  4. Save the record and ensure the jio.com zone is Enabled.

Step 7: Deploy TLS Containers

  1. Open File Explorer and navigate to sideload-jiostb/tls.
  2. Click the address bar, type cmd, and press Enter.
  3. In Command Prompt, run:
docker compose up -d

Step 8: Launch Proxy Listener

Pick Option A or Option B depending on your box model:

Option A: For JMSC / JMSB Boxes (Default)

In the same Command Prompt window (inside the tls folder):

python -m pip install pycryptodome
python pass_front.py

(Leave this window running. pass_front.py includes a precomputed token fallback, so it works even without pycryptodome.)

Option B: For JHS Boxes (JHSC200 / JioOS 2.0)

JHS boxes enforce strict system CA certificate validation and reject the default certificate chain. Instead of python pass_front.py:

  1. Open Git Bash in the main sideload-jiostb folder.
  2. Run the automated eMudhra certificate minting script:
    ./jhs/run_acs.sh

(This recovers the leaked eMudhra intermediate key, mints a certificate trusted by the STB's system store, and launches the proxy on ports 8443 and 9443. Leave this terminal open.)

Step 9: Initialize Git Bash & Health Check

  1. Open the main sideload-jiostb folder.
  2. Right-click blank space $\rightarrow$ Show more options $\rightarrow$ Open Git Bash here.
  3. (Optional but recommended) Verify your PC setup before touching the TV:
    python doctor.py --quick
    python doctor.py --simulate
    --simulate sends a synthetic Inform through the proxy and GenieACS to confirm the entire chain is operational.

Step 10: Execute Stage 1

Ensure Docker, Technitium, and your proxy listener (from Step 8) are active, then run:

./stage1.sh --list-devices

Select your STB when prompted. To run only the required payload without stripping extra packages, use:

./stage1.sh --tasks-only

Important

Cold Power-Cycle Is Mandatory (Unplug Wall Power): The Jio STB only contacts the ACS server during boot. Its periodic background check-in takes hours, and remote wake is impossible because NATDetected=True closes incoming port 7547 on the STB.

  1. Unplug the STB power adapter from the wall (do not just put it in standby with the remote).
  2. Wait 5 seconds $\rightarrow$ Plug it back in.
  3. Allow it to boot up completely.

Step 11: Verify ADB Connection

Note

"Allow USB Debugging?" Dialog on TV: No prompt will appear on your TV until the STB boots and applies the CWMP task. Once connected, your TV screen will display an RSA key prompt. Check "Always allow from this computer" and select OK.

If adb connect initially returns failed to authenticate or unauthorized, approve the prompt on the TV first and run adb connect <STB_IP>:5555 again.

In Git Bash, confirm your connection:

adb devices

Your device should now appear with the status device.

Step 12: Teardown & Reset

Once ADB is confirmed and your setup is complete:

  1. Stop pass_front.py or run_acs.sh by pressing Ctrl + C in its window (or run ./stage1.sh --stop).
  2. In Git Bash, stop the Docker containers:
    docker compose down
  3. Reconnect your router's incoming WAN/Internet cable.
  4. Turn Windows Defender Firewall back on: Press Win + R $\rightarrow$ firewall.cpl $\rightarrow$ Turn Windows Defender Firewall back on.

📲 How to Install Apps via ADB

Since the built-in package installer UI is disabled on the STB, install any Android TV APK from your PC:

  1. Connect your PC to the STB over ADB (if not already connected):
    adb connect <STB_IP_ADDRESS>:5555
  2. Sideload your application:
    adb install "C:\path\to\your_app.apk"
  3. The app will immediately appear inside Monet Launcher.

🧰 Advanced CLI Options

Command Purpose
./stage1.sh --doctor Run full diagnostic checklist of ports, NBI, and DNS
./stage1.sh --simulate Test synthetic CWMP session through TLS front & GenieACS
./stage1.sh --watch Real-time watcher polling for STB Inform and port 5555
./stage1.sh --tasks Inspect all pending TR-069 tasks queued for your STB
./stage1.sh --clear-tasks Clear duplicate or stale tasks from GenieACS queue
./stage1.sh --stop Stop background pass_front.py process
./stage1.sh --yes-disable-tr069 Legacy no-op flag (TR-069 & bloat deletion/fallback-disable now runs by default)
./jhs/run_acs.sh Mint eMudhra-forged TLS cert & start proxy for JHS boxes
./jhs/jhs_stage1.sh --status Display persisted Iwedia ADB properties and launcher state on JHS
./jhs/jhs_stage1.sh --post-setup Sideload Monet/Shevery, delete/disable OTA & TR-069 packages, and grant Shevery permissions on JHS
./jhs/jhs_stage1.sh --clu-probe Queue native root command execution probe via tr069native
./jhs/jhs_stage1.sh --clu-read Read back executed command output from tr069native root probe

📬 Get Hands-On Help / Mail-In Setup

If you find this guide too complicated or don't have the time to configure Docker, DNS records, and TLS certificates, Vishal Beniwal can handle the entire setup for you:

  • Mail-In Modification: Ship your box over, and Vishal will unlock network ADB, configure Monet Launcher, and set everything up.
  • Pricing: Pay whatever your heart desires + return shipping charges.
  • Contact Vishal Beniwal:

⚠️ Important Disclaimers

  • Scope: Stage 1 enables ADB, queues downgrade flags, installs Monet Launcher and Shevery (with full permissions), and deletes (or disables if protected) TR-069, OTA update, command receiver, background scheduler, and ad service packages.
  • Root/Bootloader: This guide deliberately excludes unlock.sh and pull_boot.sh. Do not run Stage 2 utilities unless you know what you are doing.
  • Liability: Use only on hardware you own or have explicit authorization to test.

🌟 Credits & Acknowledgments

  • Documentation, Windows 11 Streamlining & Maintenance:
    Maintained by Vishal Beniwal — Twitter/X: @ilikechocopies | Instagram: @soloxsurfer | Reddit: u/ilikechocopies
    The guide and personal support are completely free. If you'd like Vishal to handle the setup for you, pay whatever your heart desires + shipping—and keep him in your blessings!

  • Original Vulnerability Research & Tooling:
    Massive respect to Bihaan Sen, ak_0o7, and Otus9051 for the reverse-engineering and original Housekeeping-PoC repository. Please star and support their project!

  • JHS Series & eMudhra Chain Research:
    Huge thanks to Pavit Chhabra (@mesosan16 on Twitter/X) for helping add JHS series support.

About

Clean, step-by-step Windows 11 guide to enable ADB on Jio STB (JMSC200Av2 & JMSB200A) via local DNS spoofing & Docker containers. Tested on firmwares 22.1.09, 24.1.39, 25.1.9, and older builds (excludes JHS models). Includes foolproof network isolation steps, fallback troubleshooting, and Wi-Fi reset fixes for smooth sideloading.

Resources

Stars

454 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages