觅影 OmniPlay：多端海报墙媒体库播放器

项目简介

觅影 OmniPlay 是一款面向本地硬盘、外接硬盘、NAS 和家庭媒体服务器的媒体库播放器。它会扫描媒体文件、自动刮削 TMDB / 豆瓣元数据，生成海报墙与分集剧照，并用 mpv / FFmpeg 播放栈完成本地与远程播放。仓库是多端合集，包含 macOS ARM、macOS Intel、Windows 和安卓 TV 四个客户端工程。macOS ARM 版为功能基准，其他端持续对齐，但交互按平台习惯各自重做。

主要功能

• 媒体库海报墙：展示全部已入库影视，支持搜索、按名称/评分/年份排序与升降序切换；电影与剧集自动识别，支持多季、特别篇、分集排序与连播，并记录继续播放进度和已播/未看/未看完状态。
• 多种媒体源：本地文件夹、外接硬盘、已挂载 NAS 目录，以及 WebDAV、Plex、Emby、Jellyfin、Lucky STUN 穿透等；Windows 与安卓 TV 还支持 SMB。媒体源可启用/停用、重命名、移除并清理索引。
• 扫描与刮削：启动自动扫描和手动同步，未匹配文件进入刮削队列；TMDB 提供标题、简介、评分、海报和分集剧照，豆瓣补充评分与中文条目，导演、主演和作品名可补全中文译名并缓存。
• 播放：统一使用 mpv / FFmpeg 播放栈，支持蓝光 ISO / BDMV、续播定位、默认音轨/字幕和画质模式；播放页使用刮削后的影视名与季/集信息。
• 平台特色：mac 版支持直接打开视频文件、NeoDB 标记/评分/评论同步、液态玻璃主题与离线缓存；Windows 版支持离线缓存和 SMB；安卓 TV 版提供遥控器 D-pad 导航与手机触摸海报网格双入口。

安装与使用

仓库按平台拆成独立工程，需要分别构建；资料中未提供统一安装包。
macOS 使用 xcodebuild 编译 OmniPlay.xcodeproj，首次编译需能访问 GitHub 解析 MPVKit 等 Swift Package。
Windows 进入 OmniPlay-win 后用 dotnet 构建 .slnx 方案，多节点调度需加 -m:1。
安卓 TV / 手机进入 OmniPlay-安卓TV 执行 ./gradlew assembleDebug，TV 与手机共用一个 APK。
若 TMDB 或图片域名直连超时，可在设置中填写反向代理网关；网关需保留 /3/... 转发 API、/t/p/... 转发图片的路径结构。

注意事项

• 各端能力并不完全一致：mac 版功能最全；Windows 与安卓 TV 在 Plex/Emby/Jellyfin、SMB、NeoDB、离线缓存等能力上存在差异，使用前可对照仓库中的支持矩阵。
• 项目以 AGPL-3.0 发布，并包含或依赖 GRDB、mpv、FFmpeg、MPVKit 等三方组件；重新打包或替换播放器栈时需重新确认对应许可证与再分发义务。
• 软件仅用于管理和播放用户有权访问的本地或 NAS 媒体文件；TMDB、豆瓣的元数据、海报和剧照版权归各自权利方所有。

本作品整理自 GitHub 开源项目 nandieling/OmniPlay，原作者 @nandieling，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。