# SpectraFlow 🌈⚡
> The Ultimate Open-Source Offline Music Archiver & Hi-Fi FLAC Player for Android & Desktop.

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Flutter](https://img.shields.io/badge/Built%20with-Flutter-02569B?logo=flutter)](https://flutter.dev)
[![Audio: Hi-Res FLAC](https://img.shields.io/badge/Audio-Lossless%20FLAC-00F2FE)](#)
[![Lyrics: Synced LRCLIB](https://img.shields.io/badge/Lyrics-Synchronized%20LRC-FF2E93)](#)
[![Live Demo](https://img.shields.io/badge/Live%20Demo-Preview%20Site-00F2FE?logo=google-chrome&logoColor=black)](https://beerbro6.github.io/spectraflow-preview/)
[![Latest Release](https://img.shields.io/github/v/release/BeerBro6/spectraflow?color=9D4EDD&label=APK%20Release)](https://github.com/BeerBro6/spectraflow/releases/latest)
[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/beerbro6)

---

> ### ⚠️ Disclaimer
> - **Educational & Personal Use:** This project is developed strictly for educational and personal use.
> - **Content Ownership:** SpectraFlow does not host, store, archive, or own any copyrighted media content. It streams, caches, and resolves audio strictly from user-provided endpoints and connected platforms.
> - **Terms of Service Compliance:** End users bear full responsibility for complying with the terms of service, policies, and regulations of any platform or service they interface with through this application.
> - **Non-Affiliation:** This project is independent and is not affiliated with, endorsed by, authorized by, or sponsored by any third-party streaming platform or corporate service.

---

## 💎 Features at a Glance

- **Multi-Format Extraction:** Download music in true Lossless **FLAC**, **OPUS** (high efficiency), **MP3** (320kbps), or **M4A**.
- **Smart Deduplication:** Intelligently cleans artist names, removes duplicate tracks, and prevents redundant downloads.
- **Synchronized Karaoke Lyrics:** Real-time scrolling lyrics powered by the LRCLIB API with automatic timing alignment.
- **Hi-Fi Playback Engine:** Studio-grade playback powered by `just_audio` with seamless background playback and lock-screen controls.
- **Glassmorphic Material 3 Design:** Built around the **Prism Soundwave** aesthetic featuring dynamic color shifting, neon waveforms, and frosted acrylic card overlays.
- **Open Storage:** Saves music directly to your public `/Music/SpectraFlow/` directory and triggers automatic Android media indexer refresh.
- **Privacy First & Zero Ads:** 100% Free and Open Source. No trackers, no bloatware, no telemetry.

---

## 🚀 Getting Started

### Prerequisites
- Flutter SDK (>= 3.13.0)
- Android SDK (API Level 21+)

### 📱 Direct Download (Android APK)
Pre-built installable APK files are available in [Releases](https://github.com/BeerBro6/spectraflow/releases).

### Build from Source
```bash
# Clone the repository
git clone https://github.com/BeerBro6/spectraflow.git

# Enter project directory
cd spectraflow

# Get packages
flutter pub get

# Run on connected device or emulator
flutter run
```

---

## 💖 Support the Project

If you love **SpectraFlow** and want to support ongoing development, lossless sound research, and project maintenance, consider buying me a coffee!

<a href="https://buymeacoffee.com/beerbro6">
  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="180" />
</a>

---

## 📜 License
Distributed under the **GNU General Public License v3.0**. See `LICENSE` for more information.