CLI

javinfo CLI là một chương trình nhị phân gốc cho Linux và macOS, đưa javinfo API vào terminal của bạn. Nó đảm nhận ba việc: tra cứu nhanh, phát tựa đề qua mạng nội bộ và xây dựng thư viện Kodi/Jellyfin từ những file bạn đã có.

Cài đặt

Một dòng lệnh, không cần Rust toolchain:

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

Script sẽ phát hiện hệ điều hành và CPU của bạn, tải về chương trình nhị phân được biên dịch sẵn phù hợp, xác minh checksum và cài vào ~/.local/bin. Hãy chắc chắn thư mục đó nằm trong PATH của bạn.

Muốn cách khác?

• Chương trình nhị phân được biên dịch sẵn: tải file nén từ trang Releases. Có sẵn cho Linux x86_64, Linux arm64 và macOS Apple Silicon; macOS Intel và Windows cần biên dịch từ mã nguồn.
• Từ mã nguồn: cargo install --path . (Rust 1.85+), hoặc cargo build --release rồi dùng trực tiếp target/release/javinfo.

Thiết lập khóa

Lấy một khóa (bắt đầu bằng jvi_) từ bảng điều khiển, sau đó:

javinfo login                    # nhắc nhập khóa
# hoặc không tương tác:
javinfo login --api-key jvi_your_key_here
# hoặc bỏ qua đăng nhập hoàn toàn bằng biến môi trường:
export JAVINFO_API_KEY=jvi_your_key_here

login cũng quét PATH của bạn để tìm trình phát video (vlc, mpv, ffplay, iina, …) để lệnh open sau này biết cách khởi chạy chúng. Khóa được lưu tại ~/.config/javinfo/config.toml với quyền 0600.

Tra cứu tựa đề

movie phân giải mã DVD thông qua waterfall nhà cung cấp của API và in ra bản tóm tắt dễ đọc:

javinfo movie EBOD-391
javinfo movie SSIS-001 --json          # toàn bộ phản hồi JSON
javinfo movie CAWD-001 --providers fanza,missav   # ghim nhà cung cấp

Phát qua LAN

open khởi động một daemon re-stream cục bộ (nếu cần) và in ra một URL phát mà mọi thiết bị trên mạng của bạn đều mở được:

javinfo open EBOD-391
javinfo open EBOD-391 --with vlc       # đồng thời khởi chạy trình phát
javinfo open EBOD-391 --with mpv

URL trỏ tới http://<your-lan-ip>:8787/s/<token>/EBOD-391.m3u8. Daemon lấy stream từ nhà cung cấp, chèn các header phù hợp, giới hạn chất lượng (mặc định --max-height 1080) và phát lại cục bộ. Mỗi phiên dùng một token không minh bạch, nên chỉ riêng mã số không thể truy cập daemon. Vòng đời daemon:

javinfo serve start                    # chạy nền
javinfo serve status
javinfo serve stop

Tổ chức thư viện

nfo quét một thư mục (hoặc một file đơn lẻ), khớp từng mã DVD với API và ghi các file sidecar cho Kodi và Jellyfin (metadata .nfo, poster, fanart, thumb và trailer) ngay cạnh video của bạn:

javinfo nfo ~/Videos/JAV --dry-run     # xem trước kế hoạch, không thay đổi gì
javinfo nfo ~/Videos/JAV --write       # cũng tạo thư mục và đổi tên: SSIS-001/SSIS-001.mp4
javinfo nfo ~/Videos/SSIS-001.mkv      # một file đơn lẻ

Không có gì bị đổi tên hoặc di chuyển trừ khi bạn truyền --write, và các file .nfo hiện có sẽ được giữ nguyên (--force để làm mới). Metadata mặc định lấy từ fanza,dmm; --write torrent chuyển sang javdb và cũng tạo các file torrent và magnet.

Kiểm tra thiết lập

status hiển thị những gì CLI biết về thiết lập cục bộ của bạn: nguồn khóa (được che), các trình phát đã cấu hình và daemon serve có đang chạy hay không:

javinfo status
javinfo status --json

Tùy biến theo cách của bạn

CLI là mã nguồn mở (MIT). Chúng tôi bỏ sót tính năng bạn muốn? Hãy tùy biến nó. Pull request luôn được chào đón, hoặc fork nó và biến nó thành của riêng bạn. Cứ lấy mã nguồn: github.com/javinfo/cli.

Tiếp theo

• Đọc tài liệu API để biết mọi thứ mà CLI bao bọc.
• Xem nhà cung cấp để hiểu metadata và stream đến từ đâu.
• Kiểm tra giới hạn tốc độ & thanh toán: CLI tính phí cho mỗi lần tra cứu thành công, giống như REST API.