hongguo-macos-port

Project Overview

This is the macOS (Apple Silicon) port of the Hongguo short-drama Flutter client. The upstream repository has no LICENSE file, so by default copyright rules forbid redistributing its source; this repository therefore publishes only the author's own porting work: macOS platform project configuration, change patches, build and signing scripts, porting docs, and a ready-built arm64 package.

The patches fix three playback issues found in testing: progressive MP4 mis-parsed as HLS causing playback failures, process crashes from concurrent mpv property access, and duplicated taps overwriting each other during loading; LAN watch-sync and window management are also wired up.

Item	Value
Platform	macOS (Apple Silicon)
Upstream baseline	guoapp 0.2.64+71
Verified on	macOS 27, Apple M6, Flutter 3.47.6, Go 1.24.6
Repository type	Port project and installer, no upstream app source

Until the upstream grants a license, this repo brings Hongguo to the Mac legally with patches and scripts instead of copied source.

Key Features

• Native macOS port: complete macOS platform project with a default 1180×760 window and minimum size limits
• Playback fixes: corrected MP4 stream passthrough, player idle waiting and duplicate-tap handling
• LAN sync: cross-device watch progress sync via a Bonjour service
• Fullscreen: player fullscreen extended to macOS with hardware acceleration off to avoid rendering crashes
• Build scripts: one-command build of the Go native core libduanju_core.dylib injected into the app bundle
• Installer distribution: Releases provide a ready-built arm64 app zip

Target Audience

• Users who want Hongguo short dramas on Apple Silicon Macs
• Developers with Flutter and Go toolchains who build it themselves
• Engineers studying cross-platform Flutter porting

Quick Start

1. Download duanjuapp-macos-arm64-v0.2.64.zip from Releases and unzip
2. Drag the app into Applications and run it
3. To build yourself: clone upstream zhoufuweigg/guoapp at the pinned baseline commit
4. Apply the patches/ from this repo and drop in the macos-platform/ project
5. Build with Flutter 3.47.6, compiling the native core first via scripts/build_native.py --platform darwin

Core Advantages

• Legally clean: no upstream source copied or redistributed, only original porting work published
• Ready to run: Releases ship a ready arm64 app, unzip and go
• Tested fixes: three playback crash and hang issues located on real hardware and fixed
• Thorough docs: porting steps, pitfalls and verified environments all public

System Requirements

Item	Requirement
OS	macOS (Apple Silicon)
Hardware	Apple M-series chip
Build tools	Xcode 27, Flutter 3.47.6 stable, Go 1.24+, CocoaPods 1.16+

Notes

• No app source: the repo only provides the installer and porting project files, not the application source code
• Upstream may vanish: the upstream author says it may be deleted anytime, back it up early
• Do not redistribute upstream source: until the upstream adds a clear license, do not redistribute its code