my-nas

项目概述

MyNAS（my-nas）是一款跨平台的家用 NAS 媒体管理客户端，用 Flutter 开发，可在 macOS、Windows、iOS、Android 与 Linux 上运行。它把用户常用的多种数据源——NAS 协议、媒体服务器、下载器、PT 站、字幕站与媒体追踪服务——整合到一个客户端，不绑定特定 NAS 品牌，由用户自带数据源。你可以在视频详情页一键串联「找资源 → 下载 → 入库 → 播放」，用一个统一、现代的界面访问家里所有媒体资源。

不绑品牌，你带数据源，一个 App 管全屋媒体。

主要功能

• 多 NAS 适配：支持群晖、绿联、飞牛、威联通、WebDAV、SMB 与本地存储
• 媒体服务器：对接 Jellyfin、Emby、Plex，支持进度同步、继续观看与下一集
• 视频播放：支持主流容器与编码，含字幕延迟、倍速、画中画与投屏
• AI 字幕翻译：将当前字幕轨翻译为目标语言，结果在本地缓存
• 音乐播放：支持有损与无损格式，含锁屏控制、桌面歌词与十段均衡器
• 漫画与书籍：阅读 CBZ、EPUB、PDF 等格式，支持书签、目录与 TTS 朗读
• 照片管理：相册、时间线与 EXIF，并支持人脸识别与人物聚合
• 笔记：Markdown 渲染、树形目录与搜索
• 文件浏览：列表与网格视图，支持复制、移动、上传下载与分享
• PT 与下载器：通用 PT 站搜索，并一键发送到 qBittorrent、Transmission、Aria2 等
• 媒体追踪：Trakt.tv OAuth 同步待看、在看、已看与评分

适用人群

• 使用 NAS 管理家庭媒体的用户
• 同时拥有多个媒体服务器与下载器的人
• 需要跨设备统一体验的追剧用户
• 想集中管理照片、书籍与漫画的整理者

快速上手

1. 安装 Flutter SDK（3.44.9 及以上）并克隆仓库
2. 执行 flutter pub get 与 dart run build_runner build --delete-conflicting-outputs
3. 按平台运行，例如 flutter run -d macos
4. 在应用内添加数据源，填写 NAS 或媒体服务器的地址与账号
5. 进入视频、音乐等板块浏览并播放

核心优势

• 数据源自由：不绑定品牌，可同时连接群晖、Plex、qBittorrent 与任意 PT 站
• 一站式串联：从找资源到下载、入库、播放都在同一客户端完成
• 全平台覆盖：桌面、移动与电视端体验一致
• 功能完整：视频、音乐、照片、漫画、书籍、笔记与文件管理一应俱全

系统要求

项目	要求
操作系统	macOS 11.0+、Windows 10+、iOS 12.0+、Android 6.0+、Linux
开发环境	Flutter SDK 3.44.9+、Dart 3.2+
数据源	任一受支持的 NAS、媒体服务器或下载器

注意事项

• 在 macOS / iOS 上自行构建需先替换 Bundle ID、Team ID 与 App Group 等标识
• 音乐刮削仅写入元数据与封面，不下载或传播音频本体
• 启用商业平台刮削源前会展示风险提示，请仅用于管理合法获取的音乐
• 在线书源需用户自行导入，应用不内置任何书源