Aurora

Aurora is a lightweight, open-source, cross-platform music player built for audiophiles and casual listeners alike.
It focuses on a clean interface, local playback, and full user control — without ads, tracking, or cloud dependencies.

---

Features

• Add and manage music by selecting local directories
• Supported formats - flac, mp3, m4a, wav (Head out to issues to request new formats).
• Browse music by album and artist
• Playlist management (create, edit, reorder — stored locally)
• Playback queue management
• Clean, distraction-free UI
• Works and tested on macOS, Windows, and Linux builds are being currently tested.

---

System Requirements

| Platform | Architecture | Status | Minimum OS | |---------|---------------|--------|------------| | macOS | Apple Silicon (ARM64) | ✅ Available | macOS 12.0 (Monterey) | | macOS | Intel (x64) | 🚧 Coming soon | macOS 12.0 (Monterey) | | Windows | x64 | 🚧 Coming soon | Windows 10 | | Linux | x64 | 🚧 Coming soon | Ubuntu 20.04+ (glibc 2.31+) |

---

Privacy & Security

Aurora is designed to be fully local-first:

• ❌ No telemetry
• ❌ No analytics
• ❌ No user tracking
• ❌ No background network requests
• ✅ All data stays on your machine

Aurora does not collect, store, or transmit any personal or usage data.

---

macOS — Important Notice (Unsigned App)

Aurora is currently not code-signed or notarized because it is distributed as an independent open-source project without an Apple Developer account.

What this means

When you open Aurora on macOS for the first time, you may see:

“Aurora cannot be opened because the developer cannot be verified.”

How to open Aurora safely

1. Download the .dmg from GitHub Releases
2. Drag Aurora.app into your Applications folder
3. Right-click Aurora.app → Open
4. Click Open again when prompted
5. (Optional) After first launch, macOS will trust the app normally

Aurora does nothing malicious — this warning exists purely because the app is unsigned.

---

Installation

macOS

• Download the .dmg from the Releases page
• Drag Aurora into Applications
• Follow the steps above to bypass Gatekeeper

Windows / Linux

Coming Soon

---

Development

Prerequisites

• Node.js ^20.19.5
• Yarn ^1.22.22

Run in development

git clone https://github.com/bbbneo333/aurora.git
cd aurora
yarn install
yarn start

---

Packaging

yarn package

Artifacts will be generated in the release output directory.

---

Releasing

See RELEASE

---

Bug Reports & Feedback

• Report bugs via GitHub Issues
• Feature requests and discussions are welcome

Please open an issue with:

• Clear steps to reproduce
• Expected vs actual behavior
• OS and Aurora version
• Screenshots or logs if available

👉 https://github.com/bbbneo333/aurora/issues

---

License

Aurora is released under the MIT License. See LICENSE for details.

Contribution

Feature requests may still be submitted through issues for discussion, but feature pull requests will not be accepted at this time.