Ghosten-Player

Project Overview

Ghosten Player takes the videos you already keep on a cloud drive, an Emby server, or a USB disk, scrapes metadata into a poster wall, and layers IPTV on top.

It is a Flutter app with separate entry points for phones and tablets and for Android TV, an installer of about 15 MB, and a fully local database that needs no backend.

Media can come from Aliyun Drive, Quark Drive, WebDAV, local files, or Emby and Jellyfin servers, and metadata can be scraped from TMDB or read from nfo files.

Item	Value
Platform	Android 6.0 and above
Stack	Flutter, Dart SDK 3.7.2 and above
Installer size	About 15 MB
Metadata	TMDB, nfo
License	AGPL-3.0

A local media library that holds cloud drives, NAS storage, live channels, and subtitles.

Key Features

• Automatic scraping: matches file names against TMDB, or reads a sibling nfo file, to build posters, synopses, and cast lists
• Cloud drive access: Aliyun Drive, Quark Drive, WebDAV, and local files can be browsed, managed, and downloaded
• Emby and Jellyfin: sign in to a media server, switch between multiple accounts, and play its library directly
• Download and play: starts playback while a cloud file is still downloading, with multi-threaded acceleration
• IPTV: imports live source lists, groups channels automatically, and supports line switching with an EPG schedule
• Gesture playback: double tap to play or pause, drag sideways to seek, swipe vertically for volume and brightness, pinch to zoom, long press for speed
• Subtitle support: embedded tracks plus external subtitles in xml, vtt, ass, and srt formats
• Intro and outro skip: stores start and end marks per episode and skips them during playback
• DLNA casting: pushes the picture to a TV or box on the same network
• Data sync: keeps watch history and library settings aligned across devices

Library and Sources

• Media sources: Aliyun Drive, Quark Drive, WebDAV, local files, and external storage over USB
• Media servers: Emby and Jellyfin accept multiple accounts, letting you browse and play their libraries
• Metadata scraping: enable TMDB scraping in settings, or read an nfo file stored next to the video
• Quality and download: Aliyun Drive items can switch quality during playback, and cloud files support download-and-play plus multi-threaded acceleration

Client Variants

• Phones and tablets: app-arm64-v8a-release.apk and app-armeabi-v7a-release.apk
• Android TV: app-arm64-v8a-tv-release.apk and app-armeabi-v7a-tv-release.apk, which do not work interchangeably with the phone builds
• Remote and input: TV builds accept custom remote-control keys, and a phone can type text for the TV
• Interface scaling: the UI size can be adjusted for different screen sizes and resolutions

Target Audience

• Android TV owners
• Movie fans running a NAS
• Heavy Aliyun Drive users
• Emby and Jellyfin users
• Households with live TV sources

Installation and Permissions

• Architecture choice: arm64-v8a suits most phones, while armeabi-v7a fits older devices and most TV boxes
• Client type: phone and TV packages install separately, and mixing them breaks layout or remote navigation
• File access: reading local video and external USB storage requires file access permission
• LAN access: reaching WebDAV, Emby, Jellyfin, and DLNA casting on the local network requires local network access
• Auto update: the app checks for a new version in-app, downloads the APK, and lets the system install it over the old one

System Requirements

Item	Requirement
OS	Android 6.0 and above
Architecture	arm64-v8a, armeabi-v7a
Client type	Separate phone/tablet and Android TV builds
Build environment	Flutter with Dart SDK 3.7.2 and above
License	AGPL-3.0

Notes

• Packages are not interchangeable: installing the phone build on a TV, or the reverse, breaks the layout and remote focus
• Local data only: library settings and watch history do not follow an account, so moving devices requires the data sync feature
• Cloud drive throttling: playback speed depends on provider-side limits, and multi-threaded acceleration only helps in some cases
• No content included: the app ships no video content and plays only the resources you add