Install
dotnet add package JellyfinCli --version 0.1.8
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 --query "Breaking Bad"
Commands
| Group | Commands |
|---|---|
auth |
login, logout, status |
server |
info, ping, logs, activity, restart, shutdown |
items |
list, get, search, remote-search, latest, favorite, unfavorite, delete, resume |
users |
list, get, create, delete, password |
sessions |
list, state |
library |
refresh, scan |
playlists |
list, get, create, delete, add, remove |
collections |
list, create, delete, add, remove |
devices |
list, get, delete |
tasks |
list, get, run |
plugins |
list, enable, disable, uninstall |
backups |
list, create, restore |
livetv |
channels, recordings, timers |
syncplay |
list, new, 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
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.7 and v0.1.8.
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.