Ghosten-Player

项目概述

当你要把网盘、Emby 服务器和移动硬盘里的片子收进同一个界面时，Ghosten Player 给出的做法是先刮削元数据、排成海报墙，再把直播源挂上去。

客户端用 Flutter 编写，手机/平板与 Android TV 分成两个入口，安装包约 15 MB，媒体库与观看记录都保存在本地，不需要自建后端。

片源可以来自阿里云盘、夸克网盘、WebDAV、本地文件，也可以接 Emby 与 Jellyfin 服务端；元数据支持 TMDB 与 nfo 两种来源。

项目	内容
平台	Android 6.0 及以上
技术栈	Flutter，Dart SDK 3.7.2 及以上
安装包	约 15 MB
元数据	TMDB、nfo
许可	AGPL-3.0

一个装得下网盘、NAS、直播源和字幕的本地影视库。

主要功能

• 自动刮削：按文件名匹配 TMDB 信息，也可读取同目录 nfo，生成海报、简介与演职员
• 网盘接入：支持阿里云盘、夸克网盘、WebDAV 与本地文件，可浏览、管理、下载
• Emby 与 Jellyfin：登录媒体服务器后可多账号切换，直接播放服务器上的影片
• 边下边播：网盘文件在下载的同时开始播放，并支持多线程网络加速
• IPTV：导入直播源后自动分组，支持线路切换与 EPG 节目单
• 手势播放：双击播放或暂停、左右拖动快进、上下滑动调音量与亮度、双指缩放、长按倍速
• 字幕支持：内嵌字幕与外置字幕均可加载，外置支持 xml、vtt、ass、srt 四种格式
• 跳过片头片尾：为剧集设置起止时间点，播放时自动跳过
• DLNA 投屏：把画面推到同一网络的电视或盒子
• 数据同步：多台设备之间同步观看记录与媒体库配置

媒体库与资源

• 媒体来源：阿里云盘、夸克网盘、WebDAV、本地文件，以及通过 USB 接入的外接设备
• 媒体服务器：Emby 与 Jellyfin 支持多账号登录，可浏览服务器媒体库并直接播放
• 元数据刮削：在设置中开启 TMDB 刮削，或读取与影片同目录的 nfo 文件
• 清晰度与下载：阿里云盘资源播放时可切换清晰度，网盘文件支持边下边播与多线程加速

客户端形态

• 手机与平板：app-arm64-v8a-release.apk 与 app-armeabi-v7a-release.apk
• Android TV：app-arm64-v8a-tv-release.apk 与 app-armeabi-v7a-tv-release.apk，与手机包互不通用
• 遥控与输入：TV 端可为遥控器自定义按键，手机端可辅助电视输入文字
• 界面缩放：可调整界面大小，适配不同尺寸与分辨率的屏幕

适用人群

• Android 电视用户
• 自建 NAS 的影迷
• 阿里云盘重度用户
• Emby/Jellyfin 用户
• 需要直播源的家庭

安装与权限

• 架构选择：arm64-v8a 适合多数手机，armeabi-v7a 适合低配设备与多数电视盒子
• 端类型：手机/平板包与 TV 包分开安装，混用会出现界面错位或遥控器无法操作
• 文件访问：读取本地视频与外接 USB 设备需要授予文件访问权限
• 局域网通信：访问局域网内的 WebDAV、Emby、Jellyfin 与 DLNA 投屏需允许局域网访问
• 自动更新：应用内检查新版本并下载 APK，由系统完成覆盖安装

系统要求

项目	要求
操作系统	Android 6.0 及以上
支持架构	arm64-v8a、armeabi-v7a
客户端类型	手机/平板与 Android TV 分包
构建环境	Flutter，Dart SDK 3.7.2 及以上
许可	AGPL-3.0

注意事项

• 分包不通用：手机包与 TV 包装错会导致布局错位、遥控器焦点失效
• 数据存本地：媒体库配置与观看记录不跟随账号漫游，换设备时需用数据同步功能迁移
• 网盘限速：播放速度受网盘服务端限速影响，多线程加速只能改善部分场景
• 不含片源：应用本身不提供任何影视内容，只播放用户自己添加的资源