# HGhubX (zxsos/HGhubX)

> An unofficial third-party client for the YellowFruit platform, with immersive vertical-screen playback. It does not host, store or distribute any audio or video. All content comes from third-party sites.

- GitHub: https://github.com/zxsos/HGhubX
- GitHub.Locker page: https://github.locker/zxsos/HGhubX
- Stars: 4.7K
- Language: TypeScript
- Last push: 2026-11-17

## Questions and answers

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

**Is it an app or a library?**

It's an end-user app, not a library. It's built with Rust and Tauri 2 and uses a Fluent-style design.

**How do I get it running?**

The README has no build steps. It points to the official Release package and says to uninstall any copy that asks for a card key or VIP payment.

**What should I watch out for?**

Don't batch-download or scrape, don't publish endpoints or playback links, and don't commercialize it. Metadata marks this repo as a fork, so check it against the official release before installing.

**Which platforms does it run on?**

Windows, macOS, Linux, Android and iOS.

**Are there built-in caches I should keep?**

Yes, the built-in cover and playlist caches. The README asks users not to shrink or disable them, to avoid putting extra load on upstream sites.

**What should I do if I'm a rights holder?**

Open a GitHub Issue. The author says they will verify the claim and cooperate, which can mean removing content, pausing features, archiving the repo or changing its visibility.

**Does it work on every major device?**

Yes, the README lists Windows, macOS, Linux, Android and iOS, all built with Rust and Tauri 2 and a Fluent-style design.


---

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

Source: https://github.com/zxsos/HGhubX/blob/main/README.md

> ### ⚠️ 中国大陆下载与传播限制
>
> **禁止在中国大陆地区下载、复制、分享、传播本软件及通过本软件获取的相关资源；不得提供相关下载链接或传播服务。**
>
> 本条亦适用于相关安装包、更新包、镜像与转发。若不符合本条要求，请停止获取、传播本应用并退出。

<div align="center">

<img src="hghubx.svg" alt="HGhubX" width="128" height="128" />

# HGhubX

**第三方客户端 · Rust + Tauri 2**

Windows / macOS / Linux / Android / iOS · iOS 圆角与玻璃材质 · 沉浸式竖屏播放

</div>

> ⚠️ 免责声明：本项目仅供 **学习与技术交流**，不提供、不存储、不分发任何音视频内容，与任何内容提供方无关联。
> 所有内容均来自第三方站点，版权归原作者与上游站点所有；使用者应自行遵守所在地法律法规，因使用产生的任何后果由使用者自行承担。

> 如您是版权方、上游站点、平台或有关机构，认为本仓库或官方发布渠道的内容涉及您的权益，请通过 GitHub Issues 联系；我会尽快核实并配合处理，包括修改或移除内容、暂停功能、停止维护、归档或调整仓库可见性。

**使用须知**

- **以访客身份正常使用**：像普通访客一样浏览就好，请勿滥用本项目。
- **不要给上游增加压力**：本项目本身不提供下载功能，请勿改动代码去做批量下载 / 批量抓取，也不要高频轮询、并发轰炸接口或挂机刷播放量；内置的封面与播放列表缓存请不要改小或关掉。
- **尊重上游版权**：不要去除水印与站点标识，不要把剧集搬运、转码、修改后二次分发到别处（网盘、资源站、其他 App 等），更不能改完拿出去出售。
- **不要公开传播接口与直链**：接口地址、播放直链、解密方式请勿公开张贴或打包成「资源站」——上游一旦封禁，所有人都没法再用。
- **不要商业化**：禁止打包出售、接入广告 / 会员 / 付费点播，或作为收费服务的一部分分发（详见 [LICENSE](LICENSE)）。
- **合理使用**：仅供个人学习、研究与自用；请在 24 小时内删除相关资源，并支持正版。
- **遵守当地法律**：使用者应自行判断并承担合规责任。

> ⚖️ 许可证自 v1.1.0 版本起改为 **PolyForm Noncommercial 1.0.0**：**禁止任何商业用途**——
> 包括打包出售、接入付费/会员/广告变现、作为收费产品或服务的一部分分发。
> 个人学习、研究、自用与非营利使用不受限制，详见 [LICENSE](LICENSE)。

## 仿冒提醒

> 🚫 **已发现的恶意修改版**：[`hichuv` 仓库](https://github.com/hichuv)
>
> 该仓库与本项目无关，是在旧版本源码基础上擅自加入**卡密验证、VIP 付费解锁**等变现功能的修改版，
> 代码改动不透明、安全性无法验证。**请勿下载、勿注册、勿付费**；如已安装，建议立即卸载，改用官方 Release 包安装。
>
> 本项目**从未、也不会**加入任何卡密 / VIP / 付费解锁 / 广告功能。如果你遇到的「HGhubX」要求输入卡密或付费开通，那一定不是官方版本。

## 免责声明

- 本项目与内容提供方无任何关联，作者不参与内容的制作、上传与分发。
- 本项目仅在上述官方渠道发布；任何第三方修改版（尤其是加卡密、VIP 变现的版本）均与作者无关，请自行甄别。
- 使用者应自行遵守所在地法律法规；因使用本项目产生的任何后果由使用者自行承担。
- 若相关权利方认为本项目存在侵权，请通过 Issue 联系，我们会及时处理。

## 升级兼容

- 本地收藏、观看记录、偏好、切集迁移标记和主题使用 `hghubx_*` 存储键。首次启动时，当前 WebView 存储中的旧 `hghub_*` 数据会迁移到新键；已有新数据优先，确认写入成功后才清理对应旧键。写入失败时保留并读取旧数据，下次启动重试。此迁移针对同一存储空间，不会跨应用标识或跨浏览器配置目录读取其他安装的数据。
- 环境变量统一使用 `HGHUBX_PROXY`、`HGHUBX_STRICT`、`HGHUBX_TEST_COVER_URL`、`HGHUBX_TEST_MEDIA_URL` 和 `HGHUBX_TEST_MEDIA_OUTPUT`。旧 `HGHUB_*` 名称继续兼容；新变量未设置时才回退旧变量，显式设置的新值（包括空值）优先。安全模式的命令行参数仍优先于环境变量。
- 网络诊断中的显式代理字段统一为 `HGHUBX_PROXY`，展示兼容读取后的有效值并保持脱敏。

## 工程入口

开发者和 coding agent 先读 [`AGENTS.md`](AGENTS.md)，再按
[`docs/subsystems/`](docs/subsystems/README.md) 找到要修改的子系统；当前行为、验证命令和变更
协议都以这两处为准。`make check` 是本地统一入口，GitHub Actions 是合并门禁和验证记录。

项目目录与依赖关系见 [`docs/architecture.md`](docs/architecture.md)：

| 目录 | 内容 |
| --- | --- |
| `src/app/` | 应用装配、页面栈、窗口壳与启动门 |
| `src/features/` | 首页与 Feed、播放、账号、分类、发现、图文、搜索、设置 |
| `src/tv/` | 独立 Android TV 版界面、遥控器焦点与本地搜索片库 |
| `src/shared/` | IPC、共享状态、存储、自动选线、诊断与跨功能 UI |
| `src/styles/`、`src/index.css` | 统一样式入口与样式文件 |
| `src-tauri/src/` | Rust 的 API、网络、媒体、线路与平台实现 |

## License

[PolyForm Noncommercial License 1.0.0](LICENSE) —— **仅限非商业用途**。

- **允许**：个人学习、研究、自用、爱好项目，以及在非营利组织内部使用；可以自由修改、二次开发。
- **禁止**：任何商业用途。包括但不限于打包出售、接入付费/会员/广告变现、作为收费服务或商业产品的一部分分发。
- **保留声明**：分发本项目或其修改版时，必须附带本许可证全文（或上面的链接）以及 `Required Notice` 声明行。

