---

name: winamp description: Control Winamp on Windows (Native or WSL2) or Linux (via Wine). metadata: moltbot: requires: bins: ["winamp.exe"]

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.

{
  "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.

"/mnt/c/Program Files (x86)/Winamp/winamp.exe" /PLAY &