A streamlined automation skill that allows AI agents to trigger media playback in the iPlay desktop application using any supported URL.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install iplay
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 iplay 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 iPlay Media Controller?
The iPlay skill is a powerful integration for the iPlay desktop application, designed to bridge the gap between AI workflows and media consumption. By leveraging this tool within the Openclaw Skills ecosystem, users can automate the process of launching streams, videos, and playlists across various platforms.
This skill excels at handling complex URI schemes by utilizing Base64 encoding, ensuring that URLs with heavy query parameters—common in modern streaming sites—are passed to the player without corruption. Whether you are managing a Linux server with xdg-open or a high-end macOS workstation, this skill provides a unified interface for media playback.
iPlay Media Controller Use Cases
- Launching YouTube or Bilibili videos directly from an AI chat interface.
- Automating the opening of m3u8 IPTV streams or mp4 files via CLI.
- Integrating media playback into larger research or entertainment workflows using Openclaw Skills.
- Handing off media URLs from a headless environment to a local GUI player.
How iPlay Media Controller Works
- The AI agent identifies a media URL (YouTube, Bilibili, or direct link) from the user's request.
- The Openclaw Skills helper script,
iplay_play.py, is invoked with the target URL as an argument. - The script converts the plain URL into a Base64 encoded string to prevent character stripping or formatting errors.
- A system-level call triggers the
iplay://protocol handler on the host machine. - The iPlay application launches (or brings the focus to the foreground) and begins buffering the media asynchronously.
iPlay Media Controller Setup
To get started with this component of Openclaw Skills, ensure Python 3 is installed and iPlay is correctly registered as a protocol handler on your OS.
# Navigate to your skill directory
cd {baseDir}/scripts/
# Test the player with a direct link
python3 iplay_play.py "https://www.youtube.com/watch?v=example"
Platform Requirements:
- macOS: version 1.2.8 or higher.
- Windows: version 1.0.614 or higher.
- Linux: requires
xdg-utilsforxdg-opensupport.
iPlay Media Controller Data Schema & Taxonomy
The iPlay skill operates primarily as a functional trigger. It does not maintain a persistent database but uses the following metadata and protocol structure:
| Attribute | Description |
|---|---|
| Protocol | iplay://play/?url={base64_encoded_url} |
| Dependencies | Python 3 binary and system-level URI handler |
| Supported Formats | YouTube, Bilibili, m3u8, mp4, and any yt-dlp compatible site |
| Tracking | Asynchronous (does not return playback status to the agent) |
iPlay Media Controller Advanced Features
- Base64 URL Encoding: Built-in protection for complex URLs with nested parameters.
- Asynchronous Execution: Triggers the player without blocking the AI agent's next action.
- yt-dlp Integration: Leverages the power of
yt-dlpwhen configured within iPlay for high-quality site scraping. - Cross-Platform Compatibility: Supports macOS, Windows, and Linux via a single unified Python bridge.
SKILL.md
Loading
Related Openclaw Skills
MakeAIClips — AI Video Clipper
MakeAIClips is a powerful AI-driven tool that automatically converts long-form YouTube videos into high-engagement vertical clips with burned-in captions and viral hook titles.
GDrive: Approved-Folder Google Drive Access
A privacy-first Google Drive integration that restricts agent access to a pre-defined allow-list of approved folders.
Feishu Send Message
A specialized tool for AI agents to programmatically send images and files to Feishu (Lark) users and group chats.
OpenClaw Message Delivery Guide
A technical framework for AI agents to ensure asynchronous tasks, background processes, and reminders actually reach the user through verified delivery paths.
Infoxmed VIP Membership QR Generator
An automated utility for generating Infoxmed VIP membership activation QR codes through natural language processing.
Model Catalog Updater
A specialized tool for Openclaw Skills that automates the discovery and integration of LLM endpoints into your local configuration.
Featured*
