tvlauncher

TV Launcher는 Python과 PyQt6로 작성된 Windows 및 Linux용 전체 화면 콘솔 스타일 애플리케이션 런처입니다. TV나 데스크톱 화면에서 편안하게 사용하도록 설계된 캐러셀 인터페이스로 설치된 프로그램을 표시하며, 720p부터 4K 이상까지 자동으로 크기가 조정됩니다. 입력 및 탐색 Xbox/PlayStation 스타일 게임패드, 키보드, 블루투스 TV 리모컨, 마우스 및 터치를 지원합니다. 게임패드는 주기적으로 자동 감지되며 화면에 알림이 표시됩니다. 모든 키 또는 리모컨 버튼은 설정의 키 리매퍼 패널을 통해 다시 매핑할 수 있으며, 매핑은 백업, 복원 또는 기본값으로 재설정할 수 있습니다. 라이브러리 관리 프로그램 스캐너가 설치된 애플리케이션을 감지하고 아이콘을 추출하며, 이후 로딩 속도를 높이기 위해 결과를 캐시합니다. 실행 파일을 찾아 수동으로 앱을 추가할 수도 있습니다. 항목은 편집, 삭제, 빠른 검색 위젯을 통한 검색이 가능하며, 위치 표시기를 보여주는 드래그 앤 드롭 재정렬 모드를 통해 순서를 변경할 수 있습니다. 카테고리 시스템(기본값: 게임, 미디어, 프로그램, 기타)을 통해 필터링 및 빠른 할당이 가능하며, 사용자 지정 아이콘과 색상으로 카테고리를 추가, 편집 또는 삭제할 수 있고 실행 시 기본 카테고리를 선택할 수 있습니다. 아트워크 및 모양 커버 아트는 사용자가 제공한 무료 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 플랫폼/멀티미디어 패키지, 이미지 다운로드, 앱 실행 및 스캐너 캐싱에 대한 문제 해결 노트가 포함되어 있습니다.