Skip to content

editinghero/Aurora

Repository files navigation

Aurora Music Player 🎵

A beautiful, modern music player for your local audio files with powerful audio controls and stunning visuals.

Aurora Music Player Platform

Features

Audio Playback

  • Local File Support - Play MP3, M4A, FLAC, WAV, and OGG files
  • Queue Management - Build and organize your playlist with drag-and-drop reordering
  • Search - Quickly find tracks in your queue by title, artist, or album
  • Play History - Keep track of recently played songs
  • Shuffle & Repeat - Standard playback controls with repeat one/all modes

Audio Enhancement

  • 10-Band Equalizer - Fine-tune your audio with professional-grade EQ
  • Speed Control - Adjust playback speed from 0.5x to 2x with pitch preservation
  • Reverb Effects - Add depth and ambiance to your music

Visual Experience

  • Dynamic Themes - Choose from 8 beautiful color themes or enable auto-theme
  • Album Artwork - Display album art from your music files (desktop app)
  • Visualizer - Pulse and bar visualizers that react to your music
  • Smooth Animations - Polished UI with gradient effects and transitions

Desktop App Exclusive

  • Music Library - Scan folders and build a persistent music library with SQLite
  • Mini Player - Compact always-on-top player window for multitasking
  • Offline First - All your music stays on your computer, no cloud required

Web App (PWA)

  • Progressive Web App - Install on any device from your browser
  • Works Offline - Play your music without an internet connection
  • Cross-Platform - Works on Windows, Mac, Linux, Android, iOS

Screenshots

Main Player Interface Mini Player
Queue Management Audio Effects
Equalizer Theme Picker

Download

Desktop App (Windows)

Download Latest Release

Choose one:

  • Portable Version - No installation required, just run the .exe
  • Installer Version - Traditional Windows installer with shortcuts

Web App

Launch Web Player

Or install as PWA:

  1. Visit the web player link
  2. Click the install icon in your browser's address bar
  3. Enjoy Aurora as a standalone app

Getting Started

Desktop App

  1. Download the portable or installer version from releases
  2. Run the application
  3. Add Music:
    • Click "Open Folder" button
    • Choose "Clear Queue & Play" or "Add to Queue"
    • Select your music folder
    • Wait for scanning to complete
  4. Play - Your music will start automatically!

Managing Your Library

  • Open Folder - Scan a new folder and choose how to add tracks
  • Library - Load previously scanned tracks from database
  • Plus Button - Add individual songs with "Play Now" or "Add to Queue"
  • Queue - View, search, and reorder your current playlist
  • History - See your recently played tracks

Mini Player

  1. Click the minimize icon in the bottom navbar
  2. A compact player window appears
  3. Control playback without the main window
  4. Click the red X to close mini player

Audio Controls

  • Equalizer - Adjust 10 frequency bands or use presets
  • Effects - Control playback speed and reverb intensity
  • Themes - Pick a color theme or enable auto-theme for variety

Themes

Choose from 8 beautiful themes:

  • Ember (Orange/Red)
  • Ocean (Blue)
  • Forest (Green)
  • Sunset (Pink/Purple)
  • Lavender (Purple)
  • Rose (Pink)
  • Amber (Yellow/Orange)
  • Mint (Teal/Green)

Enable Auto Theme to randomly change themes with each song!

Keyboard Shortcuts

  • Space - Play/Pause
  • Arrow Left - Previous track
  • Arrow Right - Next track
  • Swipe Left/Right - Skip tracks (touch devices)
  • Swipe Up - Open queue (touch devices)

System Requirements

Desktop App

  • OS: Windows 10 or later (64-bit)
  • RAM: 4GB minimum
  • Storage: 100MB for app + space for music library database

Web App

  • Browser: Chrome, Edge, Firefox, Safari (latest versions)
  • Storage: Depends on browser cache settings

Tips

  • Desktop: Use "Open Folder" to scan your entire music collection once, then use "Library" to load instantly
  • Search: Use the search bar in the queue to quickly find songs
  • Mini Player: Perfect for keeping music controls visible while working
  • Auto Theme: Enable for a fresh look with every song
  • Equalizer Presets: Start with a preset and fine-tune to your taste

Known Issues

  • Large music libraries (10,000+ tracks) may take time to scan initially
  • Album artwork extraction requires proper ID3 tags in your music files
  • Web app cannot access local file system directly (browser limitation)

License

This project is open source and available under the MIT License.

Contributing

Contributions are welcome! Please check out the Developer Setup Guide to get started.

Support


Developer Setup Guide | Download Latest Release | Web Player