hongguo-dl

Project Overview

This is a downloader for Hongguo short dramas that can be deployed on a NAS via Docker or installed directly on an Android phone. Paste a share link and it parses the episode list, downloads every episode in batch, decrypts the encrypted video stream automatically, and merges all episodes into a single MP4 file.

Paste one share link to download and merge a whole short drama into a single video file.

Key Features

• Link parsing: paste a share link and the episode list is parsed automatically
• Batch download: pick episodes and download them in batch, with decryption and container rebuilding handled for you
• Automatic merge: all episodes are merged into a single MP4 when the downloads finish
• Missing episode check: detects and reports missing episodes before merging
• Retry on failure: retry failed episodes with one click
• Persistent tasks: task state is saved, so refreshing the page does not lose progress
• Responsive UI: the web interface adapts to both phones and computers
• Access password: set a password so the download service is not used by anyone else
• Android client: download locally on the phone or connect to a remote NAS service

Target Audience

• Users who run download services on a NAS
• Users who want short dramas downloaded to a phone for offline viewing
• Users who want a batch downloader with a web interface

Quick Start

Docker deployment

1. Create two folders on the NAS, one for configuration and one for downloads
2. Write a docker-compose.yml with the access password and the download folder mapping
3. Run docker compose up -d to start the service
4. Visit http://NAS_IP:8800 in a browser and enter the access password

Android client

1. Download the APK from Releases and install it
2. In local mode, parse and download directly on the phone into the target folder
3. In cloud mode, enter the NAS address and password in settings to download remotely
4. You can also share a link from the Hongguo app straight into this app for parsing

Core Advantages

• Flexible deployment: runs long-term on a NAS or directly on a phone
• Complete pipeline: parsing, downloading, decryption and merging happen in one flow, with no manual stitching
• Visible state: task progress persists so work continues after a refresh or restart
• Phone ready: the web interface works just as well on a phone, with no computer needed

System Requirements

Item	Requirement
Server	A device supporting Docker, such as a NAS
Client	An Android phone
Merge tools	The media tooling needed for merging is bundled in the server

Notes

• If pulling the image fails, deploy by importing the offline image instead
• The platform's API and risk controls change over time, so retry later if parsing fails
• Follow the platform's terms and local laws when downloading; content belongs to the original authors
• Always set an access password so the download service is not called by others