fqapp README

The project's README from github.com/ch6vip/fqapp. As one markdown file: README.md.

fqapp Logo

fqapp

内容聚合客户端
小说 · 短剧 · 漫剧 · 漫画 · 听书,签名 / 解密 / 缓存全部在手机本地完成

功能一览 · 下载与安装 · 快速上手 · 常见问题 · 支持作者 · 开发者文档

Release   Downloads   Platform   License   Stars

下载 APK

⚠️ 免责声明:本项目仅供学习与研究交流,不内置、不分发任何内容资源;在线内容均来自第三方公开接口,版权归原权利方所有。本项目与内容提供方无关联,未获其授权;使用产生的一切后果由使用者自行承担,如有侵权请联系删除。


📖 功能一览

功能 说明
📖 小说阅读 图文正文与插图、左右分页或上下滚动、排版与字体导入、亮度调节、段评、离线缓存
🎬 短剧 / 漫剧 自动连播、倍速、上下集与快进快退、全屏方向自适应、进度续看
🖼 漫画 竖向连续阅读、章节目录、单图重试、点击放大、阅读位置恢复
🎧 听书 智能朗读与真人讲书、边听边读字幕、关联作品、定时关闭、倍速、自动下一章、进度续听
🗣 系统朗读 小说与本地 TXT/EPUB 正文朗读、已安装 TTS 引擎选择(如 MultiTTS)、语速设置、从本段听、自动下一章
🔍 搜索与发现 关键词 / 作品 ID 搜索、搜索联想词与热搜、排行榜、作者主页、书评
📋 详情 封面、分类、完结状态、字数、评分、标签、简介、目录预览、书评、关联作品
🕘 历史与书架 阅读/播放进度自动记录,续读续看;离线缓存管理
⬇️ 下载 整本缓存、批量缓存后续章节,下载内容不受自动清理影响

⬇️ 下载与安装

设备要求

获取安装包

推荐:GitHub Releases —— 下载最新发布版的 fqapp-<版本>-arm64.apk,同一发布页附 SHA256SUMS 与 verify-report.json(签名、16 KiB 对齐等 8 项校验的原始报告),可自行核对。

其他方式:

  1. GitHub Actions 云端构建:打开仓库的 Actions → Android APK,点击 Run workflow 运行一次构建;成功后在本次运行的 Artifacts 中下载 fqapp-arm64-运行编号,解压得到 app-release.apk(同样附带校验报告;产物仅保留 14 天,需要长期留存请用 Releases)。
  2. 本地构建:需要 Flutter / Rust / Android NDK 工具链,步骤见 DEVELOPMENT.md。

在 fork 中构建:正式签名的密钥只对上游仓库可用,fork 出来的构建拿不到它。此时工作流 会自动改为产出未签名包并在日志里给出警告,其余校验(16 KiB 对齐、原生库完整性)照常 执行。未签名包只能全新安装,无法覆盖安装到正式签名版本之上,也不能作为正式发布包。

安装与首次启动

  1. 安装 APK(直接点击安装,或 adb install fqapp-<版本>-arm64.apk)。
  2. 首次启动时 App 自动完成初始化:部署运行资源 → 启动本地核心并注册设备 → 健康检查通过后进入主界面。首次请保持联网。
  3. 之后即可随时离线打开 App,阅读已缓存的内容。

⚠️ 签名与升级:正式签名与调试签名的包不能互相覆盖安装。Releases 与 Actions 产出的 release 包使用正式签名;从旧签名版本(v1.0.17 及更早)升级需要先卸载再安装,卸载会同时清除阅读历史与缓存。同签名版本可直接覆盖升级。

🚀 快速上手

找内容

读小说

看短剧 / 漫剧

听书

看漫画

缓存与离线

❓ 常见问题

Q:启动时一直停在初始化 / 健康检查失败? 首次启动需要联网完成设备注册,请检查网络后重试;运行状态可在「我的 → 服务状态」查看。

Q:正文显示乱码 / 视频解密失败? 多为设备注册过期:清除应用数据后重新打开,App 会自动重新注册设备(注意:清除应用数据会同时清除阅读历史与缓存)。

Q:搜索、详情或播放突然失败? 内容全部来自上游接口,上游调整或网络波动都会临时影响,可稍后重试。本项目没有自己的服务器,无法绕过上游的临时变更。

Q:下载的内容保存在哪? 保存在应用私有目录,不进入相册等公共空间;在应用内「设置 → 数据 → 章节缓存」管理。

Q:换手机怎样迁移收藏和进度? 先退出阅读或暂停播放,在「设置 → 数据 → 备份与恢复」导出 JSON 文件,传到新手机后在同一页面选择文件,核对预览并确认合并。支持在线作品的收藏、阅读/播放进度和已看剧集;已有收藏和进度保留本机记录,已看剧集取并集,可重复导入。文件不包含本地 TXT/EPUB 书籍及其进度、下载缓存、阅读时长、划线和应用设置;本地书籍请另行保留原文件。暂不提供 WebDAV 同步。

请保留原备份文件。导入过程不清理历史,但应用后续日常保存仍沿用原规则:历史超过 100 条时,保留最近约 50 条;收藏不受此历史清理影响。

Q:需要登录或付费吗? 不需要。App 没有登录、支付等任何账号功能。

Q:有 iOS 版吗? 没有。当前仅支持 Android(arm64)。

💖 支持作者

如果这个项目对你有帮助,欢迎在爱发电支持我;也欢迎给项目点一个 ⭐ Star。

Afdian

微信赞助:

微信赞助

应用内的同一入口在「设置 → 关于 → 支持作者」。

🙏 致谢

Thanks to the LINUX DO community for its support and feedback.

感谢 LINUX DO 社区的支持与反馈。

📄 许可与免责声明

本项目代码以 GPL-3.0 协议开源,Copyright (C) 2026 ch6vip。

本项目仅供学习与研究交流,不内置、不分发任何内容资源;在线内容均来自第三方公开接口,版权归原权利方所有。本项目与内容提供方无关联,未获其授权;使用产生的一切后果由使用者自行承担,如有侵权请联系删除。请遵守相关法律法规,仅限个人学习研究使用。

⭐ Star History

Star History Chart

开发者

架构、构建、API 对接、调试与开发计划等开发向文档见 DEVELOPMENT.md;构建与维护脚本说明见 scripts/README.md。

fqapp (ch6vip/fqapp)

Searching Database…

527 ·GitHub
What is this?fqapp is an Android app that aggregates online novels, short dramas, audio dramas, audiobooks, and manga into one reader/player, with all signing, decryption, and caching done locally on the phone rather than on a self-hosted server.
Is this an app I install, or does it need a server?It is a single installable APK — the UI is built with Flutter and a Rust core runs in-process on the device itself, so there is no server to deploy or maintain.
Do I need root or an account to use it?No root is required, and the app has no login or payment system at all — everything works anonymously out of the box.
Is there an iOS version?No — the project currently only supports Android on arm64-v8a devices running Android 7.0 (API 24) or newer.
Can I use it without internet?The first launch needs network access to register the device and run a health check; after that, you can reopen the app offline and read or play anything you've already cached.
Where does my data and the content go?Content is streamed live from third-party public interfaces rather than bundled in the app, and all signing/decryption/caching happens locally on the device in a private app folder, not on any server the developer runs.
What content types can I read or watch?Novels (with custom fonts and themes), short dramas and video comics with auto-play, vertically-scrolling manga, and audiobooks with both AI text-to-speech and human narration plus synced subtitles.
How do I move my library to a new phone?Export a JSON backup from Settings → Data → Backup & Restore, then import it on the new phone; it carries over favorites and reading/watch progress but not local TXT/EPUB files or download caches, and there's no WebDAV sync yet.
What happens if I see garbled text or playback decryption errors?This usually means the device registration expired; clearing the app's data forces it to re-register, though that also wipes your reading history and cache.
Creator
ch6vip
Size
12.5 MB
Stars
527
Age
1mo
Commits · 90 Days