Install
dotnet add package JellyfinCli --version 0.1.28
No framework information available.
README
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
Changes from Previous Version
No structural changes between v0.1.27 and v0.1.28.
Adoption Assessment
Assess this package against its supported frameworks, license, maintenance signals and dependency graph before making it a project standard.
No target framework metadata is available. Confirm compatibility in a representative project before standardising on this package.
Related Guides & Workflows
Learn how to evaluate, integrate, or audit this package in your .NET project.