Back to All Projects
Open Source Verified Architecture
HGhub
HGhub is an open‑source media player built around a plug‑in architecture, allowing users to add or swap codecs, visualizations, and other features as needed. Its lightweight core and clean API let developers quickly create extensions or embed the player in larger multimedia applications.
9,521 Stars 7,895 Forks
Core Technologies & Frameworks
Rust
Technical Architecture & Specifications
HGhub is an open-source, decoupled media application that offloads content ingestion entirely to an extensible JavaScript plugin layer. Architecturally, the app acts as a clean execution client—it does not bundle default content, host third-party scrapers, or enforce a centralized account system. Content parsing, dynamic routing, and source-specific authentication are delegated entirely to user-imported plugins through the HPP (HPP Plugin Protocol).
### Architecture and Tech Stack
The core engine is built on a high-performance cross-platform stack:
- Backend Runtime: Built using Rust and Tauri 2, providing a low-overhead host runtime designed to target Windows and Android.
- Frontend Layer: Written in React and TypeScript, powering an adaptive UI across mobile and desktop environments.
Under the hood, HGhub supports native video files alongside adaptive HLS streams. The player includes dynamic line switching, resolution selection, and parser overriding. Because plugins control content delivery, the client implements dynamic fail-safes for plugin management: it checks for script updates and automatically rolls back to the last functional version if a remote update breaks.
Beyond standard Video-on-Demand (VOD), the HPP specification allows plugins to feed live streams, content feeds, and text/image data directly into the client’s native playback, gesture-driven controls, and local state management (favorites, watch progress, and history).
### Setup and Configuration Flow
HGhub is currently in early development. To run the app, you need to build or execute it from source targeting supported platforms (currently focused on Windows and Android).
Once the application is running, follow this initialization process to bind content sources:
1. Open Plugin Center → Import & Subscribe (on mobile, navigate through the "My" tab to access the Plugin Center).
2. Import a JavaScript plugin or parser using one of three methods:
- Uploading a local `.js` plugin file.
- Pasting the raw plugin source code directly.
- Supplying a valid plugin or plugin list URL.
3. Confirm installation and enable the source.
4. Set default home sources within Settings or trigger aggregate search queries across all configured plugins.
### Developer and Licensing Policy
If you are extending the platform, HGhub explicitly provides docs for writing parsers via the HPP protocol, including an agent development guide (`docs/developers/agent.md`) designed for AI-assisted plugin writing.
The codebase is released strictly under the PolyForm Noncommercial 1.0.0 license. Commercial distribution, activation key schemes, paid integrations, or ad monetization are prohibited.
Reviewed by DevTechPulse Editorial Board
All listed blueprints, repositories, and case studies are verified against public documentation and LTS container environments. For inquiries or updates, view our Editorial Policy.