Namida：功能丰富的音乐视频播放器

项目简介

Namida 是一款使用 Flutter 构建的音乐与视频播放器，界面精美、功能丰富，并原生支持 YouTube。它既管理本地音乐库，也能播放、下载与缓存 YouTube 音视频，还可接入 Subsonic、Jellyfin、WebDAV、SMB 等媒体服务器，在同一处统一管理多个来源的曲库。

主要功能

媒体库与索引

• 基于 taglib 的强大索引器与标签编辑器，读写更快、更可靠，输入时会联想已有标签值。
• 支持艺术家与流派分隔符、按文件夹组织的媒体库（可排除指定文件夹）、防止重复曲目、最小文件大小与时长过滤。
• 几乎可按任意曲目或专辑属性排序。

外观与交互

• 类 Material3 主题，并可从当前封面提取动态取色；自带首页、曲目、专辑、艺术家、流派、播放列表、文件夹、队列等页面，以及最常播放、心情、标签、评分、语言、统计等页面。
• 波形进度条、宽屏播放器布局、可视化效果、动态背景与自定义壁纸，提供大量自定义选项。

声音

• 参数化均衡器并支持 AutoEQ 导入；支持 Bit-perfect 播放、USB DAC 直连、独占模式（桌面端）与 32 位浮点音频。
• 可查看音频路径，选择输出设备，支持单声道；提供低音增强、混响、虚拟环绕、8D 音频、人声消除（Android）等音效。
• 智能交叉淡入淡出（含节拍匹配）、无缝播放、播放/暂停淡入淡出、跳过静音、速度与音高控制、响度增强、Replay Gain。
• 逐曲目的速度、音高、音量与均衡器设置，并可保存为声音预设一键切换。

流媒体与 YouTube

• 可选最佳画质/音质、仅音频与省流模式；支持多账号登录，获取动态、订阅、播放列表与通知。
• 视频视图支持手势控制音量、亮度、进度、全屏与倍速；支持 SponsorBlock、Return Youtube Dislike、分段与热力图，以及字幕与说明文字。
• 下载、缓存与离线播放，带缓存优先级；可按章节拆分下载、移除赞助片段。
• 下载标签配置与文件名构建器（类似 yt-dlp），例如：

# [04] music title [(channel name)]
[%(playlist_autonumber)s] %(title)s [(%(channel)s)]

# saving to separate folders
# music playlist/02. music title.m4a
%(playlist)s/%(playlist_autonumber)s. %(title)s.%(ext)s

系统集成

• 桌面小组件与快捷设置磁贴；支持 Android Auto 与 Wear OS、状态栏歌词。
• 桌面端提供系统托盘、键盘快捷键、全局热键与悬浮歌词窗口。
• 提供 Now Playing 广播与 Webhook，方便接入 Tasker、脚本与 scrobbler。

其他

• 歌词获取与显示（同步、纯文本、逐字 lrc/ttml），并可在内置编辑器中自行打轴。
• 带规则的智能播放列表（搜索中同样可用）、Listening Party 同步一起听、局域网内同步应用数据。
• 曲目与视频的书签与章节、统计图表与年度回顾页、支持模糊匹配的多字段搜索、可长期保存的播放队列、可编辑与导入的播放历史。
• 最常播放（任意时间范围）、自定义播放列表顺序与封面、M3U 与音乐服务器自动导入、全局多选、滑动操作与封面手势、文件夹图片（cover.jpg 等）与 .info.txt 简介。
• 睡眠定时器（按曲目或分钟）与暂停场景（来电、通知、音量为 0 等）。
• 趣味功能：Smort 曲目生成、Lost Memories（往年同期听过的歌）、随音频峰值运动的缩略图与粒子、Miniplayer 派对模式等。

MV 集成

本地媒体库可为音乐匹配视频：在指定文件夹中查找同名视频，文件名需包含音乐文件名、曲目标题与首位艺术家，或曲目的 YouTube ID（写在 comment 标签或文件名中）。若在 comment 标签或文件名中发现 YouTube 链接，则会下载并缓存后再播放。自 v4.0.0 起支持完整的视频库索引与独立播放。

注意事项

• 部分音效（如低音增强、混响、虚拟环绕、8D 音频、人声消除）仅在 Android 上可用；独占模式、系统托盘、悬浮歌词窗口等为桌面端特性。
• 从视频标题自动提取标题/艺术家/专辑的规则依赖视频命名格式，命名越规范效果越好；也支持用 none 字段覆盖其他设置。
• 具体安装包与版本请以项目发布页提供的文件为准。

---

本作品整理自 GitHub 开源项目 namidaco/namida，原作者 @namidaco。中文介绍由 AI 根据项目 README 整理，以原仓库为准。