Jellyfin CLI

Command line client for Jellyfin media server.

Features

• Search and browse media libraries
• Control playback on external players
• Manage users and libraries
• End-to-end testing infrastructure

Installation

cargo install --path .

Quick Start

E2E Testing

The CLI includes built-in E2E testing with an isolated Jellyfin server:

# 1. Initialize the E2E environment
jellyfin e2e setup

# 2. Download test media (open-licensed)
jellyfin e2e media download --download all

# 3. Start the E2E server
jellyfin e2e start --wait

# 4. Access at http://127.0.0.1:8096

# 5. Stop when done
jellyfin e2e stop --cleanup

See docs/e2e-testing.md for complete E2E testing documentation.

Connecting to a Server

# Login to a server
jellyfin login --server https://jellyfin.example.com

# Search for media
jellyfin search "movie title"

# Get latest media
jellyfin latest --limit 10

Output Formats

All commands support structured output:

# YAML (default)
jellyfin search "query"

# JSON
jellyfin search "query" --output json

# TOML
jellyfin search "query" --output toml

Development

Building

cargo build --release

Testing

# Run all tests
cargo test

# Run E2E integration tests
cargo test e2e

Project Structure

jellyfin-cli/
├── crates/
│   ├── api/       # Jellyfin API client
│   ├── core/      # Shared business logic
│   ├── player/    # Media player integration
│   └── cli/       # CLI application
├── specs/         # Feature specifications
├── docs/          # Documentation
└── test-data/     # E2E test data

License

MIT OR Apache-2.0