tvlauncher

TV Launcher 是一款适用于 Windows 和 Linux 的全屏、控制台风格应用启动器，使用 Python 和 PyQt6 编写。它以轮播界面展示已安装程序，专为电视或桌面屏幕上的休闲使用而设计，支持从 720p 到 4K 及更高分辨率的自动缩放。 输入与导航 支持 Xbox/PlayStation 风格的游戏手柄、键盘、蓝牙电视遥控器、鼠标和触摸操作。游戏手柄会定期自动检测，并伴有屏幕通知。每个按键或遥控器按钮均可通过设置中的按键重映射面板重新映射，映射配置可备份、恢复或重置为默认值。 库管理 程序扫描器可检测已安装的应用并提取其图标，缓存结果以加快后续加载速度。应用也可通过浏览可执行文件手动添加。条目可编辑、删除，通过快速搜索小部件搜索，并通过拖放重排模式重新排序，该模式会显示位置指示器。分类系统（默认包括游戏、媒体、程序、其他）支持过滤和快速分配；分类可添加、编辑或删除，支持自定义图标和颜色，并可选择默认分类用于启动。 封面与外观 封面艺术通过用户提供的免费 API 密钥从 SteamGridDB 自动获取，支持对现有条目手动下载，也支持本地自定义图片。背景可手动设置、从壁纸文件夹自动轮换，或替换为 Projectivy Overflight 风格的流媒体视频壁纸：视频从 JSON 目录（默认或自定义 URL）流式传输而非下载，支持可配置质量（1080p、1080p HDR、4K、4K HDR、自适应）、轮换间隔、静音开关和分类筛选。轮播可垂直移动以给视频留出空间，底部系统按钮栏在导航到之前自动隐藏。视频播放依赖 libmpv，在 Windows 上捆绑提供，在 Linux 上以系统级安装。 系统功能 设置包括视觉开关、配置备份/恢复、软重置（保留应用）与完全重置、更新检查器（通知新版本）、分类管理器、按城市配置的天气小部件，以及重启、睡眠、关机或关闭启动器等系统操作。家长控制系统通过 PIN 码锁定启动器。 安装与配置 Windows 和 Linux 由独立的分支/脚本处理。可通过虚拟环境和 requirements.txt 手动设置，或使用 installer.bat / installer.sh，它们会创建环境、安装依赖并提供一键启动脚本。两个平台均提供便携版；Windows 版是自包含文件夹，而 Linux 便携归档捆绑了 Python 运行时、包和带 XCB/Wayland 支持的 Qt6。配置文件（launcher_apps.json、key_mappings.json、scanner_cache.json）和磁贴图片在 Windows 上位于 %APPDATA%\Roaming\TVLauncher，在 Linux 上位于 ~/.config/TVLauncher，因此用户数据在更新后得以保留。提供了 Windows（启动文件夹或注册表）和 Linux（~/.config/autostart 桌面条目）的自动启动说明。 依赖项包括 PyQt6、psutil、pygame、requests、python-mpv，在 Windows 上还有 pycaw 和 pywin32。该项目采用 MIT 许可证，并附有关于游戏手柄权限、缺少 libmpv、Qt 平台/多媒体包、图片下载、应用启动和扫描缓存的故障排除说明。