yanhuo-short

Project Overview

Yanhuo Short is an Android vertical short-drama app whose content comes from third-party public web APIs; the app is a player and UI only, storing and redistributing no media itself.

The primary source is the Qimao short-drama API, verified to serve direct links for every episode of its 713 titles, with Hongguo as a fallback; the home feed marks episode counts on cards, a hot list scrolls on top, and the player auto-continues and resumes.

Item	Value
Platform	Android
Language	Kotlin
Primary source	Qimao public API (full-episode links)
Fallback source	Hongguo (first 3 episodes)

Every episode linked on the primary source, with auto-continue and subscription alerts for binge-watching.

Key Features

• Waterfall home: two-column cards with episode counts, gold badges for the top-three hot list, infinite scroll
• API search: search by title with automatic pagination as you scroll
• Vertical player: fullscreen vertical playback, auto-next episode, resume, episode drawer
• Favorites: one-tap from cards or the player, managed in one place
• Series subscription: checks for new episodes every 6 hours, notifies with an in-app badge
• Watch history: progress tracked and paired with resume playback
• Source self-check: built-in source availability checks and run logs
• Storage cleanup: one-tap cache clearing

Target Audience

• Fans of vertical short dramas
• Viewers who want full-episode links without hunting
• Subscription viewers who want update alerts
• Android developers studying API aggregation

Quick Start

1. Download the APK from Releases and install on an Android phone
2. Browse the hot list on home or search for a title
3. Open a detail page, pick an episode and play with seeking support
4. Favorite or subscribe to shows for automatic update alerts
5. Manage history, storage and toggles under Mine

Core Advantages

• Every episode playable: the primary source serves direct links for all episodes, no first-3 cap
• Dual-source fallback: switches to the backup source when the primary misses a title
• Automated following: auto-continue, resume and subscription alerts in one flow
• Light and clean: player aggregation only, no storage or redistribution

System Requirements

Item	Requirement
OS	Android
Build tools	Android Studio, JDK, Gradle
Network	Internet access to third-party public APIs

Notes

• Third-party content: all content and playback URLs come from public third-party APIs, for personal study only
• No browse-all: the API supports title search only; the home feed rotates through genre keywords
• Fallback limits: the Hongguo fallback only serves the first 3 episodes per title