# Loonify

> Loonify is an open-source, high-performance cross-platform desktop music player engineered with Flutter, Dart, libmpv, and Go. It unifies playback and discovery across Yandex Music, Spotify, SoundCloud, YouTube Music, EMG Live Radio, and local audio into a single GPU-accelerated interface.

## Overview
Loonify is designed as a lightweight, modern alternative to heavy Electron-based music apps. By leveraging Flutter's native Impeller/Skia GPU rendering and libmpv for audio decoding, it delivers instant responsiveness, minimal memory usage, and near-zero CPU consumption during playback.

## Key Features
- **Multi-Source Streaming**: Native search, catalog browsing, and streaming from Yandex Music, Spotify, SoundCloud, and YouTube Music.
- **Intelligent Audio Fallback**: If a track is geo-restricted or unavailable on one service, Loonify automatically and seamlessly resolves a high-bitrate playable stream from alternative sources without interrupting playback.
- **Synchronized Karaoke Lyrics**: Real-time line-by-line and syllable-synced lyrics powered by Musixmatch, SpicyLyrics, and LRC providers.
- **Live Radio**: Integrated EMG Radio streaming network (Europa Plus, Retro FM, Radio 7, Dorognoe, Studio 21, Novoe Radio) with live station switching.
- **Punchy Audio Visualizer**: Procedural audio spectrum analyzer with spring-damper physics, bass transients, peak drops, and support for custom beat-reactive GIF/image visualizers.
- **OBS Studio Stream Overlay**: Integrated local HTTP overlay server on port 19847 serving transparent, animated Now Playing widgets with live artwork and timelines for content creators.
- **Performance & Battery Efficiency**: Dedicated performance settings with configurable particle density, visualizer styles, cache management, and optional background animation throttling (~0% CPU in background/games).
- **Custom Theme Workshop**: Complete theme customization including background modes, custom images/videos, glassmorphism, animated particles (snow, rain, petals), custom cursors (.cur), and `.loonth` archive import/export.
- **Offline Mode & Storage**: Local track caching and full offline library downloads.
- **Discord Rich Presence**: Real-time listening status broadcasting with album art and play state.

## Technical Specifications
- **Client Framework**: Flutter (Linux, Windows, macOS, Android)
- **Programming Language**: Dart, C/C++ (via FFI for libmpv)
- **Audio Engine**: libmpv via media_kit
- **Backend Service**: Go (Golang) microservice running at `https://api.loonify.xyz`
- **License**: GNU General Public License v3.0 (GPL-3.0)
- **Repository**: https://github.com/nurssssky-alt/Scarlet
- **Official Domain**: https://loonify.xyz

## Common Questions (FAQ)

### What is Loonify?
Loonify is an open-source cross-platform desktop music player that brings together multiple music streaming services (Spotify, Yandex Music, SoundCloud, YouTube Music) and local music files into a single unified client.

### Is Loonify free and open source?
Yes, Loonify is 100% free and open-source software licensed under GPL-3.0.

### Which platforms are supported?
Loonify supports Linux, Windows, macOS, and Android.

### How does Loonify achieve high performance?
Unlike Electron or Chromium-based music players that consume hundreds of megabytes of RAM and significant CPU, Loonify is compiled to native machine code with Flutter and uses libmpv for audio decoding, using significantly fewer system resources.