A comprehensive API integration for programmatically managing Emby media servers, including libraries, users, playback sessions, and live TV.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install emby
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install emby using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Emby Server API?
The Emby Server API skill is a robust integration designed for Openclaw Skills that enables AI agents to interact directly with Emby media servers. It provides a structured interface to query movies, shows, and music, while also offering administrative capabilities such as user management and device monitoring. This skill is ideal for developers looking to build automated media curators, remote server managers, or intelligent playback controllers.
By utilizing this skill, you can bridge the gap between AI-driven workflows and your self-hosted media ecosystem. Whether you are fetching high-resolution posters, managing live recording schedules, or adjusting encoding settings, the Emby Server API skill delivers the technical depth required for advanced automation within the framework of Openclaw Skills.
Emby Server API Use Cases
- Automating the discovery and organization of movies, TV series, and music albums.
- Managing user accounts, permissions, and tracking playback history across the server.
- Controlling active playback sessions and managing connected client devices.
- Scheduling and managing Live TV recordings and program guide data.
- Programmatic downloading of media assets including images, audio, and video streams.
How Emby Server API Works
- The skill establishes a connection to the Emby server using a defined base URL and API key.
- When a request is made, the skill maps the intent to a specific Emby REST API endpoint (e.g., /Users, /Items, or /LiveTv).
- The skill handles the authentication and parameter formatting required by the Emby Server.
- Data is retrieved as structured JSON for metadata queries or as byte streams for media file downloads.
- The processed response is returned to the AI agent or the calling application for further action within the Openclaw Skills environment.
Emby Server API Setup
To get started with this skill, configure the connection parameters in the emby.py file:
BASE_URL = "https://emby.example.com/emby" # Replace with your server address
API_KEY = "your_api_key_here" # Replace with your Emby API Key
Once configured, you can import and use the skill in your project:
from emby import get_items, query_users, download_item_image
Emby Server API Data Schema & Taxonomy
The skill organizes data into several logical categories for clear metadata taxonomy:
| Category | Return Type | Description |
|---|---|---|
| Metadata (Items/Users) | Dict (JSON) | Contains entity IDs, names, tags, and properties. |
| Media Streams | Bytes/Response | Raw binary data for posters, backdrops, and streams. |
| Playback Info | Dict (JSON) | Current session status, playhead position, and device info. |
| Live TV | Dict (JSON) | Channel lists, EPG data, and recording status. |
Emby Server API Advanced Features
- Full support for Live TV management including channel fetching and recording controls.
- Advanced image processing for downloading and saving media posters and artist art.
- Integrated user data operations for marking items as played or managing favorites.
- Support for system-level configurations including encoding settings and plugin management.
- Capability to handle multi-part media downloads and camera uploads via Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Scenique Prevision
A sophisticated decision forecasting engine that utilizes Menos architecture and swarm intelligence to simulate outcomes in a digital sandbox.
Lightcloud API Integration
A cross-platform skill for managing Qingyun/Lightcloud form documents and authentication via AI coding agents.
CodeQL Security Audit Skill
A comprehensive pipeline for CodeQL static analysis, vulnerability triaging, and query optimization.
Privacy Protector
A robust utility for PII anonymization, local de-anonymization, and deterministic local detector checks for various text and file formats.
Morning Briefing AI Agent Skill
A comprehensive daily automation that consolidates your inbox, schedule, priorities, and local weather into a single actionable summary.
Automated Client Follow-Up
An automated outreach assistant that scans client lists to identify cold leads and generates personalized, context-aware follow-up drafts.
Featured*
