zerozhh

hongguo-mac

A community-built macOS adaptation of the Hongguo short-drama app: native SwiftUI windows over a local backend rather than a web wrapper, with category discovery, episode autoplay, speed and resume playback, next-episode preload, local no-login favorites and history, and one-script installation

v1.0.5
Published at
1d ago
18
Stars
305
Download
Synced at
1d ago

Latest release

v1.0.5Oct 27, 2026, 08:09 AM
Downloads slow? Switch the source anytime above

README

Project Overview

Hongguo short dramas officially exist only on phones and Windows, leaving Mac users as second-class citizens. This self-built adaptation brings the whole experience to macOS: not a web wrapper but a complete SwiftUI native window over a local backend, covering discovery, search, episode autoplay, speed and resume playback, and local favorites and history.

Swipe through short dramas natively on your Mac.

Key Features

  • Native window experience: SwiftUI windows and a Dock icon with WKWebView rendering, not a simple web wrapper
  • Category discovery: filters, hot rankings and live-action / comic / AI drama browsing, with search
  • Full playback: episode picking, speed control, auto-play and resume, plus next-episode preload for zero-wait switching
  • Local favorites and history: saved on-device without login, tied to no account
  • Local decrypted streaming: videos decrypt on your machine into standard mp4 with Range seeking
  • One-script install: setup_mac.command assembles the backend, JRE and dependencies automatically, no Homebrew or developer tools needed
  • Clean shutdown: closing the app tears down the local backend services, leaving no background processes

Target Audience

  • Mac users who binge short dramas
  • Hongguo users on the desktop
  • Desktop viewers unwilling to run Android emulators
  • Beginners wanting a zero-tooling install

Quick Start

  1. Download setup_mac.command from Releases
  2. Right-click and choose Open to pass the first-run security check, then wait a few minutes
  3. The app launches automatically when installation finishes

Core Advantages

  • Fills the Mac gap: a platform the official apps ignore, covered by the community
  • Tool-free install: one script assembles runtime, backend and interface
  • On-par experience: autoplay, resume and preload details match the official mobile and Windows editions

System Requirements

Item Requirement
Operating system macOS 13 or later
Chip Apple Silicon or Intel
Extra tooling No Homebrew or developer tools required

Notes

  • A personal third-party adaptation unrelated to ByteDance / official Hongguo; for personal study only, no commercial use or redistribution
  • APIs are unofficial calls and may be rate-limited or fail anytime; restart the app or wait for recovery
  • Favorites and history stay on your machine and never sync to phones or accounts

Release history

Sort