# winamp

> Controls the Winamp media player on Windows, WSL2, or Linux via Wine using command-line switches for playback, playlists, and instance management.

- Skill: `demerzels-lab/winamp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add demerzels-lab/winamp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/demerzels-lab/winamp/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity, Personal Automation
- Tags: Cli, Linux, Media Player, Winamp, Windows, Wine, Wsl2
- Author: Demerzels-lab (https://skillmd.com/u/demerzels-lab)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/demerzels-lab/winamp

---


# Winamp CLI

Use this skill to control the Winamp media player.

## Executable Paths
Depending on your environment, the path to the Winamp executable will vary:
- **Windows (Native):** `C:\Program Files (x86)\Winamp\winamp.exe`
- **WSL2 (Windows Host):** `/mnt/c/Program Files (x86)/Winamp/winamp.exe`
- **Linux (via Wine):** `wine "C:\Program Files (x86)\Winamp\winamp.exe"`

## Common Commands

### Playback Control
- **Play:** `winamp.exe /PLAY`
- **Pause/Unpause:** `winamp.exe /PAUSE`
- **Stop:** `winamp.exe /STOP`
- **Next Track:** `winamp.exe /NEXT`
- **Previous Track:** `winamp.exe /PREV`

### Managing Playlists
- **Play File (Clear Queue):** `winamp.exe "C:\path\to\file.mp3"`
- **Enqueue File/Folder:** `winamp.exe /ADD "C:\path\to\file.mp3"`
- **Play Playlist:** `winamp.exe "C:\path\to\playlist.m3u"`

### Advanced Switches
- **New Instance:** `winamp.exe /NEW` (Forces a new window)
- **Specific Instance:** `winamp.exe /CLASS="MyClassName"` (Target a specific window)
- **Config Dir:** `winamp.exe /INIDIR="C:\path\to\dir"` (Use specific settings)

## Execution Note (Backgrounding)
Since Winamp is a GUI application, always run it in the background to prevent sessions from hanging. The command will execute as soon as it is sent.

### Moltbot `exec` Usage:
Set `background: true` in your tool call.

```json
{
  "tool": "exec",
  "command": "\"/mnt/c/Program Files (x86)/Winamp/winamp.exe\" \"C:\\path\\to\\file.mp3\"",
  "background": true
}
```

### CLI Usage:
Append an ampersand (`&`) to the command.
```bash
"/mnt/c/Program Files (x86)/Winamp/winamp.exe" /PLAY &
```