winamp-mpris/README.md

Winamp MPRIS Bridge

A Python-based bridge that provides an MPRIS2 interface for Winamp/WACUP on Linux (running via Wine/Proton). This allows Linux desktop environments (like KDE Plasma, GNOME, or any MPRIS-compatible media widget) to control playback and display track metadata.

Features

• Metadata Extraction: Primarily uses the Winamp window title for high-fidelity metadata (Artist, Album, Title).
• Playback Controls: Supports Play, Pause, Next, Previous, and Stop via the Winamp Web Interface.
• Live Position Tracking: Extrapolates playback position for smooth progress bars in your desktop's media widget.
• Robustness: Gracefully handles Winamp being offline and automatically reconnects when it starts.
• Systemd Integration: Can be run as a background user service conforming to XDG standards.
• XDG Compliance: Installs to ~/.local/bin, logs to ~/.local/state/winamp-mpris/, and stores PID in $XDG_RUNTIME_DIR.

Demo