zhenguojian

Project Overview

Zhenguojian is a Flutter-based Android short-drama app built from the open-source project Topkill/guoapp3, following the original project's license. It publishes packages rebuilt for arm64-v8a devices such as the XGIMI Z8X, and also provides the business source code for review and self-building. The app is built with all sources enabled, integrating sources such as Hongguo, Huangdou, Huangju, Huangguo Video, Huangguo AI and legacy Huangguo. The latest source version is 0.4.0, which removed the danmaku feature on request.

An all-sources build of an open-source drama project, usable as a package and shipped with business source code.

Key Features

• Multi-source integration: an all-sources build supporting Hongguo, Huangdou, Huangju, Huangguo Video and more
• Browsing and search: category catalogs and online search to find dramas quickly
• Online playback: quality switching, speed control, episode switching and auto-play
• Download and offline: per-episode download, resume and offline playback
• Following and history: following, watch history and resume playback
• Local multi-user: local multi-user with an admin password and per-user record isolation
• Open source: the repo provides the business source code for self-building
• Overwrite install: a fixed package name allows overwriting an older version without uninstalling

Target Audience

• Users of arm64-v8a Android devices
• Users who want to watch short dramas on a projector
• Users who need an all-sources short-drama app
• Developers who want to build it themselves

Quick Start

1. Go to Releases and download the latest Zhenguojian APK
2. Install it on an arm64-v8a device running Android 8.0 or later
3. Open the app and find a drama via the home categories or search, then play it
4. For offline viewing, add episodes to the download queue from the detail page
5. To build it yourself, first compile the native core with the Go toolchain to produce the dynamic library, then run the build script

Core Advantages

• All sources: one build integrates multiple drama sources, giving richer availability
• Ready to install: a prebuilt APK that can be upgraded by overwriting
• Inspectable source: the repo also ships the business source code for learning and self-building
• Older-device friendly: focused on arm64-v8a and adapted for devices like the XGIMI Z8X

System Requirements

Item	Requirement
OS	Android 8.0 (API 26) or later
Architecture	arm64-v8a
Package name	com.duanju.duanju_app
Build dependency	Self-building requires compiling the native core with the Go toolchain

Notes

• Architecture limited: the current package only ships for arm64-v8a; other architectures cannot install it
• Source needs native libs: the repo holds business source without prebuilt native libraries, so a clone must compile the native dynamic library before it can build
• Build path: build commands must run under a purely English path, as Chinese paths cause failures
• Danmaku removed: from 0.4.0 danmaku is removed, so the player no longer has danmaku entry points
• Source limits: source availability depends on the source sites and network; the app does not bypass authorization limits