How jackotom/hongguo-drama works
Hongguo Drama is a desktop drama discovery, playback, download, and export app, with a server/NAS runtime also present. The main user flow is browse or search for a series, open it in the player, and optionally queue downloads or export merged episodes. The graph preserves documented discovery, account, history, danmaku, and catalog capabilities. Evidence is limited to the README and indexed source references/excerpts; unsampled components are included where the tree or index establishes them, but uncertain connections are omitted.
Main entry points: App.jsx App shell · Player.jsx Player · hongguo.js Source resolver · index.cjs NAS service
Components 28
Desktop interface
- App shell
src/App.jsx - Browse
src/components/Browse.jsx - Drama feed
src/components/DramaFeed.jsx - Release calendar
src/components/ReleaseCalendar.jsx - Search panel
src/components/SearchPanel.jsx - Player
src/components/Player.jsx - Download manager
src/components/DownloadManager.jsx - Watch history
src/components/WatchHistory.jsx - Account management
src/components/AccountManagement.jsx
Discovery and identity
- Catalog sources
src/native/catalog.js - App catalog
src/native/hongguo-app-catalog.js - App search
src/native/hongguo-app-search.js - Hongguo search
src/native/hongguo-search.js - Series details
src/native/public-details.js - Account session
src/native/account-session.js
Playback and downloads
- Source resolver
src/native/hongguo.js - ReelShort source
src/native/reelshort.js - Hema source
src/native/hema.js - Custom sources
src/native/custom-source.js - Danmaku
src/native/danmaku.js - History backend
src/native/watch-history.js
Desktop runtime
- App settings
src/store.js - Electron main
main.js
NAS server
- NAS service
server/index.cjs - Task storage
server/storage.cjs - Media service
server/media.cjs - Search service
server/search.cjs
Other components
- Viewer
Connections 25
- Viewer → App shell: uses
- App shell → Browse: renders
src/App.jsx - App shell → Player: renders
src/App.jsx - App shell → Drama feed: renders
src/App.jsx - App shell → Release calendar: renders
src/App.jsx - App shell → Watch history: renders
src/App.jsx - App shell → Download manager: renders
src/App.jsx - App shell → Account management: renders
src/App.jsx - Browse → Catalog sources: loads catalog
- Search panel → App search: searches
- Search panel → Hongguo search: searches
- Browse → Series details: opens details
- Player → Source resolver: resolves media
- Account management → Account session: manages session
- Player → Danmaku: shows comments
- Player → History backend: updates history
- Electron main → App settings: uses
main.js - Source resolver → ReelShort source: delegates source
src/native/hongguo.js - Source resolver → Hema source: delegates source
src/native/hongguo.js - Source resolver → Custom sources: delegates source
src/native/hongguo.js - NAS service → Task storage: uses storage
server/index.cjs - NAS service → Media service: uses media
server/index.cjs - NAS service → Search service: uses search
server/index.cjs - Search service → App search: calls
server/search.cjs - Search service → Hongguo search: calls
server/search.cjs