f1viewer

F1TV 콘텐츠 탐색 및 재생

f1viewer는 F1TV 계정에 로그인하여 라이브 레이싱 세션, 하이라이트 영상, 다큐멘터리 등을 탐색하고 재생할 수 있습니다. 사용자는 터미널 내에서 화살표 키나 hjkl 키를 통해 메뉴를 탐색하고 엔터 키로 선택할 수 있습니다.

외부 플레이어 연동

실제 영상 재생은 MPV와 같은 외부 미디어 플레이어를 통해 이루어집니다. f1viewer는 콘텐츠의 URL을 외부 플레이어에 전달하여 재생을 처리하며, 사용자는 config 파일을 통해 기본 플레이어를 MPV에서 다른 플레이어로 변경할 수 있습니다.

구성 가능한 키 바인딩

기본 키 바인딩은 다음과 같습니다:
– 화살표 키 또는 h, j, k, l: 메뉴 탐색
– 탭 키: 로그인 폼 필드 순환
– 엔터 키: 선택/확인
– q 키: 애플리케이션 종료
사용자는 이러한 키 바인딩을 선호에 따라 변경할 수 있습니다.

커스텀 명령 및 멀티 명령

f1viewer는 TOML 형식의 config 파일을 통해 커스텀 명령을 정의할 수 있습니다. 예를 들어, FFmpeg를 사용하여 스트림을 MP4 파일로 다운로드하는 명령을 추가할 수 있습니다. 또한, 멀티 명령을 통해 하나의 액션에 여러 명령을 매핑할 수 있으며, 라이브 세션 훅을 통해 새로운 라이브 세션이 감지될 때 자동으로 특정 명령을 실행할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 다음 방법 중 하나로 f1viewer를 설치할 수 있습니다:

• GitHub 릴리스 페이지에서 최신 버전의 ZIP 파일을 직접 다운로드하여 압축 해제 후 실행
• Chocolatey 패키지 관리자를 사용하여 설치: chocolatey install f1viewer

설치 후, 호환되는 미디어 플레이어(예: MPV)가 별도로 설치되어 있어야 하며, 해당 플레이어의 실행 경로가 시스템 PATH에 포함되어 있어야 f1viewer가 이를 감지할 수 있습니다.

기본 사용법/명령어

f1viewer를 실행하면 자동으로 로그인 화면이 표시됩니다. F1TV 계정의 이메일과 비밀번호를 입력하여 로그인해야 합니다. 다만, 현재 F1TV의 반봇 조치로 인해 이메일/비밀번호 로그인은 작동하지 않을 수 있으며, 이 경우 위키 페이지의 안내에 따라 구독 토큰을 사용하여 로그인해야 합니다.

로그인 성공 후, 화살표 키나 hjkl 키를 통해 콘텐츠 목록을 탐색하고 엔터 키로 선택할 수 있습니다. q 키를 누르면 애플리케이션을 종료할 수 있습니다. 구성 파일에 접근하려면 f1viewer -config 명령을 실행할 수 있으며, 로그 파일을 보려면 f1viewer -logs 명령을 실행할 수 있습니다.

이런 경우에 유용합니다

이 프로그램은 다음과 같은 사용자에게 유용합니다:
– F1TV 구독자이지만 웹 브라우저나 공식 앱 대신 터미널 환경에서 콘텐츠를 시청하고 싶은 사용자
– 스크립트나 자동화를 통해 F1TV 콘텐츠를 다운로드하거나 처리하고 싶은 사용자
– 터미널 기반 워크플로우를 선호하고, 키보드만으로 미디어 재생을 제어하고 싶은 사용자
– 외부 플레이어(예: MPV)를 통해 고급 재생 옵션(자막, 필터, 녹화 등)을 활용하고 싶은 사용자

지원 환경·시스템 요구사항

f1viewer는 Windows, macOS, Linux 등 주요 운영 체제를 지원합니다. Windows에서는 ZIP 형식의 바이너리 또는 Chocolatey 패키지를 통해 설치할 수 있습니다. 실행에는 Go 런타임이 필요하지 않으며, 사전 컴파일된 바이너리를 제공합니다. 다만, 실제 영상 재생을 위해서는 MPV와 같은 호환되는 미디어 플레이어가 별도로 설치되어 있어야 하며, 해당 플레이어의 실행 경로가 시스템 PATH 환경 변수에 포함되어 있어야 합니다.

최신 버전·업데이트

현재 버전은 2.7.0이며, 최신 릴리스 정보와 업데이트 내역은 GitHub 저장소의 “Releases” 페이지에서 확인할 수 있습니다. 업데이트는 최신 릴리스 페이지에서 새로운 바이너리를 다운로드하거나, Chocolatey를 사용하는 경우 chocolatey upgrade f1viewer 명령을 통해 수행할 수 있습니다.

제한 사항·확인 사항

다음 사항을 확인하고 사용해야 합니다:
– f1viewer 자체는 영상 재생을 처리하지 않으며, MPV와 같은 외부 미디어 플레이어가 필수적으로 설치되어 있어야 합니다.
– 현재 F1TV의 반봇 조치로 인해 이메일/비밀번호를 통한 로그인이 작동하지 않을 수 있으며, 이 경우 위키 페이지의 안내에 따라 구독 토큰을 사용하여 로그인해야 합니다.
– 라이브 세션 재생 시 F1TV 서버 과부하로 인해 로딩이 느려지거나 오류가 발생할 수 있으며, 이는 f1viewer에서 해결할 수 없는 외부 문제입니다.
– 외부 플레이어를 통해 재생 중 발생하는 오류(예: 코덱 문제, 자막 오류)는 해당 플레이어의 문서를 참조하여 문제 해결해야 합니다.
– 플레이어가 감지되지 않는 경우, 해당 플레이어의 실행 파일이 시스템 PATH 환경 변수에 포함되어 있는지 확인해야 합니다.