chthollyphile / folia-major
화려한 가사 애니메이션 효과에 집중한 로컬 음악/navidrome/서드파티 NetEase 클라우드 플레이어
이 프로젝트에 대해
chthollyphile 님의 folia-major 프로젝트는 GitHub에서 952개의 별을 받으며 많은 개발자들의 주목을 받고 있습니다. 특히 TypeScript 환경에서 유용하게 활용될 수 있으며, 최근 오픈소스 커뮤니티에서 활발한 기여와 토론이 이루어지고 있는 트렌딩 레포지토리입니다.
Language Breakdown
🇰🇷 한국어 번역 README
AI 실시간 번역폴리아
가사 재해석 // 辞曲新境
桌面版下载 · Vercel 部署 · 使用指南 · 技术说明
项目简介
Folia是一个以全屏沉浸式歌词播放为核心的在线音乐播放器,支持网易云,navidrome和本地音乐库,通过智能歌词匹配,AI生成配色主题,以及多种全屏歌词动画为用户提供独特的听歌体验。
如果你希望직접 开箱即用,马上体验,추천 직접 사용基于Electron的 windows/macOS/Linux 桌面端版本。
만약 희망能够在移动设备上使用,或在浏览器 上体验云端多平台,可以选择一键部署到 Vercel 的 Web 版本,或自行部署到其他支持 Node.js 的平台。
展示
演示视频
主题预览
浮名 流光
心象 云阶
群唱 倾诉
不同的歌词动画具有不同的排版氛围和可调参数,让全屏歌词拥有如同文字PV般的丰富视觉效果,同时又能兼顾响应式布局,自动适配不同窗口尺寸。
核心能力
| 模块 | 说明 |
|---|---|
| 在线搜索与播放 | 搜索歌曲、歌手或专辑后即可播放,并自动加载相关封面与歌词。 |
| 本地音乐支持 | 可导入本地音频文件,在本地安全保存索引信息,不上传文件内容。 |
| 智能歌词匹配 | 本地歌曲可自动匹配在线歌词与封面,也支持手动修正匹配结果。 |
| 本地歌词文件识别 | 자동 加载同目录同명 '.lrc', '.vtt', '.ttml', '.qrc', '.yrc', '.krc' 歌词文件,或歌词文件内嵌 LRC 歌词。 适配 LDDC 생성의 增强型逐字歌词格式。 |
| 지금 접속 | 지지通过本机 Now Playing 服务接入外部播放器的歌曲、时间轴与歌词信息,并驱动 Folia 的舞台视图与全屏歌词渲染。 |
| AI 주제생성 | 基于歌曲情绪与歌词内容生成沉浸式背景与视觉参数。 |
| 多端体验 | 提供 Web 部署方式,同时支持桌面端打包分发。 |
桌面端下载
桌面版内置前后端运行环境,适合希望即装即用的用户。 最新版本请前往 Releases 页面。
Linux 包、Wayland / Hyprland 遥控窗和桌面端细节见 技术与开发说明。
文档与开发
더 완전한 사용说明请访问 Folia Guide.
部署, 환경변수, 本地开发、Stage API, 常用脚本和技术栈见 技术与开发说明.
如果你希望빠르게 上线 Web 版本,请阅读 Vercel 一键部署指南 来创建项目
本地音乐与匹配说明
사용本地音乐时,Folia 会优先尝试从以下来源补全信息:
- 音频文件自身元数据
- 同目录同名歌词文件
- 在线匹配结果
如果自动匹配不准确,可以在播放界面的右侧面板进入“本地”选项卡,手动搜索并指定更合适的歌词、封面或元数据来源。 你也可以选择只使用本地信息,关闭在线匹配结果。
贡献者
이 당첨자들께 감사드립니다
🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.
이 정보는 AI가 자동으로 분석한 결과입니다. 정확한 내용은 원문을 확인하세요.
chthollyphile/folia-major GitHub 원문 바로가기 →