CLI

터미널에서 javinfo를 사용하세요. javinfo CLI로 작품을 조회하고, LAN에서 스트리밍하며, 라이브러리를 정리하세요.

javinfo CLI는 Linux와 macOS용 네이티브 바이너리로, javinfo API를 터미널에서 사용할 수 있게 해줍니다. 세 가지 역할을 담당합니다: 빠른 조회, 로컬 네트워크에서 작품 재생, 그리고 이미 보유한 파일로 Kodi/Jellyfin 라이브러리 구축.

설치

Rust 도구 체인 없이 한 줄이면 됩니다:

한 줄 설치

curl -fsSL https://javinfo.dev/install.sh | bash

스크립트가 OS와 CPU를 감지해 일치하는 사전 빌드된 바이너리를 다운로드하고, 체크섬을 검증한 뒤 ~/.local/bin에 설치합니다. 해당 디렉터리가 PATH에 있는지 확인하세요.

다른 방법을 원하세요?

사전 빌드 바이너리: 릴리스 페이지에서 아카이브를 받으세요. Linux x86_64, Linux arm64, macOS Apple Silicon용이 제공되며, macOS Intel과 Windows는 소스 빌드가 필요합니다.
소스에서: cargo install --path .(Rust 1.85+) 또는 cargo build --release 후 target/release/javinfo를 직접 사용하세요.

키 설정

대시보드에서 키(jvi_로 시작)를 받은 뒤:

javinfo login                    # 키를 입력하라는 프롬프트 표시
# 또는 비대화형으로:
javinfo login --api-key jvi_your_key_here
# 또는 로그인을 건너뛰고 환경 변수 사용:
export JAVINFO_API_KEY=jvi_your_key_here

login은 또한 PATH에서 비디오 플레이어(vlc, mpv, ffplay, iina 등)를 스캔하여 나중에 open 명령이 플레이어를 실행할 수 있게 합니다. 키는 ~/.config/javinfo/config.toml에 모드 0600으로 저장됩니다.

작품 조회

movie는 API의 제공업체 워터폴을 통해 DVD 코드를 조회하고 사람이 읽을 수 있는 요약을 출력합니다:

javinfo movie EBOD-391
javinfo movie SSIS-001 --json          # 전체 JSON 응답
javinfo movie CAWD-001 --providers fanza,missav   # 제공업체 고정

LAN에서 재생

open은 로컬 재스트리밍 데몬을 시작(필요 시)하고 네트워크의 모든 기기가 열 수 있는 재생 URL을 출력합니다:

javinfo open EBOD-391
javinfo open EBOD-391 --with vlc       # 플레이어도 함께 실행
javinfo open EBOD-391 --with mpv

URL은 http://<your-lan-ip>:8787/s/<token>/EBOD-391.m3u8를 가리킵니다. 데몬이 제공업체에서 스트림을 가져와 올바른 헤더를 주입하고, 화질을 제한하며(기본 --max-height 1080), 로컬에서 다시 제공합니다. 각 세션은 불투명한 토큰을 사용하므로 코드만으로는 데몬에 접근할 수 없습니다. 데몬 수명 주기:

javinfo serve start                    # 백그라운드에서 실행
javinfo serve status
javinfo serve stop

라이브러리 정리

nfo는 폴더(또는 단일 파일)를 스캔하여 각 DVD 코드를 API와 매칭하고, 비디오 옆에 Kodi와 Jellyfin 사이드카(.nfo 메타데이터, 포스터, 팬아트, 썸네일, 트레일러)를 작성합니다:

javinfo nfo ~/Videos/JAV --dry-run     # 계획 미리보기, 아무것도 변경하지 않음
javinfo nfo ~/Videos/JAV --write       # 폴더 생성 및 이름 변경: SSIS-001/SSIS-001.mp4
javinfo nfo ~/Videos/SSIS-001.mkv      # 단일 파일

--write를 전달하지 않으면 아무것도 이름이 바뀌거나 이동하지 않으며, 기존 .nfo 파일은 건드리지 않습니다(--force로 새로고침). 메타데이터는 기본적으로 fanza,dmm에서 가져옵니다. --write torrent는 javdb로 전환하고 토렌트 및 마그넷 파일도 함께 생성합니다.

설정 확인

status는 CLI가 로컬 설정에 대해 알고 있는 정보(키 출처(마스킹됨), 구성된 플레이어, 그리고 서브 데몬 실행 여부)를 보여줍니다:

javinfo status
javinfo status --json

직접 만들어 보세요

CLI는 오픈소스(MIT)입니다. 원하는 기능이 빠져 있나요? 직접 커스터마이즈하세요. Pull Request는 언제나 환영하며, fork해서 여러분만의 것으로 만들어도 좋습니다. 소스 코드를 가져가세요: github.com/javinfo/cli.

CLI가 감싸고 있는 모든 것을 확인하려면 API 문서를 읽어보세요.
메타데이터와 스트림이 어디서 오는지 이해하려면 제공업체를 보세요.
속도 제한 및 요금을 확인하세요. CLI는 REST API와 마찬가지로 성공적인 조회마다 청구됩니다.

설치