Metadata-Version: 2.4
Name: tv-control-center
Version: 0.0.2
Summary: TV Control Center — Universal Smart TV Management Suite for Sony BRAVIA, SHIELD, TCL, Hisense, Fire TV, Chromecast, Xiaomi.
Author-email: Ashish Dungdung <ashishdungdung@users.noreply.github.com>
License: MIT License
        
        Copyright (c) 2026 Ashish Dungdung <https://github.com/ashishdungdung>
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/ashishdungdung/tv-control-center
Project-URL: Documentation, https://github.com/ashishdungdung/tv-control-center#readme
Project-URL: Repository, https://github.com/ashishdungdung/tv-control-center.git
Project-URL: Issues, https://github.com/ashishdungdung/tv-control-center/issues
Keywords: sony,bravia,androidtv,adb,debloat,optimization,dashboard,smarttv
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: System :: Hardware :: Hardware Drivers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 📺 TV Control Center — Universal Smart TV Management Suite

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/Python-3.8%2B-blue?logo=python)](https://www.python.org/)
[![Platform: Android TV / Google TV](https://img.shields.io/badge/Platform-Android%20TV%20%7C%20Google%20TV-green?logo=android)](https://developer.android.com/)
[![Target: Universal Multi-TV](https://img.shields.io/badge/Target-Universal%20Multi--TV-red)](https://github.com/ashishdungdung/tv-control-center)
[![Sponsor](https://img.shields.io/badge/Sponsor-Buy%20Me%20A%20Coffee-orange?logo=buy-me-a-coffee)](https://buymeacoffee.com/ashishdungdung)

> **Universal desktop system management suite and optimization engine for Sony BRAVIA, NVIDIA SHIELD, TCL, Hisense, Philips, Panasonic, Sharp, Vu, Fire TV, Chromecast, and Xiaomi Smart TVs.**

---

## 🌟 Overview

**TV Control Center** is a high-performance desktop web console that connects wirelessly to your **Smart TV** over **ADB (Android Debug Bridge)**. It allows you to audit hardware, tune performance profiles, calibrate display & audio engines, manage apps, debloat telemetry, configure launchers, and control your TV remotely — all from your laptop or desktop browser.

```mermaid
graph TD
    subgraph "TV Control Center Architecture"
        DESK["Desktop Browser Console<br>(http://localhost:8888)"] -->|HTTP REST API| PY["Python 3 Async HTTP Server<br>(bravia_control / server.py)"]
        PY -->|Wireless ADB Bridge| TV["Smart TV Device Bridge<br>(192.168.2.122:5555)"]
        
        TV -->|SoC Hardware| MTK["MediaTek MT5893 Quad-Core @ 1.5 GHz"]
        TV -->|Picture Processor| X1["Sony X1 4K HDR Processor"]
        TV -->|Sound Engine| DSEE["Sony DSEE Audio Enhancer & Voice Zoom"]
    end
```

---

## ⚡ Key Features

- **🗂 Persistent Sidebar Navigation:** Clean, modern SPA shell with Home, Performance, Display, Audio, Network, Apps, Launcher, Remote, Hardware, Activity, and Settings views.
- **🎛 Simple / Advanced Mode Toggle:** Hide technical parameters (`debug.sf.hw`, `tcp_window_scaling`) from casual users while giving power users deep low-level control.
- **🔍 Command Palette (`⌘K` / `Ctrl+K`):** Fuzzy-search search bar across all settings, actions, DNS configurations, and page routes.
- **🚀 1-Click Optimizations:** One-click RAM cleaner, cache purger, YouTube accelerator, and full-system performance booster.
- **🛡️ 20-Package Safe Debloater:** Easily disable Samba TV tracking (`tv.samba.ssm`), Sony bug reporters, Google TV recommendation ads, and demo stubs.
- **📱 Live App Utilization Telemetry:** Scan all 52+ installed apps, track live PSS memory footprints, and disable unused apps with 1 click.
- **📸 Snapshot & Restore System:** Save and restore full system configuration states locally on host JSON, browser LocalStorage, and TV storage (`/data/local/tmp/`).
- **📦 APK Drag-and-Drop Sideloader:** Sideload APK files directly to your TV by dropping them onto the browser.
- **🎮 Virtual Remote Control:** Wireless D-pad, Home, Back, Menu, Volume controls, and desktop keyboard arrow keys integration.
- **🍞 Toast & Activity Timeline:** Instant notifications and full audit trail of every modification with exact timestamps.

---

## 📺 Supported Devices & Hardware Profiles Matrix

| Brand / Family | Series & Model Lineups Included | Processor & Panel Tech | Key Features |
| :--- | :--- | :--- | :--- |
| **Sony BRAVIA X80 Series** | KD-43X8000H, KD-49X8000H, KD-55X8000H, KD-65X8000H, X80J, X80K, X80L | Sony X1 4K HDR Processor (Direct VA LED) | DSEE Audio + Voice Zoom 3 |
| **Sony BRAVIA X85/X90/X95** | KD-55X9000H, KD-65X9000H, XR-55X90J, XR-65X90K, XR-75X90L | Sony Cognitive Processor XR (Pentonic 1000) | 120Hz VRR + FALD Local Dimming |
| **Sony BRAVIA Master OLED** | KD-55A8H, KD-65A8H, XR-55A80J, XR-65A80K, XR-77A80L, XR-65A95L | Sony Cognitive XR Master Series (QD-OLED) | Acoustic Surface Audio+ |
| **NVIDIA SHIELD TV** | SHIELD TV & SHIELD TV Pro (2017 / 2019) (P2897, P3430) | NVIDIA Tegra X1+ (256-core Maxwell GPU) | AI Upscaling + Dolby TrueHD |
| **TCL Mini-LED QLED** | 55C835, 65C835, 75C845, 65QM850G (C8 Series / QM8) | AiPQ Engine 3.0 (MediaTek MT9615 / Realtek) | 144Hz VRR + Mini-LED QLED |
| **Hisense ULED Mini-LED** | 55U8K, 65U8K, 75U8K, 65U8N (U6K / U7K / U8K / U8N) | Hi-View Engine Pro (Amlogic S905X4) | 144Hz VRR + 2.1.2ch Atmos |
| **Philips Ambilight TV** | 55OLED807, 65OLED808, 55PUS8808 (The One) | P5 AI Perfect Picture Engine (MT9970) | 120Hz OLED + 4-sided Ambilight |
| **Panasonic Master OLED** | TX-55LZ1500, TX-65MZ2000, 55MX950 | HCX Pro AI Processor (MediaTek MT9612) | Master OLED Pro + Technics Sound |
| **Sharp AQUOS 4K** | 4T-C50DN1, 4T-C65EQ1 | X4 Revelation Processor | Deep Chroma Display + Harman/Kardon |
| **Vu GloLED & Masterpiece** | 55GloLED, 65GloLED, 55Masterpiece QLED | Vu Glo Processor (400 nits) | 104W Integrated DJ Subwoofer |
| **Amazon Fire TV** | Fire TV Cube (3rd Gen), Fire TV Stick 4K Max (KFTTR) | Octa-Core 2.0 GHz (Amlogic POP1-G) | Fire OS 7/8 + Dolby Atmos |
| **Google Chromecast** | Chromecast with Google TV (HD/4K) & Google TV Streamer 4K | Amlogic S905X3 / MediaTek MT8696 | Google TV + DoT DNS |
| **Xiaomi Mi Box & Stick** | Mi Box S 4K (MDZ-22-AB), Mi TV Stick 4K, Xiaomi TV Q2 | Amlogic S905X2 / S905Y4 | DTS HD + Android TV 11 |

---

## 📊 Performance Comparison Matrix

| Feature / Mod | Stock Sony TV Default | BRAVIA Control Center v3.0 | Real-World Gain |
| :--- | :--- | :--- | :--- |
| **UI Composition** | Software CPU Blending | 🟢 **GPU Mali Hardware Composition** | 0% CPU Overhead \| 60fps UI |
| **Pixel Mapping** | 2%–5% Overscan Edge Crop | 🟢 **1:1 Native Pixel Mapping** | 100% 4K Sharpness \| 0 Edge Crop |
| **Movie Playback** | 3:2 Pulldown Judder | 🟢 **True 24p Cinema Cadence** | Smooth Judder-Free 24fps Motion |
| **OpenGL Pipeline** | Software Vector Fallback | 🟢 **Hardware EGL Acceleration** | Fast Icon & Texture Rendering |
| **HDR Tone Mapping** | Static Metadata Only | 🟢 **Sony X1 Dynamic Tone Mapping** | Vibrant Highlights & Shadow Detail |
| **Audio Processing** | Flat / Unenhanced | 🟢 **Sony DSEE + Voice Zoom 3** | Crystal Clear Dialogue in Movies |
| **Network Buffer** | 256 KB Small Buffer | 🟢 **Ultra 4.0 MB TCP Buffer Vector** | 🚀 **16x Buffer \| 0% 4K Buffering** |
| **DNS Resolution** | Unencrypted ISP DNS | 🟢 **Cloudflare Encrypted DoT (1.1.1.1)** | 9.9 ms Latency \| 0 DNS Leaks |
| **Wi-Fi Stability** | Aggressive Disconnects | 🟢 **Wi-Fi Watchdog Suppressed** | Zero Wi-Fi Drops on Streaming |
| **Home Screen** | Stock Google Launcher (Ads) | 🟢 **Projectivy Launcher (Zero Ads)** | Reclaims ~150–200 MB RAM |

---

## 🚀 Quick Start (1 Command Launch)

> 📖 **Need help enabling ADB on your TV?** Follow our step-by-step [SETUP_GUIDE.md](SETUP_GUIDE.md) for brand-specific navigation paths (Sony BRAVIA, Google TV, NVIDIA SHIELD, TCL, Hisense, Fire TV).

### 1. Prerequisites
- Python 3.8 or higher installed on your computer.
- Android Debug Bridge (`adb`) installed (`brew install android-platform-tools` on macOS).
- Smart TV connected to the same Wi-Fi network with **ADB Debugging** enabled under Developer Options.

### 2. Run Control Console
```bash
python3 -m bravia_control serve --port 8888
```
Open **`http://localhost:8888`** in your browser.

---

## 💖 Support & Monetization

BRAVIA Control Center is 100% free and open-source. If this tool helped speed up your TV, consider supporting ongoing development:

- ☕ **Buy Me a Coffee:** [buymeacoffee.com/braviacontrol](https://buymeacoffee.com/braviacontrol)
- 💖 **GitHub Sponsors:** [github.com/sponsors/anumac](https://github.com/sponsors/anumac)

---

## 🤝 Credits & Open-Source Acknowledgments

We gratefully acknowledge the developers of the open-source tools and components integrated into this suite:

- **[Projectivy Launcher](https://github.com/spocky/projengmenu)** by Spocky
- **[FLauncher](https://gitlab.com/efesser/flauncher)** by efesser
- **[Button Mapper](https://buttonmapper.app)** by flar2
- **[SmartTube 4K](https://github.com/yuliskov/SmartTube)** by yuliskov
- **[Google Fonts (Inter & JetBrains Mono)](https://fonts.google.com)** by Google Fonts
- **[Android Debug Bridge (ADB)](https://developer.android.com/tools/adb)** by Google Android Open Source Project

---

## ⚖️ Legal, Warranty & Limitation of Liability Disclosures

> [!CAUTION]
> **NO WARRANTY & LIMITATION OF LIABILITY:**
> BRAVIA Control Center is provided **"AS IS"** and **"AS AVAILABLE"** without warranties of any kind.
> Under no circumstances shall the authors, maintainers, or contributors be held liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, device bricking, soft-bricking, boot-loops, warranty voidance, data loss, app malfunction, or system instability) arising out of the use or inability to use this software.
>
> All ADB property overrides (`setprop`), package debloating (`pm disable-user`), and network buffer tweaks are executed at the **user's sole risk and discretion**.
>
> For full legal terms, review the [DISCLAIMER.md](DISCLAIMER.md) document.

---

## 📜 Trademark Notice

**BRAVIA®** is a registered trademark of **Sony Group Corporation**. **Android TV™**, **Google Play™**, **YouTube™**, and **Google TV™** are trademarks of **Google LLC**.

BRAVIA Control Center is an independent, community-driven open-source project. It is **not affiliated with, authorized by, maintained by, sponsored by, or endorsed by Sony Group Corporation, Google LLC, MediaTek Inc., or any of their subsidiaries**.

---

## 📄 License

This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
