# guoapp (Xanerix/guoapp)

> A Flutter client for short dramas and films that adapts its layout to phone, tablet, computer and TV. It is adapted from fish2018's source code and plays content from third-party sites instead of hosting its own.

- GitHub: https://github.com/Xanerix/guoapp
- GitHub.Locker page: https://github.locker/Xanerix/guoapp
- Stars: 724
- Language: Dart
- License: GPL-3.0
- Last push: 2026-10-31

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is it a phone app, a desktop app, or a TV app?**

It is one app that changes layout per device: a bottom bar on phones, a collapsible sidebar on tablets and computers, and top tabs on TV.

**How do I get it running?**

Download the build for your platform from Releases: an APK for Android (arm64-v8a fits most phones), a ZIP for Windows, an unsigned IPA for iOS, or a dmg for macOS. Files starting with hongguojian- are the 红果鉴 build and files starting with zhenguojian- are the 真果鉴 build.

**Do I need anything extra to install it on iOS or macOS?**

On iOS the IPA is unsigned, so you must sign it yourself or sideload it with a tool like iloader. On macOS the app is not notarized, so you have to run an xattr command before the first launch.

**Any install pitfalls I should know about?**

Yes. Installing an Android APK built for the wrong CPU architecture fails with the INSTALLFAILEDNOMATCHINGABIS error, so pick the file that matches your device.

**Can I download episodes and watch them without internet?**

Yes, on phone, tablet and desktop. Each finished episode is converted to a regular mp4 file saved under the download folder by show and episode number, so you can copy it out. The TV version does not offer downloads.

**Does it send my data anywhere?**

Update checks only read the latest version number. The optional anonymous usage stats send a random ID, app version, platform and variant, with no watch history, searches or settings. Both can be turned off under Settings > About.

**How does tracking a show work?**

Mark a show as followed and it appears under 'Has updates' with the count of new episodes when one is out. The app checks a batch of unfinished followed shows every 30 minutes in the background.

**How do 红果鉴 and 真果鉴 differ?**

红果鉴 only includes the 红果 source. 真果鉴 includes all sources, and you can switch each one on or off in Settings.

**Can several people share one install?**

Yes, it supports multiple users. Each user keeps their own follows, history and searches, and admins choose which sources each user can access and whether they may download.

**Can I back up my data?**

Yes, you can export and restore users, follows, watch history and preferences, including the theme color. Downloaded videos are not affected, and older backups still import.


---

## README (checked against GitHub 2026-11-03)

Source: https://github.com/Xanerix/guoapp/blob/main/README.md

# 红果鉴 / 真果鉴

Flutter 多端独立短剧 / 影视应用，手机、平板、电脑和电视分别适配。

本项目改编自 [fish2018](https://github.com/fish2018) 的源码。

Telegram：[交流群组](https://t.me/+c9YKHp7FjSk0MjI1) · [更新频道](https://t.me/+F9NnQSsMfOU3OTdl)

- **红果鉴**：只含红果站源。
- **真果鉴**：含全部站源，可在设置里逐个开关。

## 使用

| 功能 | 说明 |
| --- | --- |
| 导航 | 发现 / 追剧 / 我的。手机用底栏，平板和电脑用侧栏（可收起），电视用顶部 Tab；宽屏的子页面在侧栏右侧打开 |
| 界面模式 | 自动识别、电视、手机、平板、窗口（只有电脑提供）；手动选定后不随窗口宽度切换。电视模式强制横屏，手机模式锁定竖屏 |
| 主题 | 跟随系统取色（Android 12+ 跟随壁纸，Windows 和 macOS 跟随强调色）或 6 个预设色板；浅色 / 深色 / 跟随系统 |
| 发现 | 站源名旁切换站源；分类 Tab 依次为推荐 / 全部 / 各榜单 / 各题材，榜单封面标出名次。第一个 Tab 顶部大卡片显示最近看过或推荐的剧。滑到底自动加载，下拉或「刷新」重新拉取当前分类 |
| 搜索 | 只搜当前站源，保留最近搜索；红果有输入联想 |
| 详情 | 封面模糊作底，显示集数、完结状态、分类、播放量、标签和简介；选集每组 30 集，落在续播那一集，看过的集变浅，VIP 集有标记。打开时后台预缓冲续播集 |
| 播放 · 电脑 | 左边视频、右边选集栏，可宽屏、全屏；悬停弹出清晰度、倍速、音量；支持空格、Enter、方向键、M 等快捷键 |
| 播放 · 手机 | 竖屏短剧沉浸式，上下翻页切集，左右滑快进快退，长按画面打开「播放设置」，长按左侧 2 倍速，可锁定。横屏视频竖拿时视频在上、简介 / 选集在下，转横屏自动全屏；全屏双击两侧快退 / 快进，左半屏上下滑调亮度，右半屏调音量 |
| 播放 · 平板 | 横着拿同电脑，竖着拿同手机，全屏期间锁定横屏 |
| 播放 · 电视 | 播控浮在画面上，隐藏时左右键快退 / 快进 10 秒；返回键依次关闭选项、收起播控、退出；换集回详情页选 |
| 播放通用 | 下一集提前缓冲，翻页和连播直接接上；倍速、清晰度和弹幕开关会记住。红果在线播放有弹幕，本地播放不加载 |
| 追剧 | 只分追 / 不追。有新集的剧排在「有更新」并标出更新集数；可搜索、按站源筛选、多选取消。后台每 30 分钟检查一批未完结的追剧 |
| 观看记录 | 按今天 / 昨天 / 更早分段；可搜索、按站源筛选、多选删除，「清空」只清当前列出的记录 |
| 我的 | 用户卡、最近观看、下载概况和设置入口；底栏 / 侧栏图标显示正在下载的集数 |
| 下载 | 详情页「下载选集」或播放页选集栏多选（点选、拖选、全选）。下载页分「下载中」「已下载」，可单集或全部暂停 / 继续 / 重试；已下载按剧显示，可播放、删除、补齐缺集。电视端不提供下载 |
| 设置 | 外观、播放、下载、站源、代理、用户、关于、诊断 8 组，改动立即保存；没有权限的项置灰并注明原因 |
| 用户 | 多用户独立保存追剧、记录和搜索，轻点即切换；管理员可添加、编辑、删除用户，设置能访问的站源和是否允许下载 |
| 备份 | 导出 / 恢复用户、追剧、观看记录和偏好设置（含主题色），已下载视频不受影响；旧版备份仍可导入。本地配置损坏时启动页可从备份恢复 |

每集下载完自动转成普通 mp4（红果先解密，m3u8 合成一个文件），保存为「下载目录 / 剧名 / 第 N 集.mp4」，可以直接拷出使用。旧版下载的分集保持原样，旧版合并出的文件不再列出。

画中画、画质增强、排序与筛选、剧集长按菜单、红果多季切换暂不提供。

## 站源

| 站源 | 内容 | 搜索 |
| --- | --- | --- |
| 红果 | 短剧、漫剧、AI 剧；推荐、榜单、题材 | 在线搜索，带输入联想 |
| 韩小圈 | 韩剧、韩国电影、综艺、动漫，多线路 | 在线搜索 |
| 鬼片 | 鬼片、电视剧、动漫，多线路 | 匹配站点 RSS 最新条目 |
| 青空 | 番剧、剧场动画、特摄 | 在线搜索 |
| 黄豆 | 精选短剧、榜单 | 只搜本机缓存 |
| 剧果 | 分类短剧 | 在线搜索 |
| 野果 | 分类短剧 | 在线搜索 |
| 帝果 | 分类视频 | 在线搜索 |
| 黄果视频 / 黄果 AI / 黄果旧版 | 列表、分类及分集 | 只搜本机缓存 |

站源可用性、清晰度和区域限制取决于源站及网络；应用不解除源站 VIP 或其他授权限制。

## 安装

在 [Releases](../../releases) 下载对应平台的包，文件名以 `hongguojian-` 开头的是红果鉴，`zhenguojian-` 开头的是真果鉴。

| 平台 | 安装包                                                                                    |
| --- |----------------------------------------------------------------------------------------|
| Android 7.0+ | arm64-v8a / armeabi-v7a / x86_64 三种 APK，按设备架构选择（大多数手机选 arm64-v8a）；同一签名可覆盖升级，旧证书版本需卸载重装 |
| Windows 10/11 x64 | 完整 ZIP，解压后运行 `hongguojian.exe` / `zhenguojian.exe`，保留所有 DLL 与 `data` 目录                |
| iOS 15.1+ | 未签名 IPA，需自行签名或用 iloader 等工具侧载                                                          |
| macOS 12+ | 通用 dmg（Apple 芯片与 Intel），打开后拖入「应用程序」；未经公证，首次打开前执行 `xattr -dr com.apple.quarantine /Applications/红果鉴.app`（真果鉴为 `真果鉴.app`） |

安装提示 `INSTALL_FAILED_NO_MATCHING_ABIS` 表示 APK 与设备架构不匹配，请换对应架构的安装包。

## 检查更新与使用统计

应用启动时会检查一次新版本，有新版时每次启动都会提示，可在提示里选择忽略此版本或不再提醒。检查更新只读取最新版本号，不发送任何数据。

匿名使用统计是单独的请求，只发送：首次统计时生成的随机编号（与设备、账号无关）、应用版本号、平台（Android / iOS / Windows / macOS）、红果鉴或真果鉴。不发送观看记录、追剧、搜索、站源设置或其他任何个人数据。接收端代码见 [`worker/`](worker)。

两项都可以在 **设置 › 关于** 分别关闭，关闭后应用不会再发出对应的请求。

## 免责声明

- 本项目仅供个人学习与技术研究。
- 本项目与红果短剧及其他各站源的运营方无任何关联，未获得其授权或认可；文中提到的名称和商标归各自权利人所有。
- 应用本身不存储、不上传、不分发任何影视内容，所有内容均来自第三方站点，版权归原权利人所有；应用不解除源站 VIP 或其他授权限制。
- 使用者应遵守所在地法律法规及各站点的服务条款，因使用本项目产生的一切后果由使用者自行承担。
- 本项目按「现状」提供，不对可用性、稳定性或适用性作任何保证，作者不承担由此造成的任何直接或间接损失。
- 如认为本项目侵犯了你的合法权益，请通过 Issue 联系，核实后会及时处理。

## 许可

本项目以 [GNU GPL v3.0](https://www.gnu.org/licenses/gpl-3.0.html) 发布，全文见 [LICENSE](LICENSE)。第三方依赖遵循各自的许可证。

## 开发

构建、测试、架构和发布流程见 [DEVELOPMENT.md](DEVELOPMENT.md)，版本更新记录见 [CHANGELOG.md](CHANGELOG.md)。