design

folia-major: Stunning Lyric Animations for Your Music App

Name: folia-major: Stunning Lyric Animations for Your Music App
Author: chthollyphile

Add eye‑catching, animated lyrics to any local music or Navidrome setup. Ideal for founders building engaging music players – backed by 3.9k+ GitHub stars.

From the repo · “专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器”

8,815 stars+2,364★ this week916 forksTypeScriptGuide quality 9/10 · reviewed Oct 9Updated 10/22/2026100% free · open source

What it does

Folia-major generates animated lyrics for music players, enhancing the listening experience with dynamic visual effects.

When to use it

•Creating a music streaming service with interactive lyrics
•Developing a karaoke application with synchronized lyrics
•Enhancing a local music player with animated lyrics for a better user experience

Ready-to-paste prompt

foliamajor --input 'song.mp3' --output 'lyrics.json' --style 'default'

Heads up: Folia-major requires a compatible music player, such as Navidrome or a third-party NetEase Cloud Music player, to function properly

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/folia-major && curl -fsSL https://workflowstacks.com/api/skills/folia-major/claude-skill -o ~/.claude/skills/folia-major/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How folia-major: Stunning Lyric Animations for Your Music App works

Codeflow

Free to inspect

Folia-major: Stunning Lyric Animations for Your Music App is a very large TypeScript project (~322k lines across 1472 code files, plus 504 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, AGPL-3.0 license, has a test suite.

Size

Very large codebase

~322k lines · 1472 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Node.js

Needs API keys (.env)

TypeScript 91%JavaScript 7%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
src/App.tsx
Where the program starts running
4
package.json
Dependencies and the commands it exposes
5
.env.example
The API keys and settings you must provide

What's in each folder

src/Core code — the actual logic1330 files

skills/Prompts, skills & agent definitions19 files

worker/Backend / API7 files

api/Backend / API5 files

docs/Documentation18 files

dev/Folder66 files

electron/Folder47 files

mods/Folder40 files

READMEHas testsDocumentedCI checksAGPL-3.0 licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/folia-major && curl -fsSL https://workflowstacks.com/api/skills/folia-major/claude-skill -o ~/.claude/skills/folia-major/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

chthollyphile

Language

TypeScript