Visualize music with synchronized lyrics and AI-generated themes
Folia is a music player that combines online music services with local files to provide an immersive audiovisual experience. It focuses on lyric synchronization and visual effects, turning music listening into a media experience where lyrics animate across the screen and background colors shift to match the song's mood.
Combining lyrics and visual effects
Folia reinterprets lyrics as visual elements rather than simple text. It offers various lyric animation modes that make lyrics move across the screen in sync with the song's rhythm and content. The application uses AI to analyze the song's emotion and lyric content to automatically generate background colors and visual parameters. These effects support responsive layouts, optimizing for screen sizes from desktop to mobile. Users can also adjust animation parameters directly to customize the style to their preference.
Source support and local library management
The player supports various online music services, including NetEase Cloud, QQ Music, KuGou Music, and Navidrome.
- Online service integration Search and playback features from major music platforms are integrated for management within a single interface.
- Local file security When indexing local music, file content remains local, and only metadata is processed.
- Automatic lyric matching For local tracks, the system automatically finds and links online lyrics and images.
Folium module system and extensibility
The desktop version includes an experimental module system called Folium. This allows users to add custom-developed lyric animations, backgrounds, and UI elements. Users can install certified modules from the official module marketplace or utilize modules shared by the community. Each module undergoes a security check before execution and can invoke local tools like ffmpeg through a Node.js environment. Since this system is still experimental, users who prioritize stability should exercise caution.
Deployment methods and environment requirements
Folia is available as a desktop app for Windows, macOS, and Linux, as well as a Node.js-based web version. The web version can be easily deployed to Vercel or Cloudflare, and on mobile devices, it can be installed and used as a PWA. The desktop app is provided as an installation package, allowing immediate use without separate environment configuration. When deploying the web version, specific environment variables are required for QQ Music integration, and HTTPS secure context is needed for local music access. Self-hosting via Docker Compose is also supported, enabling operation in personal server environments such as NAS.
Pre-use considerations
This project is released under the AGPL-3.0 license, and commercial use is prohibited. Because it was developed with AI assistance, minor bugs or unexpected behavior may occur. Copyright for online music services belongs to each platform, so redistributing content or using it commercially through Folia is forbidden. The module system is an experimental feature available only in the desktop version and is disabled by default. For stable usage, it is recommended to use official release versions and carefully select modules for installation.
