El menú de canales de la Wii como pantalla de inicio de tu Android TV.

wii-tv cambia la pantalla de inicio de un Android TV por un menú al estilo del Menú Wii: doce canales por página, el reloj de segmentos, la fecha, los botones redondos, la manito que sigue a lo que elegís y sonidos al moverte. Cada canal es una de tus apps, con su propio banner. Al prender la TV aparece una pantalla de aviso blanca, como en la consola, y con OK pasás al menú.

Lo mostré en X: Le puse la interfaz de la Wii a mi TV.

English: README.en.md

wii-tv es un proyecto de fans. No está afiliado a Nintendo ni tiene su aprobación. "Wii" es una marca de Nintendo.

El repositorio no trae nada de Nintendo: ni logos, ni tipografías, ni imágenes, ni sonidos. Todo lo que se ve está dibujado por código (WiiMenuView, WiiBase, WiiPalette) y los sonidos se sintetizan con tools/sounds/make_sounds.py.

• Canales: 4 columnas por 3 filas por página. La primera columna de la página siguiente asoma a la derecha y las flechas cambian de página. Tus apps llenan los canales y los que sobran quedan vacíos.
• Reloj y fecha: reloj de segmentos de 12 horas con AM/PM, y la fecha corta en el idioma de la TV.
• Botones de abajo:
  • wiiOS (izquierda) abre los Ajustes de Android TV.
  • SD abre el reproductor multimedia de la TV (pendrive o disco USB).
  • Sobre (derecha) abre la lista de entradas HDMI y la TV en vivo.
• Manito que sigue al canal o botón elegido.
• Canal Mii: el primer canal. La plaza con tus Miis paseando sobre el piso de cuadrados, los botones de los costados (editar, crear, borrar, ayuda, desfile, mensajes), el silbato que los ordena por nombre, favoritos, color o género, y el editor para crearlos y cambiarlos. Los Miis se guardan en la TV. Sin nada más, todo se dibuja por código; con el paquete del canal usa las caras, los pelos, los íconos y los sonidos originales. El repositorio no trae esos archivos: tools/miipack los toma de sus páginas públicas y arma el paquete en tu computadora.
• Canal Juegos: al lado del Canal Mii. Su cartel es una pradera pixelada con un personajito azul que salta piedras y junta gemas. Adentro, tus juegos son cartuchos en un estante: elegís uno, apretás Jugar y arranca en RetroArch con mGBA (Game Boy, Game Boy Color y Game Boy Advance). El botón RetroArch abre sus ajustes. Los juegos no vienen con el repositorio: ver Juegos.
• Sonidos al moverte, al abrir algo, al cambiar de página, al abrir las entradas y al continuar desde el aviso. Usan el volumen de la TV.
• Música del menú (opcional): el arranque y la música en bucle, como en la consola, con tus propios archivos. Ver Música del menú.
• Pantalla de aviso al prender la TV. La cierran OK o las flechas, o se va sola a los 12 segundos. No vuelve a aparecer cuando salís de una app.
• Siempre arranca en el menú: al prender la TV vuelve al menú aunque hayas dejado otra app abierta.
• Protector de pantalla con reloj (opcional).

Probado en una Philips 65PUD7906/77 (Android TV 11, 1920 x 1080). Debería andar en cualquier Android TV 8.0 o posterior con pantalla 16:9.

• Una computadora con macOS o Linux en la misma red que la TV. En Windows también se puede instalar (ver el paso 5).
• Python 3.10 o posterior.
• JDK 17 y el Android SDK con platforms;android-34 y build-tools;34.0.0. Android Studio trae los dos. En macOS también sirve brew install openjdk@17 android-commandlinetools.
• La depuración activada en la TV (paso 1).

Corré todos los comandos desde la carpeta del repositorio. Cambiá 192.168.1.50 por la IP de tu TV.

1. Ajustes → Preferencias del dispositivo → Información: tocá Compilación siete veces, hasta que diga que ya sos desarrollador.
2. Ajustes → Preferencias del dispositivo → Opciones para desarrolladores: activá Depuración por USB, y también Depuración por red o ADB por red si tu TV lo muestra.
3. Anotá la IP de la TV: Ajustes → Red e Internet → tu red.

git clone https://github.com/MauroProto/wii-tv.git
cd wii-tv
python3 -m venv tools/venv
tools/venv/bin/pip install -r tools/requirements.txt
TV_HOST=192.168.1.50 tools/venv/bin/python tools/tv.py --probe

La primera vez la TV pregunta si permitís la depuración. Marcá "Permitir siempre desde esta computadora" y aceptá. --probe muestra el modelo y la versión de Android.

La clave que autoriza a tu computadora queda en tools/adbkey/. Git la ignora; no la compartas, porque da acceso a la TV.

TV_HOST=192.168.1.50 tools/backup.sh

Guarda en backups/<modelo>/<fecha>/ la lista de apps (activas, desactivadas, de sistema y las que instalaste vos), cuál es la pantalla de inicio, los ajustes y una captura de pantalla. Git ignora esa carpeta: tiene el número de serie y los nombres de red de tu TV.

Las apps se desactivan, no se desinstalan, y se pueden volver a activar (ver "Deshacer todo").

TV_HOST=192.168.1.50 tools/disable.sh examples/philips-65pud7906/debloat.txt

• examples/philips-65pud7906/debloat.txt es la lista que se usó en la Philips 65PUD7906. Revisala y poné # adelante de lo que quieras conservar.
• Para otras marcas y modelos, cleanyourtv tiene más de cien listas probadas. Copiá la de tu TV a examples/<tu-tv>/debloat.txt.
• disable.sh guarda lo necesario para deshacer en ~/.cleanyourtv/, y no desactiva la app dueña de tu red Wi-Fi.

TV_HOST=192.168.1.50 launcher/build-and-install.sh

El script:

1. compila la app de launcher/,
2. la instala y comprueba que abre,
3. desactiva el launcher original (com.google.android.tvlauncher en Android TV, com.google.android.apps.tv.launcherx en Google TV),
4. deja wiiOS como pantalla de inicio y verifica que Home lo abra. Si algo sale mal, vuelve a activar el launcher original.

Apretá Home en el control para verlo. Si preferís no desactivar el launcher original, usá STOCK_LAUNCHER=none. Ojo: en muchas TVs el launcher original tiene prioridad, y mientras siga activo Home lo va a seguir abriendo.

En Windows, con PowerShell:

python -m venv tools\venv
tools\venv\Scripts\pip install -r tools\requirements.txt
powershell -ExecutionPolicy Bypass -File launcher\build-and-install.ps1 -TvHost 192.168.1.50

Mientras la depuración esté activada, cualquier computadora que ya autorizaste puede manejar la TV por la red. Cuando termines:

1. Ajustes → Opciones para desarrolladores: desactivá la depuración por USB y por red. Si querés, tocá también "Revocar autorizaciones de depuración".
2. Reiniciá la TV.
3. Comprobá que quedó cerrada: tools/venv/bin/python tools/adb-closed.py 192.168.1.50

El canal Juegos arranca tus juegos en RetroArch. Usá solo juegos tuyos: copiá tus propios cartuchos con un lector de cartuchos (por ejemplo GB Operator o GBxCart RW).

1. Instalá RetroArch en la TV. La mayoría de los Android TV son de 32 bits y necesitan RetroArch_ra32.apk, de la página de descargas de RetroArch. Abrilo una vez y bajá el núcleo: Actualizador en línea → Descargar núcleos → Nintendo - Game Boy Advance (mGBA). Salí con Home.
2. Preparalo para el control de la TV (una sola vez):

   TV_HOST=192.168.1.50 tools/venv/bin/python tools/games/add.py --setup

   Agrega el mapa de botones de tools/games/retroarch/ y cambia algunos ajustes de RetroArch: OK elige y Atrás vuelve, mantener el botón rojo abre su menú y el juego se guarda cada 10 segundos. Antes guarda una copia de los ajustes en retroarch.cfg.before-wii-tv, en la carpeta de RetroArch de la TV. Si usás un joystick Bluetooth, en RetroArch elegí además Actualizador en línea → Actualizar perfiles de controles.
3. Sumá tus juegos (.gba, .gb o .gbc):

   TV_HOST=192.168.1.50 tools/venv/bin/python tools/games/add.py "Mi juego.gba" --title "Mi juego"

   Copia el archivo a RetroArch/roms/ en la TV y lo pone en el estante. --color "#E8432E" elige el color de la etiqueta. --list muestra los juegos, y --remove "Mi juego" saca uno (con --delete también borra el archivo de la TV).

Con el control de la TV, durante el juego:

Si elegís otro juego, o el botón RetroArch del canal, RetroArch cierra el juego que estaba abierto. Lo que guardaste dentro del juego llega al archivo en 10 segundos como mucho, así que esperá un momento antes de cambiar de juego. El mapa de botones es para los controles de las TVs Philips (receptor "MStar Smart TV IR Receiver"); con otro control, configuralo en RetroArch → Ajustes → Entrada.

El Menú Wii puede tener música de fondo, como en la consola: cuando cerrás la pantalla de aviso suena el arranque junto con la música, y después la música sigue en bucle. Suena solo en el menú: se apaga al abrir un canal, una app, los ajustes o el protector de pantalla, y vuelve a empezar cuando volvés. Si otra app está reproduciendo algo (por ejemplo música que dejaste sonando), el menú espera a que termine.

La app no trae música. Poné la tuya con tools/music/add.py, que necesita ffmpeg en la computadora:

TV_HOST=192.168.1.50 tools/venv/bin/python tools/music/add.py musica.flac --start arranque.flac --loop 12.5 48

• --loop INICIO FIN, en segundos: la música suena hasta FIN y sigue desde INICIO, una y otra vez. El último segundo y medio antes de FIN se funde con lo que suena justo antes de INICIO, así no se nota el salto (--crossfade cambia cuánto dura). Sin --loop se repite el archivo entero.
• --start es opcional: un sonido de arranque que se mezcla con el principio de la música. Si está, reemplaza al sonido de arranque del menú.
• Lee los formatos que lee ffmpeg (mp3, flac, ogg, m4a, wav) y los guarda en la TV como WAV, en la carpeta de wiiOS. Con adb instalado (o ADB=/ruta/a/adb), la copia tarda un segundo.
• --remove saca la música, y --out carpeta solo arma los archivos, sin tocar la TV.

Cambiá lo que quieras y volvé a correr launcher/build-and-install.sh para aplicarlo.

Para ver los nombres de paquete de tus apps:

TV_HOST=192.168.1.50 tools/venv/bin/python tools/tv.py 'pm list packages -3'

Protector de pantalla con reloj:

TV_HOST=192.168.1.50 tools/venv/bin/python tools/tv.py 'settings put secure screensaver_components com.gathin.tvhome/.ClockDream'

Para reactivar las apps que desactivaste y volver al launcher original, pasá la misma lista que usaste:

TV_HOST=192.168.1.50 tools/restore.sh examples/philips-65pud7906/debloat.txt com.google.android.tvlauncher

En Google TV el último argumento es com.google.android.apps.tv.launcherx. Después podés desinstalar wiiOS:

TV_HOST=192.168.1.50 tools/venv/bin/python tools/tv.py 'pm uninstall com.gathin.tvhome'

Si solo querés volver al launcher original, sin tocar las demás apps:

TV_HOST=192.168.1.50 tools/venv/bin/python tools/tv.py 'pm enable --user 0 com.google.android.tvlauncher'
TV_HOST=192.168.1.50 tools/venv/bin/python tools/tv.py 'cmd package set-home-activity --user 0 com.google.android.tvlauncher/.MainActivity'

• Home sigue abriendo el launcher viejo. En Google TV, el asistente de configuración (com.google.android.tungsten.setupwraith) también puede reclamar Home. Mirá la guía de problemas de cleanyourtv antes de desactivarlo: en algunas TVs es el dueño del Wi-Fi.
• Falta una app. El menú muestra las apps hechas para TV. Fijate que no esté en hidden_apps.
• El botón SD dice "No disponible". Tu TV no tiene el reproductor de MediaTek; poné el de tu TV en MEDIA_PLAYER.
• Un juego no arranca. Fijate que RetroArch tenga el núcleo mGBA (paso 1 de Juegos) y que el juego aparezca en tools/games/add.py --list.
• No se escuchan los sonidos. Suben y bajan con el volumen de la TV. Fijate que wii_sounds sea true.
• No suena la música del menú. Fijate que la hayas cargado con tools/music/add.py y que wii_music sea true. Si otra app está reproduciendo algo en segundo plano, el menú espera a que pare.
• tv.py no conecta. La TV y la computadora tienen que estar en la misma red, con la depuración activada, y tenés que aceptar el aviso en la pantalla de la TV.

• launcher/ es una app Android en Java. WiiMenuActivity es la pantalla de inicio y WiiMenuView dibuja todo: canales, reloj, botones, manito, aviso y la lista de entradas. WiiBase y WiiPalette calculan el fondo rayado y los paneles píxel por píxel, en un hilo aparte. WiiSounds reproduce los sonidos y MenuMusic, la música del menú.
• GamesActivity y GamesView son el canal Juegos; PixelScene dibuja la pradera del cartel y PixelArt los cartuchos y las letras. GameList lee games.txt y RetroArch arma el pedido para abrir cada juego.
• La app también trae el launcher de cleanyourtv (MainActivity). Ya no es la pantalla de inicio, pero sigue en el código.
• tools/ tiene un cliente ADB por red en Python (tv.py, no hace falta instalar adb), los scripts para desactivar y restaurar apps, el respaldo, el generador de sonidos, games/add.py para los juegos y music/add.py para la música del menú.
• tests/ prueba los scripts contra una TV simulada: python3 -m unittest discover -s tests.

• Basado en cleanyourtv de Gathin (licencia MIT): las herramientas ADB, los scripts para desactivar y restaurar apps y la base del launcher.
• Tipografía Outfit, con licencia SIL Open Font License 1.1 (launcher/FONT-LICENSE-OFL.txt).
• Licencia MIT: ver LICENSE.