Rhythm Music Player v2.0.0

Major Release: Stunning GUI Overhaul

This release introduces a completely redesigned GUI experience with Love2D, stunning audio visualizers, and professional-grade audio processing with PortAudio.

New Features

New GUI Experience

• Love2D + Lua GUI: Complete rewrite with smooth, modern interface
• Stunning Audio Visualizers: Real-time visual effects that dance with your music
• Drag & Drop Support: Simply drag music files or entire folders to start playing
• Intuitive Playback Controls: Play/pause, next/previous, shuffle, and repeat modes
• Smoother Workflow: Redesigned UI for effortless music management

Enhanced Audio Engine

• PortAudio Integration: Professional-grade audio processing with C backend
• Seamless Performance: Lua frontend communicates efficiently with C audio engine
• Multiple Format Support: Robust MP3 playback with mpg123 integration

Technical Improvements

GUI Architecture

• Love2D Framework: Modern game engine providing smooth 60fps interface
• Lua Scripting: Flexible, lightweight scripting for UI logic
• C Audio Backend: High-performance PortAudio integration for professional sound
• Real-time Visualizers: GPU-accelerated visual effects synchronized with audio

Installation

Quick Installation (Debian/Ubuntu)

Download and install the .deb package:

# Download the package you need:
wget https://github.com/dexter-xd/rhythm/releases/download/v2.0.0/rhythm-2.0.0-debian-amd64.deb

# Install with dependencies
sudo dpkg -i rhythm-2.0.0-debian-amd64.deb
sudo apt-get install -f  # Fix any missing dependencies

Package Options:

• rhythm-2.0.0-debian-amd64.deb - Complete package with Love2D GUI + TUI
• rhythm-gui-2.0.0-debian-amd64.deb - GUI-only with stunning visualizers
• rhythm-tui-2.0.0-debian-amd64.deb - Terminal-only for minimal systems

Build from Source

First, install the build dependencies:

# Ubuntu/Debian - Install Love2D and C dependencies
sudo apt update
sudo apt install love cmake build-essential

# Audio libraries
sudo apt install libportaudio2-dev libmpg123-dev

# GUI dependencies
sudo apt install libgl1-mesa-dev libglu1-mesa-dev

# TUI support (optional)
sudo apt install libncurses-dev

Then build the project:

git clone https://github.com/dexter-xd/rhythm.git
cd rhythm
./build.sh

User Experience Highlights

Drag & Drop Magic

Simply drag your favorite music files or entire folders into the Rhythm window and watch them instantly appear in your playlist. No more tedious file browsing!

Visual Spectacle

Experience your music like never before with real-time visualizers that respond to every beat, creating a mesmerizing light show synchronized with your audio.

Smooth Performance

The Love2D engine ensures smooth 60fps performance while the PortAudio backend delivers clear, low-latency audio processing.

System Requirements

• OS: Debian 11+ / Ubuntu 20.04+
• Dependencies:
  • For GUI: love (Love2D engine), libportaudio2, libmpg123-0
  • For TUI: libncurses6, libmpg123-0
  • Audio: libportaudio2 (professional audio processing)
  • Graphics: OpenGL support (for visualizers)

Bug Fixes

• Improved error handling in audio playback with PortAudio
• Resolved MPEG decode errors in mpg123 integration
• Smooth audio transitions between tracks
• Optimized visualizer performance for lower-end systems
• Fixed memory leaks in audio processing pipeline

New Contributors

• @vegerot made their first contribution in #3

Full Changelog: 1.0.0...v2.0.0

Rhythm v1.0.0 - Initial Release 🎵

Features

• ** Beautiful Rainbow Spectrum Visualizer** - Watch your music come to life with a 32-bar vertical spectrum analyzer
• ** Flexible Playback** - Play single MP3 files or entire folders
• ** Volume Control** - Adjust volume on the fly with + and - keys
• ** Playback Controls** - Play, pause, and navigate tracks with intuitive controls
• ** Progress Display** - See current time, total duration, and visual progress bar
• ** Modern Terminal UI** - Clean, boxed layout with Unicode icons and colors

🎮 Controls

• Space - Play/Pause
• q - Quit
• + - Volume up
• - - Volume down
• → (Right arrow) - Next track
• ← (Left arrow) - Previous track

Quick Start

1. Install dependencies:

   # Ubuntu/Debian
   sudo apt install portaudio19-dev libmpg123-dev cmake build-essential

2. Build:

   mkdir build && cd build
   cmake .. && make

3. Run:

   # Single file
   ./rhythm song.mp3
   
   # Entire folder
   ./rhythm /path/to/music/folder

Technical Details

• Written in C for performance and portability
• Uses PortAudio for cross-platform audio output
• Uses libmpg123 for MP3 decoding
• Real-time audio visualization with FFT analysis
• Efficient playlist management for large music collections

Enjoy your music! 🎶