guoapp

Project Overview

Zhenguojian is a Flutter-based multi-platform short-drama app, formerly named "Short Drama Library". It aggregates content from multiple short-drama sites into one app, with browsing, search, follow lists, downloads, and playback all performed on the device itself, without relying on a legacy project or self-hosted service. The source builds in two forms: the default build contains only the Hongguo source ("Guojian"), while --all-sources produces the full-source build ("Zhenguojian"). It covers Android phones, Android TV, Windows, and iOS.

A dozen short-drama sites in one app, with follow lists, downloads, and danmaku all in one place.

Key Features

• Multi-source aggregation: the full-source build browses Hongguo, Huangdou, Juguo, Yeguo, Diguo, and a dozen more sources
• Browsing and rankings: category switching, sorting and filters, ranking entries, and auto-loading on scroll
• Search and recommendations: online per-source search, Hongguo suggestion terms, recent searches, and a recommendation feed in the Hongguo category
• Follow lists and history: filter by want-to-watch, watching, watched, and updated, saved per user with automatic progress tracking
• Batch downloads: multi-select dramas, pick episodes and quality, and pause, resume, retry, or clean up tasks
• Playback: a built-in player with picture-in-picture, speed control, quality switching, next-episode preloading, and danmaku
• Appearance and backup: light, dark, and system-following themes, with configurable backup and migration
• Multi-device layouts: dedicated layouts and remote-control handling for portrait phones, landscape, and TV

Target Audience

• Everyday viewers who enjoy short dramas
• Users who want to watch on a TV screen
• Users who want to manage several short-drama sites in one place

Quick Start

1. Download the package for your platform from Releases; on Android install the APK directly
2. Open the app and pick a source and category on the home page to browse or search for a drama
3. Tap a drama to start playback; swipe up or down to change episodes
4. Add a drama to your follow list on the detail page for easy resuming
5. For offline viewing, open the download tab, pick episodes and quality, and add them to the queue

Core Advantages

• One-stop aggregation: no switching between several short-drama apps
• On-device processing: requests, parsing, downloads, and playback all happen locally with no remote relay
• Choose your build: compile a slim Hongguo-only version or the full-source version
• Multi-platform: phone, TV, and desktop each have a matching layout and controls

System Requirements

Item	Requirement
OS	Android, Android TV, Windows, iOS
Architecture	Android packages for arm64-v8a, armeabi-v7a, and x86_64
Network	Internet access to the selected sources

Notes

• Source availability, quality, and regional limits depend on the sources and your network; the app does not lift VIP or other authorization limits
• Some sources in the full-source build are still being verified and may not stream at times
• Sources are determined at build time; you cannot switch builds inside the app