本项目改编自 fish2018 的源码。安装包内置红果站源,其余站源以模块形式在 我的 › 模块 安装,操作见 使用说明。
[!WARNING]
项目处于开发阶段,不对用户数据做担保,数据可能在版本更新时丢失。
功能
界面与外观
- 导航:发现 / 追剧 / 我的。手机用底栏,平板和电脑用侧栏(可收起),电视用顶部 Tab;宽屏的子页面在侧栏右侧打开。
- 界面模式:自动识别、电视、手机、平板、窗口(只有电脑提供);手动选定后不随窗口宽度切换。电视模式强制横屏,手机模式锁定竖屏。
- 主题:跟随系统取色(Android 12+ 跟随壁纸,Windows 和 macOS 跟随强调色)或 6 个预设色板;浅色 / 深色 / 跟随系统。
浏览
- 发现:站源名旁切换站源;分类 Tab 依次为推荐 / 全部 / 各榜单 / 各题材,榜单封面标出名次。第一个 Tab 顶部大卡片显示最近看过或推荐的剧。滑到底自动加载,下拉或「刷新」重新拉取当前分类。
- 搜索:只搜当前站源,保留最近搜索;红果有输入联想。
- 详情:封面模糊作底,显示集数、完结状态、分类、播放量、标签和简介;选集每组 30 集,落在续播那一集,看过的集变浅,VIP 集有标记。打开时后台预缓冲续播集。
播放
| 设备 |
体验 |
| 电脑 |
左边视频、右边选集栏,可宽屏、全屏;悬停弹出清晰度、倍速、音量;支持空格、Enter、方向键、Page Up / Page Down、M 等快捷键 |
| 手机 |
竖屏短剧沉浸式,上下翻页切集,左右滑快进快退,长按画面打开「播放设置」,长按左右两侧倍速播放(默认 2 倍,可在设置里改),可锁定。横屏视频竖拿时视频在上、简介 / 选集在下,转横屏自动全屏;全屏双击两侧快退 / 快进,左半屏上下滑调亮度,右半屏调音量 |
| 平板 |
横着拿同电脑,竖着拿同手机,全屏期间锁定横屏 |
| 电视 |
播控浮在画面上,隐藏时左右键快退 / 快进 10 秒;返回键依次关闭选项、收起播控、退出;换集回详情页选 |
所有设备通用:下一集提前缓冲,翻页和连播直接接上;倍速、清晰度和弹幕开关会记住。红果在线播放有弹幕,本地播放不加载。
追剧与记录
- 追剧:只分追 / 不追。有新集的剧排在「有更新」并标出更新集数;可搜索、按站源筛选、多选取消。后台每 30 分钟检查一批未完结的追剧。
- 观看记录:按今天 / 昨天 / 更早分段;可搜索、按站源筛选、多选删除,「清空」只清当前列出的记录。
- 我的:用户卡、最近观看、下载概况和设置入口;底栏 / 侧栏图标显示正在下载的集数。
下载
- 详情页「下载选集」或播放页选集栏多选(点选、拖选、全选)。
- 下载页分「下载中」「已下载」,可单集或全部暂停 / 继续 / 重试;已下载按剧显示,可播放、删除、补齐缺集。
- 每集下载完自动转成普通 mp4(红果先解密,m3u8 合成一个文件),保存为
下载目录/剧名/第 N 集.mp4,可以直接拷出使用。
- 旧版下载的分集保持原样,旧版合并出的文件不再列出。电视端不提供下载。
设置、用户与备份
- 设置:外观、播放、弹幕、下载、存储、代理、用户、关于、诊断 9 组,改动立即保存;没有权限的项置灰并注明原因。
- 用户:多用户独立保存追剧、记录和搜索,轻点即切换;管理员可添加、编辑、删除用户,设置能访问的站源和是否允许下载。
- 备份:导出 / 恢复用户、追剧、观看记录和偏好设置(含主题色),已下载视频不受影响;旧版备份仍可导入。本地配置损坏时启动页可从备份恢复。
安装
在 Releases 下载对应平台的包,文件名以 guoapp- 开头。
| 平台 |
安装包 |
| Android 7.0+ |
arm64-v8a / armeabi-v7a / x86_64 三种 APK,按设备架构选择(大多数手机选 arm64-v8a);同一签名可覆盖升级,旧证书版本需卸载重装 |
| Windows 10/11 x64 |
安装包 *-setup.exe,默认安装到当前用户、无需管理员权限;或便携 ZIP,解压后运行 guoapp.exe,保留所有 DLL 与 data 目录;便携版的设置、记录、缓存和默认下载都存在程序旁的 userdata 目录,删掉该目录则改回存到系统用户目录 |
| iOS 15.1+ |
未签名 IPA,需自行签名或用 iloader 等工具侧载 |
| macOS 12+ |
通用 dmg(Apple 芯片与 Intel),打开后拖入「应用程序」;未经公证,首次打开前需解除隔离(见下方) |
[!TIP]
Android 安装提示 INSTALL_FAILED_NO_MATCHING_ABIS 表示 APK 与设备架构不匹配,请换对应架构的安装包。
[!IMPORTANT]
macOS 首次打开前在终端执行:
xattr -dr com.apple.quarantine /Applications/小果影视.app
使用说明
首次打开
- 逐条勾选使用条款,15 秒后可以继续。
- 默认只有一个「管理员」用户,拥有全部权限,不设密码。
- 红果随安装包内置并自动安装,打开 发现 就能看;其他站源需要先安装模块。
站源模块
站源是应用访问某个网站的适配代码,打包成模块(.zip)单独安装、更新和卸载,应用本体不再自带站源。新增或修复站源只需更新模块,不用等应用发版。
在 我的 › 模块 管理(只有管理员能看到这个入口,发现页切换站源的面板里也有「管理站源」):
| 标签页 |
用途 |
| 已安装 |
开关、更新、卸载站源,点卡片查看站源会访问的域名;青空在卡片上登录账号 |
| 在线仓库 |
模块商店,逐个「安装」或「安装全部站源」,标「限制级」的是成人内容 |
| 内置 |
随安装包附带的模块(目前是红果) |
| 手动 |
「选择本地文件」安装 .zip 模块,或「输入下载地址」填模块 zip 的链接 |
- 只能安装模块,不能直接填网站网址;没有对应模块的网站无法添加。想要新站源可以开 Issue 建议,或按 CONTRIBUTING.md 自己编写社区模块。
- 模块文件由应用自己保存在数据目录的
modules 文件夹(Windows 为 %APPDATA%\<包名>\modules,便携版为程序旁的 userdata\modules),不需要手动放文件。
- 卸载站源会保留它的追剧、观看记录和下载,重新安装后恢复显示。
- 手动安装的模块未经仓库收录,只装可信来源的。
浏览与搜索
- 点发现页顶部的站源名切换站源,切换后分类和搜索都针对当前站源。
- 分类较多时点分类栏右侧的「全部分类」按钮选择;各分类的内容和排序由站点决定。
- 不想让别人看到封面:设置 › 外观 打开主页的模糊封面按钮,可设为开屏自动模糊限制级或全部封面。
播放与下载
- 各设备的手势和快捷键见上方 播放;手机长按画面打开「播放设置」,里面有弹幕样式、小窗播放和投屏(iOS 不提供投屏)。
- 倍速、清晰度、解码方式、手势开关在 设置 › 播放,弹幕字号、显示区域、屏蔽词在 设置 › 弹幕。
- 下载目录在 设置 › 存储 修改和迁移;Android 可在已下载的剧里「导出」到
Movies,或在 设置 › 下载 打开下载完成后自动导出。
多用户与权限
- 设置 › 用户 先给管理员设置密码,才能「添加用户」。
- 编辑用户可设置密码、允许访问的站源和是否允许下载;普通用户看不到模块入口,没有权限的设置项置灰。
- 管理员打开「启动时需要登录」后,每次打开应用先选择用户并输入密码;有密码的用户可用「锁定当前用户」回到登录页。
备份与迁移
设置 › 诊断 导出 / 恢复备份,备份包含用户、追剧、观看记录、偏好设置和已安装站源列表,恢复后会询问是否重新安装这些站源;已下载的视频不在备份里,需要单独拷贝下载目录。
常见问题
- 发现页提示「还没有安装站源」:到 我的 › 模块 › 在线仓库 安装;普通用户请让管理员安装并开放站源。
- 某个站源加载失败或很慢:先下拉刷新或在 设置 › 代理 换连接方式(自动 / 直连 / 手动代理,支持 HTTP、HTTPS、SOCKS5),再到 我的 › 模块 看有没有更新。
- 有声音没画面、卡顿:设置 › 播放 › 解码方式 换成兼容方式;Android 仍无画面再打开同组的「兼容渲染模式」。
- 反馈问题:开 Issue 时写明应用版本(设置 › 关于)、平台、站源和操作步骤;播放问题附上 设置 › 诊断 › 播放调试日记 里复制的日志。
检查更新与使用统计
| 请求 |
发送内容 |
| 检查更新 |
不发送任何数据,只读取最新版本号。启动时检查一次,有新版时每次启动都会提示,可选择忽略此版本或不再提醒 |
| 匿名使用统计 |
只发送:首次统计时生成的随机编号(与设备、账号无关)、应用版本号、平台(Android / iOS / Windows / macOS)、构建标识(固定为 guoapp) |
不发送观看记录、追剧、搜索、站源设置或其他任何个人数据,接收端代码见 worker/。两项都可以在 设置 › 关于 分别关闭,关闭后应用不会再发出对应的请求。
免责声明
应用首次打开时会显示以下使用条款,同意后才能使用。
- 本项目是开源软件,框架与模块商店中的站源模块代码公开,仅供个人学习与技术研究,不收费,不提供任何付费服务。
- 本项目与红果短剧及其他各站源的运营方无任何关联,未获得其授权或认可;文中提到的名称和商标归各自权利人所有。
- 应用本身不存储、不上传、不分发任何影视内容,所有内容均来自第三方站点,版权归原权利人所有;应用不解除源站 VIP 或其他授权限制。
- 除内置的红果外,站源以模块形式由使用者自行安装,模块会访问安装时列出的第三方站点;从文件或地址安装的模块未经模块商店收录,请只安装可信来源的模块,由此产生的后果由使用者自行承担。
- 通过本应用观看或下载的内容仅供试看和个人学习交流,请于下载后 24 小时内删除;如喜欢相关作品,请支持正版。
- 不得在任何公开平台(如社交媒体、短视频平台、论坛、公开群组等)宣传、分享本应用及其安装包、下载链接或通过本应用获取的内容。
- 站源内容(包括其中的广告、链接、二维码、联系方式等)均由第三方提供,请自行鉴别真伪,切勿轻信其中的充值、投资、博彩、兼职等信息;由此造成的任何财产损失,作者不承担任何责任。
- 观看记录、追剧和下载等数据只保存在本设备,联网发送的内容见 检查更新与使用统计。
- 使用者应遵守所在地法律法规及各站点的服务条款,不得将本应用用于违法或商业用途;因使用本项目产生的一切后果由使用者自行承担。
- 本项目按「现状」提供,不对可用性、稳定性或适用性作任何保证,作者不承担由此造成的任何直接或间接损失。
- 如不同意以上条款,请立即停止使用并卸载本应用。
- 如认为本项目侵犯了你的合法权益,请通过 Issue 联系,核实后会及时处理。
许可
本项目以 GNU GPL v3.0 发布,全文见 LICENSE。第三方依赖遵循各自的许可证。
开发
构建、测试、架构和发布流程见 DEVELOPMENT.md,参与开发和编写社区站源见 CONTRIBUTING.md,版本更新记录见 CHANGELOG.md。