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"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 JHScom.iwedia.*OTA services are completely uninstalled (or disabled if protected by the ROM). - 🚫 Startup Boot Ads Removed:
com.jio.stbadserviceis completely uninstalled (or disabled if protected) so commercial promo and intro ads are suppressed.
- Prerequisites
- Step-by-Step Guide
- 1. Network Pairing
- 2. Get Host IP
- 3. Configure STB DNS via USB Bug
- 4. Isolate Network & Temporarily Disable Firewall
- 5. Run Docker
- 6. Setup Technitium DNS
- 7. Deploy TLS Containers
- 8. Launch Proxy Listener
- 9. Initialize Git Bash & Health Check
- 10. Execute Stage 1
- 11. Verify ADB Connection
- 12. Teardown & Reset
- How to Install Apps via ADB
- Advanced CLI Options
- Get Hands-On Help / Mail-In Setup
- Credits & Acknowledgments
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.)
- 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).
Open Command Prompt (Win + R cmd) and run:
ipconfigFind Wireless LAN adapter Wi-Fi (or Ethernet if wired) and copy your IPv4 Address (example: 192.168.1.20).
Note
An empty USB pendrive is required strictly to access the hidden stock Android settings menu.
- Plug any USB thumb drive into the Jio STB.
- Turn on the STB
$\rightarrow$ Launch My Music$\rightarrow$ Settings$\rightarrow$ Select Eject USB. - Tap Internal Storage
$\rightarrow$ Open Apps$\rightarrow$ Select the stock Settings app (gear icon). - Navigate to Network
$\rightarrow$ Select your Wi-Fi network$\rightarrow$ Open Advanced IP Settings. - Change IP Settings from DHCP to Static.
- Keep IP Address, Gateway, Subnet, and DNS 2 unchanged.
- Set DNS 1 to your Windows PC's IPv4 Address from Step 2.
- 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.
-
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.
-
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:
- Press
Win + R, typefirewall.cpl, and press Enter. - Click "Turn Windows Defender Firewall on or off" on the left menu.
- Select "Turn off Windows Defender Firewall (not recommended)" for both Private and Public network settings.
- Click OK. (You will re-enable it in Step 12 once finished.)
- Press
Launch Docker Desktop from your Start Menu and wait until the engine status shows running.
- Open the Technitium console in your browser at
http://localhost:5380. - Go to Zones
$\rightarrow$ Click Add Zone:-
Zone Name:
jio.com -
Zone Type:
Primary Zone
-
Zone Name:
- Click into
jio.com$\rightarrow$ Click Add Record:-
Name:
acs.oss -
Type:
A - IP Address: Your Windows IPv4 Address from Step 2
-
Name:
- Save the record and ensure the
jio.comzone is Enabled.
- Open File Explorer and navigate to
sideload-jiostb/tls. - Click the address bar, type
cmd, and press Enter. - In Command Prompt, run:
docker compose up -dPick Option A or Option B depending on your box model:
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.)
JHS boxes enforce strict system CA certificate validation and reject the default certificate chain. Instead of python pass_front.py:
- Open Git Bash in the main
sideload-jiostbfolder. - 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.)
- Open the main
sideload-jiostbfolder. - Right-click blank space
$\rightarrow$ Show more options$\rightarrow$ Open Git Bash here. -
(Optional but recommended) Verify your PC setup before touching the TV:
python doctor.py --quick python doctor.py --simulate
--simulatesends a synthetic Inform through the proxy and GenieACS to confirm the entire chain is operational.
Ensure Docker, Technitium, and your proxy listener (from Step 8) are active, then run:
./stage1.sh --list-devicesSelect your STB when prompted. To run only the required payload without stripping extra packages, use:
./stage1.sh --tasks-onlyImportant
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.
- Unplug the STB power adapter from the wall (do not just put it in standby with the remote).
- Wait 5 seconds
$\rightarrow$ Plug it back in. - Allow it to boot up completely.
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 devicesYour device should now appear with the status device.
Once ADB is confirmed and your setup is complete:
- Stop
pass_front.pyorrun_acs.shby pressingCtrl + Cin its window (or run./stage1.sh --stop). - In Git Bash, stop the Docker containers:
docker compose down
- Reconnect your router's incoming WAN/Internet cable.
-
Turn Windows Defender Firewall back on: Press
Win + R$\rightarrow$ firewall.cpl$\rightarrow$ Turn Windows Defender Firewall back on.
Since the built-in package installer UI is disabled on the STB, install any Android TV APK from your PC:
- Connect your PC to the STB over ADB (if not already connected):
adb connect <STB_IP_ADDRESS>:5555
- Sideload your application:
adb install "C:\path\to\your_app.apk" - The app will immediately appear inside Monet Launcher.
| 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 |
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:
- Twitter / X: @ilikechocopies
- Instagram: @soloxsurfer
- Reddit: u/ilikechocopies
- 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.shandpull_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.
-
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.