JellyfinCli 0.1.28

.NET 10.0

dotnet tool install --global JellyfinCli --version 0.1.28

This package contains a .NET tool you can call from the shell/command line.

dotnet new tool-manifest
                    

                            if you are setting up this repo

dotnet tool install --local JellyfinCli --version 0.1.28

This package contains a .NET tool you can call from the shell/command line.

#tool dotnet:?package=JellyfinCli&version=0.1.28

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

nuke :add-package JellyfinCli --version 0.1.28

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Jellyfin CLI (`jf`)

A command-line interface for Jellyfin media server, built with .NET 10, Spectre.Console, and Kiota.

Installation

dotnet tool install -g JellyfinCli

Quick Start

# Login with username/password
jf auth login --server https://your-server.example.com --username admin

# Login with API key
jf auth login --server https://your-server.example.com --api-key YOUR_KEY

# Check connection
jf server ping
jf server info

# Browse your library
jf items list
jf items search "Breaking Bad"

# Inspect server state
jf server logs
jf items counts

Commands

Group	Commands
`auth`	`login`, `whoami`, `logout`, `users`, `quick`, `keys`
`server`	`ping`, `info`, `storage`, `endpoint`, `activity`, `logs`, `log get`, `bitrate-test`, `localization`, `environment`, `config`, `restart`, `shutdown`
`items`	`list`, `get`, `latest`, `explain-latest`, `search`, `dates`, `tree`, `resume`, `favorite`, `refresh`, `update`, `delete`, `remote-search`, `download`, `similar`, `suggestions`, `counts`, `playback-info`, `ancestors`, `themes`, `images`, `remote-images`, `subtitles`, `lyrics`, `nfo`
`users`	`list`, `get`, `create`, `update`, `delete`, `password`, `policy`
`sessions`	`list`, `play`, `state`, `message`, `command`
`library`	`scan`, `folders`, `paths`, `options`, `media`
`playlists`	`create`, `get`, `update`, `items`
`collections`	`create`, `add`, `remove`
`devices`	`list`, `get`, `delete`, `options`
`tasks`	`list`, `get`, `triggers`, `start`, `stop`
`plugins`	`list`, `enable`, `disable`, `uninstall`, `config`
`packages`	`list`, `get`, `install`, `cancel`, `repos`
`backups`	`list`, `inspect`, `create`, `restore`
`genres` / `studios` / `artists` / `persons`	`list`
`livetv`	`channels`, `recordings`, `timers`
`syncplay`	`list`, `create`, `join`, `leave`
`raw`	`get`, `post`, `put`, `delete`

Global Options

Option	Description
`--server`	Server URL (saved after login)
`--token`	Auth token (saved after login)
`--api-key`	API key for authentication
`--user`	User ID (use `me` for current user)
`--json`	Output as JSON
`--verbose`	Verbose output
`--limit`	Limit number of results
`--start`	Pagination offset

Frequent Workflows

List libraries and browse their content

# List all media libraries (shows Id, Name, and Type for each library)
jf library media

# List items inside a specific library using its Id
jf items list --parent <LIBRARY_ID>

# Filter by item type (e.g. Series, Movie, Episode)
jf items list --parent <LIBRARY_ID> --type Series

# Sort and limit results
jf items list --parent <LIBRARY_ID> --type Series --sort SortName --limit 10

# Search recursively within a library
jf items list --parent <LIBRARY_ID> --recursive --search "dragon"

# Output as JSON for scripting
jf items list --parent <LIBRARY_ID> --type Movie --json

Admin workflows

# Inspect and read server logs
jf server logs
jf server log get jellyfin.log

# Browse packages and installed plugin configuration
jf packages list
jf plugins config get <PLUGIN_ID>

# Manage library structure
jf library folders list
jf library paths add "Movies" /srv/media/more-movies

# Explore item relationships and diagnostics
jf items similar <ITEM_ID>
jf items playback-info <ITEM_ID>
jf items ancestors <ITEM_ID>

# Work with scheduled task triggers
jf tasks triggers <TASK_ID>
jf tasks triggers set <TASK_ID> --interval 12h

More use cases

Detailed guides with examples for common workflows:

Authentication -- Login, logout, Quick Connect, API key management
Browsing Libraries -- List libraries, filter, sort, search, view item details
Server Administration -- Health checks, user management, tasks, plugins, backups
Playback Control -- Sessions, remote play/pause/seek, client messages
Playlists and Collections -- Create, manage items, reorder
Media Management -- Update metadata, refresh, images, favorites, downloads
Scripting and Automation -- JSON output, pagination, raw API, shell integration
SyncPlay -- Synchronized group watching

Building from Source

git clone https://github.com/JKamsker/Jellyfin-Cli.git
cd Jellyfin-Cli
dotnet build
dotnet run --project src/Jellyfin.Cli -- server ping --server https://your-server.example.com

License

MIT

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version	Downloads	Last Updated
0.1.28	38	4/9/2026
0.1.27	41	4/9/2026
0.1.26	31	4/9/2026
0.1.25	41	4/9/2026
0.1.24	32	4/9/2026
0.1.23	31	4/9/2026
0.1.22	37	4/9/2026
0.1.21	47	4/8/2026
0.1.20	30	4/8/2026
0.1.19	101	3/27/2026
0.1.18	81	3/27/2026
0.1.17	75	3/27/2026
0.1.16	162	3/23/2026
0.1.11	94	3/16/2026
0.1.10	86	3/15/2026
0.1.9	88	3/15/2026
0.1.8	83	3/15/2026
0.1.7	86	3/15/2026
0.1.6	90	3/13/2026
0.1.5	97	3/13/2026