Winamp CLI for Openclaw

A versatile skill for controlling the Winamp media player across Windows, WSL2, and Linux environments using command-line arguments.

jage9
v1.0.0
Jan 30, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install winamp

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install winamp 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 Winamp CLI?

The Winamp skill provides a robust interface for interacting with the iconic media player through automation agents. It leverages the Winamp executable's native command-line switches to manage audio playback, volume, and track selection without requiring manual GUI interaction. By integrating this into your Openclaw Skills collection, you can bridge the gap between legacy media software and modern AI-driven automation.

This skill is designed to handle various execution environments, including native Windows installations, Windows Subsystem for Linux (WSL2), and Linux systems running via Wine. It effectively turns Winamp into a controllable service for developers and power users who want to script their audio environment.

Winamp CLI Use Cases

  • Automating background music during deep work or coding sessions.
  • Creating custom keyboard shortcuts or voice commands to control media playback.
  • Programmatically managing large audio libraries and complex .m3u playlists.
  • Integrating media player controls into broader automated workflows using Openclaw Skills.

How Winamp CLI Works

  1. The skill identifies the correct executable path for winamp.exe based on the host operating system (Native Windows, WSL2, or Wine).
  2. Specific command-line switches such as /PLAY, /PAUSE, or /NEXT are appended to the executable call.
  3. Files or directories are passed as arguments to either play immediately or enqueue into the existing list.
  4. To ensure the calling agent remains responsive, the command is executed in the background, preventing the GUI process from blocking the session.
  5. The integration via Openclaw Skills allows for seamless execution within AI agent tool-calling cycles.

Winamp CLI Setup

First, ensure Winamp is installed on your host system. Verify the path to the executable matches your environment:

  • Windows: C:\Program Files (x86)\Winamp\winamp.exe
  • WSL2: /mnt/c/Program Files (x86)/Winamp/winamp.exe

To use via CLI in a shell environment:

# Example: Play a specific file in the background
"/mnt/c/Program Files (x86)/Winamp/winamp.exe" "C:\Music\track.mp3" &

Winamp CLI Data Schema & Taxonomy

The skill utilizes standard Windows CLI arguments to organize its operations. Below are the primary commands supported:

Command Description Action
/PLAY Play Starts or resumes playback
/PAUSE Toggle Pause Pauses or unpauses current track
/STOP Stop Stops the current audio stream
/NEXT Next Track Skips to the next item in the playlist
/ADD Enqueue Adds a file or folder to the current playlist without clearing it

Winamp CLI Advanced Features

  • Multi-instance management using the /NEW switch to launch independent player windows.
  • Custom configuration targeting with the /INIDIR flag to use specific settings for different sessions.
  • Window class targeting via /CLASS for advanced automation scripts that need to control specific Winamp instances.
  • Support for playlist file injection, allowing Openclaw Skills to swap entire audio environments instantly.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*