Winamp-Py

A Winamp-inspired media player built with Python, featuring real-time audio visualizations powered by OpenGL.

Features

• Play MP3, WAV, FLAC, OGG, and M4A files
• Drag-and-drop playlist with reordering
• Real-time OpenGL visualizations (Geiss-style) with 8 waveform modes and 8 color palettes
• Fullscreen visualization mode (double-click the visualizer or press F11)
• Customizable visualization settings (waveform, colors, warp motion, trails, particle effects)
• Volume control and seek bar
• Remembers window state, playlist, and settings between sessions

⚙️ Windows Installer

Download and run WinampPy_Setup.exe from the latest release. VLC media player must also be installed.

Requirements

• Python 3.10+
• VLC media player must be installed on your system

Installation

1. Clone the repository:

   git clone https://github.com/BBC-Esq/Winamp-Py.git
   cd Winamp-Py
   

2. Create and activate a virtual environment:

   python -m venv .
   Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Run:

   python main.py
   

Usage

• Add music - drag and drop files onto the playlist or use File > Open Files
• Playback - use the transport buttons or double-click a track
• Reorder - drag tracks within the playlist
• Remove tracks - right-click a track
• Visualization - select a visualization from the Visualization menu; double-click it or press F11 for fullscreen (double-click, Esc or F11 to exit)
• Settings - Visualization > Visualization Settings (or right-click the visualizer) to adjust the waveform, colors, warp motion, trails, and effects
• Volume - use the slider or mouse wheel