터미널에서 직접 영화 검색 및 토렌트 실행이 가능한 CineCLI

• CineCLI는 터미널 환경에서 영화 정보를 검색하고 토렌트를 직접 실행할 수 있는 크로스플랫폼 CLI 도구
• YTS API를 통해 영화 데이터를 불러오며, 최고 품질과 건강한 시드를 자동으로 선택
• Python 3.11+ 기반으로 제작되었으며, Typer와 Rich를 사용해 직관적인 인터페이스 제공
• Nix/NixOS 환경에서는 별도 설치 없이 실행 가능하며, magnet 링크를 OS 기본 토렌트 클라이언트로 전달
• 단순한 명령형 검색부터 대화형 모드까지 지원해, 개발자와 영화 애호가 모두에게 유용한 도구

CineCLI 개요

• CineCLI는 터미널에서 영화 토렌트를 탐색, 확인, 실행할 수 있는 빠르고 미니멀한 CLI 애플리케이션
  • Linux, macOS, Windows에서 모두 작동
  • rich 기반의 시각적으로 깔끔한 터미널 UI 제공
• YTS API를 사용해 영화 정보를 검색하고, 결과를 ID·제목·연도·평점 형태로 표시
• 사용자는 영화 ID를 선택해 세부 정보를 확인하고, 원하는 토렌트를 선택하거나 자동 선택 기능을 이용 가능

주요 기능

• 영화 검색: cinecli search <제목> 명령으로 YTS에서 영화 검색
• 세부 정보 보기: 선택한 영화의 상세 정보와 이용 가능한 토렌트 목록 표시
• 자동 토렌트 선택: 최고 화질과 건강한 시드를 기준으로 자동 선택
• 토렌트 실행: magnet 링크를 OS에 등록된 기본 클라이언트(qBittorrent, Transmission 등)로 전달
• .torrent 파일 다운로드 옵션 제공
• 대화형 모드(interactive) 지원으로, 검색→선택→다운로드 과정을 단계적으로 수행

설치 및 실행

• pip 설치: pip install cinecli
  • Python 3.11 이상 필요
• Nix/NixOS 지원:
  • flake 기반으로 Python이나 pip 설치 없이 실행 가능
  • nix run github:eyeblech/cinecli 명령으로 바로 실행
  • nix profile add github:eyeblech/cinecli로 프로필에 추가 가능
• 소스 코드 설치(개발자용) : git clone https://github.com/eyeblech/cinecli.git cd cinecli pip install -e .

사용 예시

• 검색 예시 cinecli search matrix 결과 예시: ID Title Year Rating 3525 The Matrix 1999 8.7 3526 The Matrix Reloaded 2003 7.2
• 영화 시청 명령 cinecli watch 3525
  • 영화 세부 정보 표시
  • 이용 가능한 토렌트 목록 출력
  • 자동 또는 수동 선택 후 magnet 실행 또는 .torrent 다운로드

기술 스택

• Python 기반
• Typer: CLI 프레임워크
• Rich: 터미널 UI 구성
• Requests: API 통신
• YTS API: 영화 데이터 소스

기타 정보

• MIT 라이선스로 공개되어 자유로운 사용 및 수정 가능
• YTS API 상태는 15분마다 자동 모니터링되며, 정상(🟢) 또는 장애(🔴) 상태로 표시
• 오픈소스 프로젝트로, PR과 별표(⭐) 참여를 환영
• 제작자: eyeblech (이메일: 0x1123@proton.me)