Repolode
Submit
chthollyphile

chthollyphile/folia-major

A TypeScript music player focused on full-screen animated lyrics, supporting NetEase, QQ, Kugou, Navidrome and local libraries.

Open-source alternative to:Apple MusicSpotify

View on GitHubWebsite
Stars
8,114
Forks
840
Open issues
79
Last commit
yesterday

What is it?

Folia is an online music player built around full-screen, immersive lyrics. It plays music from NetEase Cloud Music, Kugou, QQ Music, Navidrome and local audio files, and the desktop build also adds Bodian Music, YouTube Music and Spotify. Lyrics are matched automatically, including word-level formats such as LRC, YRC, QRC and TTML, and several lyric animation styles can be tuned for different layouts.

The project ships as an Electron app for Windows, macOS and Linux, and as a Node.js-based web version. The web version can be deployed to Vercel or Cloudflare, installed as a PWA on phones, or self-hosted with Docker Compose. A sync server can share appearance settings and AI-generated color themes across devices.

The desktop version has an experimental mod system called Folium, which lets third-party code add lyric animations, backgrounds and commands. Mods must be confirmed by the user before they run.

Key features

  • 01Full-screen animated lyrics with multiple adjustable styles.
  • 02Plays NetEase, QQ Music, Kugou and Navidrome content, plus local audio files.
  • 03Automatic lyric and cover matching, with manual correction.
  • 04Reads sidecar and embedded LRC, TTML, QRC, YRC and KRC lyric files.
  • 05AI-generated color themes based on song mood and lyrics.
  • 06Desktop builds for Windows, macOS and Linux, and a deployable web version.

Use cases

  • Listening to music with synced word-level lyrics on a desktop.
  • Playing a self-hosted Navidrome or local music library with rich lyric display.
  • Deploying a personal music player to Vercel or a home server and using it as a PWA on a phone.

Quick start

  1. 1

    Clone the repository

  2. 2

    Download a desktop installer from the Releases page

  3. 3

    Deploy the Web version to Vercel with one click

Things to know

  • Requires Node.js 24 or higher for the Node-based setup.

Topics

#music-player#lyrics#react#typescript#pwa#navidrome#electron#self-hosted#ai#music

FAQ

What is folia-major?
A TypeScript music player focused on full-screen animated lyrics, supporting NetEase, QQ, Kugou, Navidrome and local libraries. Folia is an online music player built around full-screen, immersive lyrics. It plays music from NetEase Cloud Music, Kugou, QQ Music, Navidrome and local audio files, and the desktop build also adds Bodian Music, YouTube Music and Spotify. Lyrics are matched automatically, including word-level formats such as LRC, YRC, QRC and TTML, and several lyric animation styles can be tuned for different layouts.
Is folia-major free to use? What license does it have?
folia-major is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is folia-major still maintained?
Actively maintained. The last commit to folia-major was on Oct 19, 2026.
What can I use folia-major for?
Listening to music with synced word-level lyrics on a desktop. Playing a self-hosted Navidrome or local music library with rich lyric display. Deploying a personal music player to Vercel or a home server and using it as a PWA on a phone.
How do I install folia-major?
Clone the repository Download a desktop installer from the Releases page Deploy the Web version to Vercel with one click
Where can I get folia-major?
The source code and installation instructions are on GitHub: https://github.com/chthollyphile/folia-major

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects