folia-major

Project Overview

Folia is an online music player centered on immersive full-screen lyrics playback, supporting NetEase Cloud Music, Kugou, Navidrome, and local music libraries. Through smart lyrics matching, AI-generated color themes, and various full-screen lyrics animations, it provides a unique listening experience. It offers Electron-based desktop versions for Windows/macOS/Linux and a Node.js-based Web version, supporting multi-platform deployment.

Key Features

• Online search and playback: Search for songs, artists, or albums and play instantly with automatic cover and lyrics loading
• Local music support: Import local audio files with secure local indexing, without uploading file contents
• Smart lyrics matching: Local songs automatically match online lyrics and covers, with manual correction support
• Local lyrics file recognition: Automatically loads .lrc, .vtt, .ttml, .qrc, .yrc, .krc files with matching names, or embedded LRC lyrics
• Now Playing integration: Connect external player song, timeline, and lyrics info via the local Now Playing service
• AI theme generation: Generate immersive backgrounds and visual parameters based on song mood and lyrics content
• Multi-platform experience: Web deployment and desktop packaging distribution

Target Audience

• Music enthusiasts
• Listeners who enjoy full-screen lyrics and visual effects
• Self-hosted Navidrome users

Quick Start

1. Get the desktop version from GitHub Releases
2. Or deploy the Web version to Vercel
3. Refer to the usage guide for configuration

Core Advantages

• Immersive full-screen lyrics animations with rich visuals
• Supports multiple online sources and local music
• AI-generated color themes
• Open-source and free

System Requirements

• OS: Windows, macOS, Linux (desktop); Web version supports any modern browser