Lưu ý an toàn: Dự án không yêu cầu root TV, không cài lại firmware và có cơ chế khôi phục các ứng dụng đã tắt. Tuy nhiên, tắt nhầm thành phần hệ thống có thể làm TV mất chức năng hoặc gặp lỗi khởi động. Hãy sao lưu, xác nhận đúng model và kiểm tra danh sách ứng dụng trước khi thực hiện.

Chuẩn bị trước khi thực hiện

Bạn cần chuẩn bị:

• TV chạy Android TV hoặc Google TV.
• Máy tính Windows kết nối cùng mạng Wi-Fi với TV.
• Trợ lý lập trình có thể chạy lệnh terminal, chẳng hạn Claude Code, Codex hoặc Gemini CLI.
• Python 3, Git, JDK 17 và Android SDK Platform 34 cùng Build Tools 34.0.0.
• Kết nối mạng ổn định và khoảng 15–30 phút để thực hiện, kiểm tra và khôi phục nếu cần.

Không tương thích theo cách cài launcher trong bài: Samsung chạy Tizen và LG chạy webOS. Fire TV có giới hạn riêng, không áp dụng nguyên hướng dẫn cài launcher Android.

Bật chế độ nhà phát triển trên TV

CleanYourTV cần kết nối với TV qua ADB (Android Debug Bridge). Tên menu có thể khác nhau tùy hãng.

Bước 1: Mở phần Giới thiệu

Trên TV, vào Cài đặt → Hệ thống hoặc Tùy chọn thiết bị → Giới thiệu (About).

Bước 2: Mở tùy chọn nhà phát triển

Tìm mục Bản dựng (Build) hoặc số bản dựng, sau đó dùng remote bấm OK liên tục 7 lần cho đến khi TV thông báo đã bật chế độ nhà phát triển.

Bước 3: Bật gỡ lỗi

Quay lại phần cài đặt, mở Tùy chọn nhà phát triển (Developer options), bật USB debugging. Nếu có Network debugging, ADB debugging hoặc Wireless debugging, hãy kiểm tra hướng dẫn dành cho phương thức đó.

USB debugging ở đây là chế độ gỡ lỗi phần mềm; vẫn có thể kết nối qua Wi-Fi mà không cần cắm cáp USB. Giữ TV bật trong suốt quá trình cấu hình.

Chuẩn bị máy tính Windows

Bước 1: Cài công cụ cần thiết

Tải công cụ từ trang chính thức:

Python: https://www.python.org/downloads/windows/

Git for Windows: https://git-scm.com/download/win

JDK 17: https://adoptium.net/temurin/releases/?version=17

Android Studio: https://developer.android.com/studio

Khi cài Python, đánh dấu Add Python to PATH. Trong Android Studio, mở SDK Manager để cài Android SDK Platform 34 và Android SDK Build-Tools 34.0.0.

Bước 2: Tải mã nguồn CleanYourTV

git clone https://github.com/Gathin23/cleanyourtv.git
cd cleanyourtv

Nếu không dùng Git, mở repository CleanYourTV trên GitHub, chọn Code → Download ZIP, giải nén rồi mở terminal trong thư mục vừa giải nén.

Bước 3: Cài thư viện Python của dự án

python -m venv tools\venv
tools\venv\Scripts\python.exe -m pip install -r tools\requirements.txt

Các lệnh trên tạo môi trường Python riêng cho công cụ CleanYourTV và cài thư viện cần thiết. Nếu báo không tìm thấy python, hãy kiểm tra Python đã được cài và có trong PATH.

Kết nối máy tính với TV qua Wi-Fi

Bước 1: Tìm địa chỉ IP của TV

Trên TV, mở Cài đặt → Mạng và Internet → Wi-Fi đang kết nối. Ghi lại IP, ví dụ 192.168.1.50. Đây chỉ là địa chỉ minh họa, hãy thay bằng IP thực tế.

Bước 2: Cho phép máy tính kết nối

Khi kết nối lần đầu, TV có thể hỏi “Allow USB debugging?”. Chọn Allow hoặc Always allow from this computer nếu đây là máy tính cá nhân đáng tin cậy.

Một số TV chỉ cung cấp Wireless debugging có mã ghép đôi. Hãy làm theo hướng dẫn ADB dành cho thiết bị đó; không mặc định mọi TV đều dùng cổng 5555.

Dùng PROMPT.md để trợ lý hỗ trợ thao tác

Trong thư mục cleanyourtv, mở file PROMPT.md: https://github.com/Gathin23/cleanyourtv/blob/main/PROMPT.md

Sao chép nội dung file vào Claude Code, Codex hoặc Gemini CLI có quyền chạy lệnh terminal. Thay <MODEL NAME HERE> bằng model TV thực tế, ví dụ Xiaomi Mi TV P1 55 inch hoặc TCL 55P8LS.

Prompt được thiết kế để trợ lý kết nối TV, kiểm tra ứng dụng, sao lưu, hỏi về lựa chọn của người dùng và xác minh thao tác. Hãy theo dõi từng bước và không chấp nhận thao tác tắt ứng dụng nếu chưa rõ chức năng.

Sao lưu và dọn ứng dụng quảng cáo

Bước 1: Sao lưu trạng thái ban đầu

Yêu cầu trợ lý lưu danh sách gói đã cài, danh sách gói đang bị vô hiệu hóa, thông tin model/firmware, cài đặt liên quan và kịch bản khôi phục. Dự án có lưu bản ghi phục hồi trong ~/.cleanyourtv/. Tuy nhiên, tools/disable.sh không tạo bản sao lưu đầy đủ toàn bộ ứng dụng và cài đặt.

Bước 2: Kiểm tra danh sách ứng dụng

Bước 3: Áp dụng danh sách đã kiểm chứng

Dự án có tools/disable.sh cho Linux/macOS và tools/disable.ps1 cho Windows. Ví dụ gọi script PowerShell (hãy kiểm tra cú pháp hiện tại trước khi chạy):

powershell -ExecutionPolicy Bypass -File tools\disable.ps1 -TvHost 192.168.1.50 examples\<thu-muc-model-tv>\debloat.txt

Thay IP và đường dẫn bằng thông tin chính xác. Chỉ dùng debloat.txt đã được xác nhận phù hợp với model và firmware. Không sao chép danh sách của TV khác một cách máy móc.

Sau khi thực hiện từng nhóm nhỏ, kiểm tra kết nối mạng, ứng dụng xem phim, âm thanh, HDMI, remote và khả năng khởi động TV.

Build và cài launcher CleanYourTV

Bước 1: Kiểm tra môi trường build

Launcher cần JDK 17, Android SDK Platform 34 và Android SDK Build-Tools 34.0.0.

Bước 2: Chạy script cài đặt

powershell -ExecutionPolicy Bypass -File launcher\build-and-install.ps1 -TvHost 192.168.1.50

Thay IP bằng địa chỉ TV. Script PowerShell sẽ build launcher, cài đặt và thực hiện các bước chuyển màn hình chính. Hãy đọc script, giữ kết nối ADB và không ngắt nguồn TV trong khi thao tác.

Bước 3: Kiểm tra sau cài đặt

1. Nhấn nút Home trên remote để kiểm tra launcher mới.
2. Mở YouTube và các ứng dụng streaming thường dùng.
3. Kiểm tra HDMI, Cài đặt, Wi-Fi, Bluetooth và các nút remote.
4. Khởi động lại TV và xác nhận launcher tiếp tục hoạt động.

Có thể tùy chỉnh dock, thứ tự ứng dụng, số cột, theme và hình nền theo tài liệu trong repository.

Khôi phục TV về trạng thái ban đầu

Bước 1: Khôi phục các gói ứng dụng

powershell -ExecutionPolicy Bypass -File tools\restore.ps1 -TvHost 192.168.1.50 examples\<thu-muc-model-tv>\debloat.txt

Kiểm tra cú pháp tools\restore.ps1 và dùng đúng file danh sách đã áp dụng. Giữ lại file này và bản ghi khôi phục.

Bước 2: Chuyển lại launcher gốc

Vào cài đặt màn hình chính mặc định của Android và chọn launcher gốc. Nếu launcher gốc đã bị tắt, hãy bật lại trước. Một số TV không có màn hình chọn launcher nên có thể cần khôi phục qua ADB.

Nếu không kết nối được máy tính, thử vào Cài đặt → Ứng dụng trên TV để bật lại ứng dụng nếu giao diện hệ thống còn truy cập được.

Bước 3: Tắt ADB sau khi hoàn tất

Tắt USB debugging và Network/ADB debugging, thu hồi quyền gỡ lỗi của máy tính nếu cần, rồi khởi động lại TV. ADB qua mạng có thể cho phép thiết bị khác truy cập TV nếu firmware có cấu hình bảo mật yếu.

Phương án dùng điện thoại Android

Dự án liên kết tới ứng dụng Android do cộng đồng phát triển tại https://cleanyour.tv/app. Ứng dụng cho phép kết nối, phân tích và dọn TV qua Wi-Fi mà không cần laptop hoặc trợ lý lập trình. Đây là ứng dụng cộng đồng; hãy xem kỹ quyền truy cập và danh sách thay đổi trước khi đồng ý.

Tổng kết

CleanYourTV phù hợp nếu bạn muốn thay giao diện Android TV/Google TV nhiều nội dung gợi ý bằng launcher tối giản và giảm một số ứng dụng cài sẵn không cần thiết. Cách an toàn nhất là xác định đúng model, sao lưu trạng thái, kiểm tra từng gói ứng dụng và chuẩn bị phương án khôi phục trước khi thay đổi màn hình chính.

Tài liệu chính thức

Repository CleanYourTV: https://github.com/Gathin23/cleanyourtv

README tiếng Việt: https://github.com/Gathin23/cleanyourtv/blob/main/README.vi.md

PROMPT.md: https://github.com/Gathin23/cleanyourtv/blob/main/PROMPT.md

Danh sách model TV: https://github.com/Gathin23/cleanyourtv/tree/main/examples