← Back to Skills Marketplace
isaiah5818

potplayer

by isaiah5818 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
118
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ctrl-potplayer
Description
Play local or network audio/video files with PotPlayer, supporting playback control, playlists, fullscreen, subtitles, and device access.
README (SKILL.md)
---\r
name: potplayer\r
description: Use PotPlayer to play local or network audio/video files. Supports scenarios such as direct playback, playlist management, seek playback, fullscreen, subtitle loading, etc. Use this skill when the user asks to play videos, audio, anime, TV series, or movies.\r
---\r
\r
# PotPlayer Player\r
\r
Play local or network audio/video files using PotPlayer.\r
\r
## Executable Path\r
\r
```\r
C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe\r
```\r
\r
## Basic Playback\r
\r
```powershell\r
# Play a single file\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "C:\Media	est.mp4"\r
\r
# Play network streams (m3u8/http)\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "https://example.com/video.m3u8"\r
\r
# Play multiple files (auto-added to playlist)\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "1.mp4" "2.mkv" "3.avi"\r
```\r
\r
> Paths containing spaces or Chinese characters must be enclosed in double quotes.\r
\r
## Common Parameters\r
\r
### Playback Control\r
\r
```powershell\r
# Start playback from specified time (seconds or hh:mm:ss.ms)\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /seek=120\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /seek=00:05:30.000\r
\r
# Fullscreen playback\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /fullscreen\r
\r
# Set volume (0-100)\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /volume=80\r
\r
# Muted playback\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /mute\r
\r
# Auto-play last file\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /autoplay\r
```\r
\r
### Playlist\r
\r
```powershell\r
# ✅ Recommended: Add to existing instance's playlist (no new instance created)\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /add "video.mp4"\r
\r
# Insert after current playing item\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /insert "video.mp4"\r
\r
# Add to list sorted by name\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "D:\Movies\*.mp4" /sort\r
\r
# Add to list in random order\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "D:\Movies\*.mp4" /randomize\r
```\r
\r
### Window & Instance\r
\r
```powershell\r
# Force new instance\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /new\r
\r
# Open in current instance\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /current\r
\r
# Start minimized\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /min\r
\r
# Start maximized\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /max\r
```\r
\r
### Subtitles & Configuration\r
\r
```powershell\r
# Specify subtitle file\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /sub="subtitle.srt"\r
\r
# Load specified configuration preset\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "video.mp4" /config="PresetName"\r
```\r
\r
### Devices & Recording\r
\r
```powershell\r
# Open DVD\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /dvd\r
\r
# Open webcam\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /cam\r
\r
# Screen recording\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /cap\r
```\r
\r
### Dialogs\r
\r
```powershell\r
# Open file selection dialog\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /filedlg\r
\r
# Open URL input dialog\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /urldlg\r
\r
# Open folder selection dialog\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /folderdlg\r
```\r
\r
## Common Scenario Examples\r
\r
```powershell\r
# Anime: Fullscreen network stream playback\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "https://example.com/anime.m3u8" /fullscreen\r
\r
# Resume from last position\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "movie.mkv" /seek=00:45:00\r
\r
# Fullscreen with subtitles\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "movie.mkv" /fullscreen /sub="movie.ass"\r
\r
# Batch play videos in folder (sorted)\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" "D:\Movies\*.mp4" /sort\r
\r
# Add to existing playlist (won't interrupt current playback)\r
& "C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe" /add "next_episode.mp4"\r
```\r
\r
## Notes\r
\r
- Parameters are case-insensitive (`/Seek` and `/seek` are equivalent)\r
- Multiple parameters are separated by spaces, order generally doesn't matter\r
- Paths with special characters must be enclosed in double quotes\r
- The `/add` parameter avoids creating new instances and is recommended for continuous playback\r
- Supports network stream addresses such as m3u8, http, rtsp, etc.\r
Usage Guidance
This skill is a set of PowerShell command examples for launching PotPlayer and is coherent with its description — but you should only install/use it if you run Windows and have PotPlayer installed at the documented path (or adjust the path to your installation). The skill does not request secrets or perform installs, so it won't install PotPlayer for you. Be aware that some commands (webcam, screen capture, DVD) access local devices; only run those if you trust the agent's action. Also consider updating the skill metadata to declare the required binary / OS before relying on automated workflows.
Capability Analysis
Type: OpenClaw Skill Name: ctrl-potplayer Version: 1.0.0 The skill bundle provides standard PowerShell command-line instructions for controlling PotPlayer. It includes legitimate functionality for media playback, playlist management, and accessing built-in features like webcam support (/cam) and screen capture (/cap). No evidence of data exfiltration, malicious execution, or prompt injection was found in SKILL.md or _meta.json.
Capability Assessment
Purpose & Capability
The SKILL.md clearly documents launching and controlling PotPlayer via its Windows executable path; this matches the described purpose. However, the registry metadata declares no required binaries or OS restriction even though the instructions assume a Windows environment and a specific executable path (C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe). The skill should have declared the PotPlayer binary (or at least an OS restriction) in its requirements.
Instruction Scope
All instructions stay within the scope of playing media and controlling PotPlayer (play, seek, playlists, fullscreen, subtitles, webcam, recording, dialogs). The instructions do not ask the agent to read unrelated files, export credentials, or send data to unexpected endpoints. Example network streams are shown but no telemetry or external endpoints beyond user media are referenced.
Install Mechanism
This is an instruction-only skill with no install spec and no code files — low installation risk. It does not download or write code to disk.
Credentials
The skill requests no environment variables, credentials, or config paths. That is proportional to its purpose. Note: the SKILL.md implicitly requires the PotPlayer executable to exist, which is not declared in the metadata.
Persistence & Privilege
The skill is not always-included and uses default invocation settings. It does not request elevated persistence or modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ctrl-potplayer
  3. After installation, invoke the skill by name or use /ctrl-potplayer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of ctrl-potplayer with PotPlayer integration: - Enables playback of local and network audio/video files using PotPlayer. - Supports key controls: seek, fullscreen, volume, mute, and playlist management. - Allows adding files to playlist, opening streams, and loading subtitles. - Includes usage examples for scenarios like video streaming and batch playback. - Documents command-line options and common parameters for flexible playback.
Metadata
Slug ctrl-potplayer
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is potplayer?

Play local or network audio/video files with PotPlayer, supporting playback control, playlists, fullscreen, subtitles, and device access. It is an AI Agent Skill for Claude Code / OpenClaw, with 118 downloads so far.

How do I install potplayer?

Run "/install ctrl-potplayer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is potplayer free?

Yes, potplayer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does potplayer support?

potplayer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created potplayer?

It is built and maintained by isaiah5818 (@isaiah5818); the current version is v1.0.0.

💬 Comments