Files
magnus919_agent-skills/jellyfin-cli/README.md
T

45 lines
1.6 KiB
Markdown

# Jellyfin Media Server from the Terminal
Query your Jellyfin media library — recently added movies and episodes, search and inspect items, browse library contents, see next-up episodes, and check server stats.
## Why Install This Skill
When your agent loads this skill, it can **navigate your home media server** without opening a browser. That means:
- **See what's new** — recently added movies and TV episodes
- **Search your library** — find any movie, show, or episode by keyword
- **Navigate your library** — inspect search results, browse collections, and page through items
- **See what is next** — find the next unwatched episodes for a user
- **Check server details** — server name, version, operating system, user count
## What You Get
| Directory | Purpose |
|-----------|---------|
| `SKILL.md` | Complete command reference with setup and examples |
| `scripts/jellyfin-cli` | CLI tool for Jellyfin API operations |
## Quick Start
```bash
scripts/jellyfin-cli --help
export JELLYFIN_URL="http://your-server:8096"
export JELLYFIN_API_KEY="your-api-key"
export JELLYFIN_USER_ID="your-jellyfin-user-id" # required by recent, next-up, and item
```
API key from Dashboard → API Keys in the Jellyfin admin panel.
```bash
scripts/jellyfin-cli search --query "dune" --type Movie
scripts/jellyfin-cli next-up --limit 5
```
## Triggers
Load this when asking about Jellyfin, media server content, recently added movies or TV, or browsing your home media library.
## Requirements
Python 3.8+ with `requests` library. Jellyfin server with API key; `recent`, `next-up`, and `item` also require a Jellyfin user ID.