Folia音乐播放器移动端是一款把听歌与可视化歌词放在核心位置的开源音乐播放器。它采用现代化极简Web设计，界面干净，没有广告插入，也没有社交动态或推荐流打断情绪。专属可视化渲染引擎会让歌词跟随旋律、节奏出现逐字动画、渐变过渡和镜头变化，流光、心象、云阶、浮名、群唱等模式可切换。曲库来源并不单一，网易云音乐库、Navidrome私有云音乐库和本地音频文件都能接入；AI视觉生成模块还会结合歌曲情绪、歌词语义，生成背景与视觉参数。
1、歌词占据视觉中心：文字不再只是底部滚动字幕，全屏动态排版让播放页接近文字PV。
2、界面只保留音乐：社交动态、推荐流和广告都被拿掉，播放元素可全部隐藏，屏幕留给封面与歌词。
3、多来源统一管理：网易云、Navidrome与本地文件汇入同一浏览逻辑，切换来源后操作方式保持一致。
4、AI推断主题配色：AI结合语义、情绪和氛围推断配色，也能按歌词情感层次分段着色。
5、海报墙浏览内容：歌单、专辑和歌曲集合以卡片呈现，拖动、点击和键盘过滤都很直接。
6、系统媒体控制：支持SMTC与MPRIS，快捷键、外设和桌面遥控能融入日常播放流程。
顶部Tab承担来源切换。在线页面对应网易云收藏歌单，电台页承载推荐歌单、私人FM和日推，专辑页查看收藏专辑，本地页读取导入的音频，Navi页连接Navidrome服务器。在线歌曲可直接搜索播放并查看歌词封面；本地文件夹会读取标签、封面、内嵌歌词与同目录歌词；Navidrome可浏览专辑、歌手、播放列表和随机歌曲。视觉部分提供多种歌词动画、AI明暗双主题，舞台模式可接收外部歌词或媒体输入。
使用网易云相关能力前，需要在软件内登录对应账户。登录状态决定收藏歌单、私人FM、日推和专辑内容能否正常加载；部分歌曲要求账户具备相应会员权限，否则会出现无法播放的情况。若大量歌曲突然被标记为下架，先回到账户状态查看登录是否失效，界面头像仍在也不代表登录状态仍然有效。
不同来源入口集中在顶部区域，切换时不用改变浏览习惯。在线来源适合继续使用已经收藏的内容，本地来源适合整理无损音频，Navidrome则面向个人搭建的私有曲库。来源可以不同，卡片、海报墙、歌词动画和播放队列的呈现方式却保持统一。
所有歌曲集合、歌单和专辑都以卡片形式出现。点一张卡片，就能进入海报墙；顶部“全部”按钮用于展开当前视图下的全部卡片，适合卡片较多时快速纵览。顶部区域可展开左侧面板，查看当前歌单或专辑信息；右侧按钮则打开歌曲列表，帮助直接定位到某首歌。
海报墙支持鼠标、滚轮和触控拖动，单击歌曲可让它聚焦到当前位置。想找某首歌时，不用专门寻找搜索框，在页面内按下任意按键即可唤起过滤。过滤结果能够直接加入播放队列，省去逐层返回和翻找的步骤。
歌手与专辑页面也延续海报式组织。歌手页的信息条会呈现为凝彩风格海报，钉在墙面左侧，配色取自最热门的三张专辑；右侧专辑墙带有倾斜效果，拖动和滚动都可用。专辑页换成贴着封面、带立体标题的海报，进入时有入场动画；从歌手页点开专辑时封面会飞向海报，返回时飞回原位。整张专辑共用一张封面时，旁边的曲目墙会拼成完整大封面。
先从顶部Tab选择音源，需要网易云内容时完成登录。进入卡片或海报墙后选歌，播放页推荐用键盘或系统媒体控件控制暂停、切歌和进度。鼠标悬停左上角会出现返回入口，右下角按钮可展开控制面板。队列中的歌曲悬停后即可调整顺序，旁边三个操作分别是移到下一首、移到末尾和移出列表。退出播放页可点左上角返回图标，也可在右侧面板的歌曲封面上回到主页。
播放队列决定接下来的歌曲顺序。海报墙过滤出目标歌曲后，可直接把结果加入队列；正在播放时，悬停队列中的某首歌就能调整位置。三个常用动作放在明显位置：移到下一首、移到队列末尾、从列表移除。调整顺序不需要进入复杂编辑页，鼠标悬停后操作即可。
遇到不可播歌曲，队列会按规则处理。单独点击一首歌时，若存在可替代资源，会先弹出确认；确认后用替代资源建立队列，找不到则停在不可播放提示。选择“播放全部”时，不可用歌曲会在构建队列阶段被跳过，不会让整组播放中断。在线失败还会区分下架、断网或超时、服务异常、登录或会员限制、地区限制等情况；真正下架才自动切到下一首，断网时队列保留，可重试或跳过，相关能力已覆盖网易云、QQ音乐、酷狗和波点。
歌词动画设置藏在视觉设置中。点左上角设置图标进入设置中心，切到“选项”板块，再点“视觉设置”，屏幕上会出现画面与歌词显示调节面板。
下滑找到“歌词动画”区域，点“歌词动画样式”进入选择界面。“通用”页面调整字体和字号，字号偏大更适合远距离观看，偏小则能让单屏容纳更多文字。“歌词动画”页面提供流光、心象、云阶、浮名等模式，选中后可继续微调参数，让运动速度或呈现密度符合喜好。
凝彩、商籁等按词排版的效果依赖分词。中文按词切分，日文按文节切分，可避免文字被拆成零散片段；手动保存过的分词优先级更高。逐字动画若出现对不上，问题往往来自歌词文件缺少逐字时间轴，软件只能按整句时长估算。
AI主题按钮的作用不是简单替换封面色。已配置接口时，当前歌曲的歌词会发送给模型，返回一套包含浅色与深色的主题配置；配色会参考语义、情绪走向和歌曲氛围，也能顺着歌词的情感层次分段着色。纯音乐或没有合适歌词时，标题和氛围信息也能作为推断依据。
生成结果会按歌曲记忆。切到曾经生成过主题的歌曲，界面会自动换回那套配色；遇到从未生成主题的新歌，则继续沿用当前主题，不会每次切歌都自动重新请求。没有配置接口时仍可使用退化方案，从封面取色并结合内置主题生成结果，只是想换色时需要再次点按钮。
视觉生成还会影响背景与整体参数，而不只停留在文字颜色。配合可隐藏的播放页UI，封面、歌词和背景能形成更完整的画面；Sora一类背景在暂停时会停止绘制，静态星点保持定格，减少不必要的动态干扰。
播放页的界面元素可以全部隐藏，只留下封面、歌词和生成的背景。按F11进入或退出全屏，按H隐藏或恢复进度条与右侧按钮。远距离观看时，可在视觉设置中加大字号；近距离使用时，缩小字号能让单屏显示更多句子。
动态背景也考虑了暂停状态。Sora背景在暂停时停止绘制，静态模式下星点会定格，不会在停止播放后继续分散注意力。调整窗口尺寸或在安卓设备上打开设置覆盖层时，墙面显示保持稳定，不会闪出底层内容，部分可视化模式因窗口变化导致的中断也已减少。
舞台模式用于接收外部歌词或媒体输入，再用Folia的播放页呈现视觉效果。使用Folia音乐播放器移动端接入外部歌词时，外部信号可驱动同一套播放页面，适合把已有播放系统与歌词动画连接起来。
它的底层形态偏向Web应用，也可部署到Vercel，或通过Electron在桌面环境获得完整体验。Linux环境下运行稳定，并支持SMTC与MPRIS媒体控制协议，系统级播放控制、键盘快捷键和外设联动可以接入日常工作流。桌面增强能力还包括独立遥控窗、视频录制和平台级窗口控制。
网页版或PWA断网后仍可启动，本地封面在离线状态下也能显示；主题图标按需加载，启动时加载的内容更少。网络不稳定时，已缓存的本地资源仍可浏览。
本地曲库通过导入文件夹建立。软件会自动读取音频标签、封面、内嵌歌词以及同目录歌词文件，FLAC、MP3等常见格式可纳入同一面海报墙。不需要把所有歌曲都搬到在线歌单，珍藏的高清音频也能获得与在线内容一致的歌词动画。
Navidrome接入面向私有云音乐库。连接服务器后，可以浏览专辑、歌手、播放列表，也能随机选取歌曲。自己整理的元数据、封面和歌词会在统一界面中出现，适合已经搭建个人音乐服务器的用户。
离线场景主要依赖本地文件和已缓存资源。网络异常时，在线音频可能因缓冲中断导致动画停顿，因为动画时间轴跟随音频播放时钟；本地文件若播放正常，就能判断问题更多来自网络或代理路径。
播放页推荐使用键盘或系统媒体控件。海报墙内按任意键可唤起过滤，媒体键能处理播放、暂停和切歌，不用反复切回窗口；启动说明弹窗出现时，按Esc可关闭。
Linux环境支持SMTC与MPRIS，系统级控制、快捷键和外设联动都能接入。桌面端还有独立遥控窗、视频录制和平台级窗口控制，适合多窗口或外接屏幕的用法。
重视歌词观看体验的人，可以把它当作带动态排版的播放器。逐字动画、渐变和镜头变化适合安静听歌，也适合连接外部屏幕展示。网易云用户能延续收藏歌单、私人FM和日推习惯；本地音频收藏者可以集中管理FLAC、MP3文件；Navidrome用户则能在熟悉的终端中访问私有曲库。
工作时，简洁界面和系统媒体控制能减少切换成本；想调整氛围时，AI主题和多种Visualizer模式可以让同一首歌呈现不同气质。它不提供社交动态，也不塞入推荐噪音，注意力会回到歌曲本身。
Q：Folia逐字歌词为什么对不上或慢半拍？
A：多数原因是歌词文件没有逐字时间轴。软件只能依据整句持续时间估算每个字的进度，遇到密集歌词或长句时准确度会下降；使用包含逐字时间轴的歌词文件会明显改善。
Q：Folia怎么全屏或隐藏控制按钮？
A：按F11切换全屏，再按一次退出。按H可以隐藏进度条和右侧按钮，再按一次恢复显示。
Q：为什么大量歌曲都提示已下架或无法播放？
A：先检查网易云账户是否未登录或登录状态已过期。头像仍显示也可能失效，重新登录后通常能恢复可播放内容；会员权限不足的歌曲仍会受限制。
Q：播放时动画突然卡住，拖动进度条更明显怎么办？
A：先播放本地歌曲对比。本地正常而在线卡顿，通常是网络缓冲不顺畅，动画跟随音频时钟所以一起停顿；全局代理导致延迟时更容易出现。
Q：歌曲变灰、卡住或不能播放时会怎样处理？
A：下架、资源不可用或上游接口拿不到播放链接时，歌曲会被标记或变灰。单独点击且存在可替代资源时，会先询问是否使用替代资源；找不到则提示无法播放。点“播放全部”会直接跳过不可用歌曲。
Q：AI主题为什么会沿用上一首歌颜色，或没有主动操作却变色？
A：这是当前设计。曾为某首歌生成的主题会在切回时自动启用，新歌没有生成记录时沿用当前主题。未配置接口时使用封面取色的退化方案，需要再次点击按钮才会重新生成。
手游信息
读取外部存储 允许应用读取相册、视频或本地文档。 ------------------------------------- 读取音频 访问手机中的音乐文件（Android 13+）。 ------------------------------------- 发送通知 允许应用弹出通知消息（Android 13+）。 ------------------------------------- 前台服务 允许应用运行对用户可见的后台任务。 ------------------------------------- 访问网络 允许程序访问网络。 -------------------------------------
