Một repo dọn rác cho Android TV & Google TV vừa cán mốc 44.000 sao GitHub chỉ sau 12 ngày.
https://github.com/Gathin23/cleanyourtv
Cách làm khá thú vị: nó dùng các trợ lý dòng lệnh (Claude Code, Gemini CLI...) kết nối vào TV qua Wi-Fi để dọn sạch bloatware và thay màn hình chính mới.
Vài điểm đáng tiền:
> Hết cảnh màn hình ngập quảng cáo: Xóa sạch các hàng tài trợ, chỉ giữ lại đúng thanh 4 app hay mở.
> Tắt theo dõi ngầm: Chặn các dịch vụ đo lường và phân phối quảng cáo mặc định của nhà sản xuất.
> An toàn, không root: Chỉ dùng lệnh tắt app mặc định của Android. Tool tự sao lưu trạng thái trước khi chạy, muốn quay về ban đầu chỉ tốn 1 dòng lệnh.
> Hỗ trợ rộng: Tự quét cấu hình riêng của từng máy để tránh tắt nhầm ứng dụng bạn đang dùng. Hiện đã có profile chuẩn cho 359 dòng TV từ 97 hãng khác nhau.
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
| Nhóm ứng dụng | Hướng xử lý |
|---|---|
| Dịch vụ quảng cáo/gợi ý của nhà sản xuất | Cân nhắc tắt sau khi kiểm tra chức năng. |
| Dịch vụ phân tích/thu thập dữ liệu | Xem xét theo model và chức năng. |
| Ứng dụng cài sẵn không dùng | Kiểm tra khả năng tắt trước khi quyết định. |
| Google Play Services, System UI, trình cài đặt gói, cài đặt hệ thống | Giữ nguyên. |
| Dịch vụ HDMI, remote, Bluetooth, bàn phím | Giữ nguyên. |
| Chromecast, trợ lý giọng nói, cập nhật hệ thống | Hỏi người dùng trước khi thay đổi. |
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
- Nhấn nút Home trên remote để kiểm tra launcher mới.
- Mở YouTube và các ứng dụng streaming thường dùng.
- Kiểm tra HDMI, Cài đặt, Wi-Fi, Bluetooth và các nút remote.
- 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
Đăng nhận xét