Repolode
chthollyphile

chthollyphile/folia-major

Player de música em TypeScript com foco em letras animadas em tela cheia, compatível com NetEase, QQ, Kugou, Navidrome e bibliotecas locais.

Alternativa open source a:Apple MusicSpotify

Estrelas
8,114
Forks
840
Issues abertas
79
Último commit
ontem

O que é?

Folia é um player de música online pensado para exibir letras imersivas em tela cheia. Ele reproduz músicas do NetEase Cloud Music, Kugou, QQ Music, Navidrome e arquivos de áudio locais; a versão para desktop também oferece Bodian Music, YouTube Music e Spotify. As letras são sincronizadas automaticamente, inclusive em formatos com sincronização palavra por palavra, como LRC, YRC, QRC e TTML, e há vários estilos de animação que podem ser ajustados a diferentes layouts.

O projeto é distribuído como um app Electron para Windows, macOS e Linux e como uma versão web baseada em Node.js. A versão web pode ser implantada na Vercel ou na Cloudflare, instalada como PWA em celulares ou hospedada por conta própria com Docker Compose. Um servidor de sincronização pode compartilhar entre dispositivos as configurações de aparência e os temas de cores gerados por IA.

A versão para desktop inclui um sistema experimental de mods chamado Folium, que permite que código de terceiros adicione animações de letras, planos de fundo e comandos. O usuário precisa confirmar os mods antes que eles sejam executados.

Recursos principais

  • 01Letras animadas em tela cheia, com vários estilos ajustáveis.
  • 02Reproduz conteúdo do NetEase, QQ Music, Kugou e Navidrome, além de arquivos de áudio locais.
  • 03Busca automática de letras e capas, com possibilidade de correção manual.
  • 04Lê arquivos de letras LRC, TTML, QRC, YRC e KRC, externos ou incorporados.
  • 05Temas de cores gerados por IA com base no clima da música e nas letras.
  • 06Versões para desktop em Windows, macOS e Linux, além de uma versão web que pode ser implantada.

Casos de uso

  • Ouvir música no desktop com letras sincronizadas palavra por palavra.
  • Reproduzir uma biblioteca de música local ou do Navidrome hospedado por conta própria, com exibição avançada de letras.
  • Implantar um player de música pessoal na Vercel ou em um servidor doméstico e usá-lo como PWA no celular.

Início rápido

  1. 1

    Clone o repositório

  2. 2

    Baixe um instalador para desktop na página Releases

  3. 3

    Implante a versão Web na Vercel com um clique

Antes de usar

  • A configuração baseada em Node requer Node.js 24 ou superior.

Tópicos

Perguntas frequentes

O que é folia-major?
Player de música em TypeScript com foco em letras animadas em tela cheia, compatível com NetEase, QQ, Kugou, Navidrome e bibliotecas locais. Folia é um player de música online pensado para exibir letras imersivas em tela cheia. Ele reproduz músicas do NetEase Cloud Music, Kugou, QQ Music, Navidrome e arquivos de áudio locais; a versão para desktop também oferece Bodian Music, YouTube Music e Spotify. As letras são sincronizadas automaticamente, inclusive em formatos com sincronização palavra por palavra, como LRC, YRC, QRC e TTML, e há vários estilos de animação que podem ser ajustados a diferentes layouts.
folia-major é gratuito? Qual é a licença?
folia-major é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
folia-major ainda é mantido?
Manutenção ativa. O último commit de folia-major foi em 19 de out. de 2026.
Para que posso usar folia-major?
Ouvir música no desktop com letras sincronizadas palavra por palavra. Reproduzir uma biblioteca de música local ou do Navidrome hospedado por conta própria, com exibição avançada de letras. Implantar um player de música pessoal na Vercel ou em um servidor doméstico e usá-lo como PWA no celular.
Como instalar folia-major?
Clone o repositório Baixe um instalador para desktop na página Releases Implante a versão Web na Vercel com um clique
Onde consigo folia-major?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/chthollyphile/folia-major

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados