tvlauncher

TV Launcher es un lanzador de aplicaciones a pantalla completa, estilo consola, para Windows y Linux, escrito en Python con PyQt6. Presenta los programas instalados en una interfaz de carrusel pensada para uso relajado en un televisor o pantalla de escritorio, con escalado automático desde 720p hasta 4K y más. Entrada y navegación Admite gamepads estilo Xbox/PlayStation, teclados, mandos Bluetooth de TV, ratón y táctil. Los gamepads se detectan automáticamente de forma periódica con notificaciones en pantalla. Cada tecla o botón del mando se puede reasignar mediante un panel de reasignación de teclas en Ajustes, y las asignaciones se pueden respaldar, restaurar o restablecer a los valores predeterminados. Gestión de la biblioteca Un escáner de programas detecta las aplicaciones instaladas y extrae sus iconos, almacenando los resultados en caché para acelerar las cargas posteriores. Las apps también se pueden añadir manualmente navegando hasta un ejecutable. Las entradas se pueden editar, eliminar, buscar con un widget de búsqueda rápida y reordenar mediante un modo de reordenación por arrastrar y soltar que muestra indicadores de posición. Un sistema de categorías (Juegos, Multimedia, Programas, Otros por defecto) permite filtrar y asignar rápidamente; las categorías se pueden añadir, editar o eliminar con iconos y colores personalizados, y se puede elegir una categoría predeterminada para el inicio. Carátulas y apariencia Las carátulas se obtienen automáticamente de SteamGridDB usando una clave API gratuita proporcionada por el usuario, con opción de descarga manual para entradas existentes y compatibilidad con imágenes locales personalizadas. Los fondos se pueden establecer manualmente, rotar automáticamente desde una carpeta de fondos de pantalla o sustituirse por fondos de video en streaming al estilo Projectivy Overflight: los videos se transmiten desde un catálogo JSON (URL predeterminada o personalizada) en lugar de descargarse, con calidad configurable (1080p, 1080p HDR, 4K, 4K HDR, adaptativa), intervalo de rotación, opción de silencio y filtros de categoría. El carrusel se puede desplazar verticalmente para dejar espacio al video, y la barra inferior de botones del sistema se oculta automáticamente hasta que se navega hacia ella. La reproducción de video depende de libmpv, incluida en Windows e instalada a nivel de sistema en Linux. Funciones del sistema Los ajustes incluyen opciones visuales, copia/restauración de configuración, reinicio suave (conservando las apps) frente a reinicio completo, un comprobador de actualizaciones que notifica sobre nuevas versiones, un gestor de categorías, un widget del tiempo configurado por ciudad y acciones del sistema para reiniciar, suspender, apagar o cerrar el lanzador. Un sistema de control parental bloquea el lanzador tras un código PIN. Instalación y configuración Windows y Linux se gestionan mediante ramas/scripts separados. La instalación se puede hacer manualmente con un entorno virtual y requirements.txt, o mediante installer.bat / installer.sh, que crean el entorno, instalan las dependencias y proporcionan scripts de inicio con un solo clic. Se ofrecen compilaciones portátiles para ambas plataformas; la compilación de Windows es una carpeta autocontenida, mientras que el archivo portátil de Linux incluye un runtime de Python, paquetes y Qt6 con soporte XCB/Wayland. Los archivos de configuración (launcher_apps.json, key_mappings.json, scanner_cache.json) y las imágenes de los mosaicos residen en %APPDATA%\Roaming\TVLauncher en Windows y en ~/.config/TVLauncher en Linux, por lo que los datos del usuario sobreviven a las actualizaciones. Se dan instrucciones de inicio automático para Windows (carpeta de Inicio o registro) y Linux (entrada de escritorio en ~/.config/autostart). Las dependencias incluyen PyQt6, psutil, pygame, requests, python-mpv y, en Windows, pycaw y pywin32. El proyecto tiene licencia MIT, con notas de solución de problemas para permisos de gamepad, libmpv ausente, paquetes de plataforma/multimedia de Qt, descargas de imágenes, inicio de apps y caché del escáner.