# Send Jellyfin Control to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "jellyfin-control", "name": "Jellyfin Control", "source": "tencent", "type": "skill", "category": "开发ε·₯ε…·", "sourceUrl": "https://clawhub.ai/Titunito/jellyfin-control", "canonicalUrl": "https://clawhub.ai/Titunito/jellyfin-control", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/jellyfin-control", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=jellyfin-control", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "cli.js", "jellyfin.js", "package.json", "README.md", "SKILL.md", "tv.js" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "jellyfin-control", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-04T12:03:36.081Z", "expiresAt": "2026-05-11T12:03:36.081Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=jellyfin-control", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=jellyfin-control", "contentDisposition": "attachment; filename=\"jellyfin-control-1.3.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "jellyfin-control" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/jellyfin-control" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/jellyfin-control", "downloadUrl": "https://openagent3.xyz/downloads/jellyfin-control", "agentUrl": "https://openagent3.xyz/skills/jellyfin-control/agent", "manifestUrl": "https://openagent3.xyz/skills/jellyfin-control/agent.json", "briefUrl": "https://openagent3.xyz/skills/jellyfin-control/agent.md" } } ``` ## Documentation ### Jellyfin Control A robust skill to control Jellyfin playback and TV power via CLI. ### Features 🎯 One-Command Play: tv play "Breaking Bad" β€” turns on TV, launches Jellyfin, finds the next episode, and plays it. Smart Resume: Automatically finds the next unplayed episode for series. Resume Position: Resumes Movies/Episodes exactly where left off (with Seek fallback for LG WebOS/Tizen). Device Discovery: Auto-detects controllable sessions (TVs, Phones, Web). Remote Control: Full playback control (play, pause, stop, next, prev, volume, mute). TV Power & Apps: Turn TV on/off, launch apps β€” works with or without Home Assistant. Two TV Backends: Home Assistant integration or direct WebOS (LG TVs, no HA needed). Android TV Support: Direct ADB backend for Chromecast w/ Google TV, Nvidia Shield, Fire TV, Mi Box β€” no HA needed. Three connection modes: Home Assistant (any TV), direct WebOS (LG), direct ADB (Android TV/Fire TV). ### Minimal setup (Jellyfin only, no TV control) { "skills": { "entries": { "jellyfin-control": { "env": { "JF_URL": "http://YOUR_IP:8096", "JF_API_KEY": "your-api-key-here", "JF_USER": "your-username" } } } } } ### With Home Assistant (recommended for TV control) { "skills": { "entries": { "jellyfin-control": { "env": { "JF_URL": "http://192.168.1.50:8096", "JF_API_KEY": "your-jellyfin-api-key", "JF_USER": "victor", "HA_URL": "http://192.168.1.138:8123", "HA_TOKEN": "your-ha-long-lived-token", "HA_TV_ENTITY": "media_player.lg_webos_tv_oled48c34la", "TV_MAC": "AA:BB:CC:DD:EE:FF" } } } } } ### Direct WebOS (LG TV, no Home Assistant needed) { "skills": { "entries": { "jellyfin-control": { "env": { "JF_URL": "http://192.168.1.50:8096", "JF_API_KEY": "your-jellyfin-api-key", "JF_USER": "victor", "TV_IP": "192.168.1.100", "TV_MAC": "AA:BB:CC:DD:EE:FF" } } } } } First time with WebOS direct: The TV will show a pairing prompt. Accept it and save the TV_CLIENT_KEY the skill prints β€” add it to your env to skip the prompt next time. ### Direct ADB (Android TV / Fire TV / Chromecast with Google TV, no HA needed) { "skills": { "entries": { "jellyfin-control": { "env": { "JF_URL": "http://192.168.1.50:8096", "JF_API_KEY": "your-jellyfin-api-key", "JF_USER": "victor", "ADB_DEVICE": "192.168.1.100:5555", "TV_MAC": "AA:BB:CC:DD:EE:FF" } } } } } First time with ADB: Enable Developer Options on your TV (Settings β†’ About β†’ tap Build Number 7 times), then enable Network/USB debugging. First connection will show "Allow debugging?" on the TV β€” accept it. Requires adb installed on the OpenClaw host (sudo apt install adb). ### Jellyfin (required) VariableRequiredDescriptionJF_URLYesBase URL of your Jellyfin server, e.g. http://192.168.1.50:8096JF_API_KEYYesAPI key from Jellyfin Dashboard β†’ Advanced β†’ API KeysJF_USERNoUsername β€” used to resolve user ID for user-specific endpointsJF_USER_IDNoUser ID directly β€” avoids needing to call /UsersJF_PASSNoPassword β€” only if authenticating by user session ### TV Control (optional β€” choose one backend) VariableBackendDescriptionTV_BACKENDAllForce backend: homeassistant, webos, androidtv, or autoTV_PLATFORMHAForce platform: webos or androidtv (auto-detected from entity)HA_URLHAHome Assistant URL, e.g. http://192.168.1.138:8123HA_TOKENHAHA long-lived access token (Profile β†’ Long-Lived Access Tokens)HA_TV_ENTITYHAEntity ID of your TV, e.g. media_player.lg_webos_tv_oled48c34laTV_IPWebOSLG TV IP address for direct WebOS SSAP connectionTV_CLIENT_KEYWebOSPairing key (printed on first connection β€” save it!)ADB_DEVICEAndroidTVTV address for ADB, e.g. 192.168.1.100:5555TV_MACAllTV MAC address for Wake-on-LAN (needed to turn on TV)TV_JELLYFIN_APPAllOverride Jellyfin app ID (auto: org.jellyfin.webos / org.jellyfin.androidtv)TV_BOOT_DELAYAllSeconds to wait after TV wake (default: 10)TV_APP_DELAYAllSeconds to wait after launching Jellyfin (default: 8) Auto-detection: If TV_BACKEND is auto (default): HA_URL + HA_TOKEN + HA_TV_ENTITY set β†’ Home Assistant backend ADB_DEVICE set β†’ direct ADB (Android TV) TV_IP set β†’ direct WebOS (LG) Nothing set β†’ TV commands disabled, Jellyfin-only mode ### 🎯 One-Command Play (the magic) Turn on TV β†’ launch Jellyfin β†’ find next episode β†’ play it. All in one command: node skills/jellyfin-control/cli.js tv play "Breaking Bad" node skills/jellyfin-control/cli.js tv play "The Matrix" The skill validates the content exists BEFORE turning on the TV (fail fast). ### Resume / Play Smart If TV and Jellyfin are already running: node skills/jellyfin-control/cli.js resume "Breaking Bad" node skills/jellyfin-control/cli.js resume "Matrix" --device "Chromecast" ### TV Control node skills/jellyfin-control/cli.js tv on # Turn on (Wake-on-LAN) node skills/jellyfin-control/cli.js tv off # Turn off node skills/jellyfin-control/cli.js tv launch # Launch Jellyfin app node skills/jellyfin-control/cli.js tv launch com.webos.app.hdmi1 # Launch specific app node skills/jellyfin-control/cli.js tv apps # List installed apps ### Remote Control node skills/jellyfin-control/cli.js control pause node skills/jellyfin-control/cli.js control play node skills/jellyfin-control/cli.js control next node skills/jellyfin-control/cli.js control vol 50 ### Search Content node skills/jellyfin-control/cli.js search "Star Wars" ### Library Stats & Scan node skills/jellyfin-control/cli.js stats node skills/jellyfin-control/cli.js scan # requires admin API key ### User History (requires admin API key) node skills/jellyfin-control/cli.js history node skills/jellyfin-control/cli.js history jorge --days 7 ### Choosing a TV Backend FeatureHome AssistantDirect WebOSDirect ADB (Android TV)No BackendTV brandsAny (via HA)LG onlyAndroid TV, Fire TV, CCwGTVβ€”Turn on (WoL)βœ…βœ…βœ… (WoL or ADB wakeup)β€”Turn offβœ…βœ…βœ…β€”Launch appsβœ…βœ…βœ…β€”List appsβœ… (via HA logs)βœ… (direct output)βœ… (direct output)β€”Extra dependencyNonenpm install wsapt install adbNoneSetup complexityMedium (need HA)Low (TV IP + MAC)Low (enable ADB on TV)NoneJellyfin playbackβœ…βœ…βœ…βœ… Recommendation: Already have Home Assistant? β†’ Use HA backend (most versatile, any TV brand) LG WebOS TV, no HA? β†’ Use direct WebOS backend Android TV / Fire TV / Chromecast with Google TV, no HA? β†’ Use direct ADB backend No smart TV control needed? β†’ Skip TV config, resume works if Jellyfin app is already open ### Security Notes API keys only in openclaw.json env β€” never in workspace files, .env files, or markdown docs. HA tokens are long-lived and powerful. Create a dedicated HA user with limited permissions if possible. TV_CLIENT_KEY (WebOS) is sensitive β€” it allows full control of your TV. Treat it like a password. ADB access grants full control of your Android TV. Ensure your network is secured β€” anyone on the same network could connect via ADB if debugging is enabled. Admin operations (history, scan) require an admin-level Jellyfin API key and will fail gracefully with 403 if permissions are insufficient. ### Architecture lib/jellyfin.js β€” Jellyfin REST API (auth, search, sessions, playback control) lib/tv.js β€” TV control abstraction (HA backend, WebOS backend, Wake-on-LAN) cli.js β€” User-friendly CLI with all commands ### Workflow: Agent says "Play Star Trek on TV" Agent β†’ cli.js tv play "Star Trek" β”‚ β”œβ”€β”€ 1. Search Jellyfin for "Star Trek" (fail fast) β”œβ”€β”€ 2. Find next unplayed episode β”œβ”€β”€ 3. Wake-on-LAN β†’ TV turns on β”œβ”€β”€ 4. Wait 10s for boot β”œβ”€β”€ 5. Launch Jellyfin app (HA or WebOS) β”œβ”€β”€ 6. Wait 8s for session registration β”œβ”€β”€ 7. Find Jellyfin session (retry 3x) └── 8. Play episode on session ## Trust - Source: tencent - Verification: Indexed source record - Publisher: Titunito - Version: 1.3.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-04T12:03:36.081Z - Expires at: 2026-05-11T12:03:36.081Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/jellyfin-control) - [Send to Agent page](https://openagent3.xyz/skills/jellyfin-control/agent) - [JSON manifest](https://openagent3.xyz/skills/jellyfin-control/agent.json) - [Markdown brief](https://openagent3.xyz/skills/jellyfin-control/agent.md) - [Download page](https://openagent3.xyz/downloads/jellyfin-control)