Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

my-name-is-alan/iDuanJu

Media & Design

An open-source iOS and Android player that aggregates short dramas, videos, manga and Telegram channels through user-configured sources and sandboxed JS plugins.

158
36
HTML
GPL-3.0
8 days old

What it does

iDuanJu is a native media aggregator for iOS (SwiftUI) and Android (Kotlin + Jetpack Compose + Media3). It brings short dramas, long-form video sites, manga and Telegram channels into one player. The app hosts no content: your device requests data directly from public sites, and you import sources yourself. Supported inputs include Hongguo short dramas, Apple CMS v10 collection sites, MangaDex and Baoman, TXT/EPUB novels on iOS, Legado-style book sources, and Telegram public channels; private channels need a TDLib login.

Its extensibility comes from a QuickJS plugin sandbox: each plugin runs separately, can only reach domains it declares and you approve, keeps its own cookies and storage, and cannot use eval or reach the local machine or LAN. Plugins can be added from a URL, file, pasted text or a subscription list. The player uses AetherEngine (FFmpeg demuxing plus system decoding) by default and falls back to AVPlayer for CENC, FairPlay or load failures; it also strips inserted HLS ad segments by default.

Getting started

Install a build: Android users can download the 1.5.12 APK and allow installation from unknown sources; Android releases from 1.5.8 use a fixed distribution signing key, and upgrading from an older debug-signed build requires backing up source/plugin settings and uninstalling first. iOS users download the unsigned 1.5 build 12 IPA and re-sign it with AltStore, Sideloadly or TrollStore using their own Apple ID.

To build from source on macOS, install Xcode 16+ and XcodeGen, then:

brew install xcodegen
git clone https://github.com/my-name-is-alan/iDuanJu.git && cd iDuanJu
xcodegen generate
open STV.xcodeproj

Alternatively run xcodebuild against the STV scheme for the simulator, or package an unsigned IPA with scripts/package.sh. The iOS deployment target is 18.0. Android builds need JDK 21 and Android SDK platform 35: cd android && ./gradlew assembleRelease.

For novels, import your own Legado source collection, pick a source at the top of the ranking list and a column on the left; from the detail or reading page you can cache the next 50/200 chapters or the whole book and switch between sources for the same title. Telegram private channels require your own api_id/api_hash from my.telegram.org.

Constraints

  • iOS requires macOS + Xcode 16 or newer to build and iOS 18.0+ to run; the unsigned IPA must be re-signed before sideloading.
  • Android requires Android 8.0 (minSdk 26) and later. The APK is not distributed through any app store.
  • AetherEngine caps playback speed at 2×. CENC/FairPlay content and failed loads fall back to AVPlayer, which may change available features.
  • Android still lacks full Legado Java/WebView rule support, EPUB import, text-to-speech, TDLib login/downloads, manga offline downloads, plugin timeout/signature checks, Cloudflare verification, streaming CENC and Face ID source lock.
  • Adult sources and plugins are off by default and require an explicit 18+ unlock. Face ID locking is iOS-only.
  • Licensing is GPL-3.0, and paid distribution of the app or code is prohibited; derivatives must stay open source. Third-party components (AetherEngine, FFmpeg and others) are covered by their own licenses and shipped as replaceable dynamic frameworks.

HotRepo's take

The repository appeared on HotRepo's new-project list on 2026-11-17, with 18 stars gained in about two hours and 119 stars overall; that is a short, single-day window, so it does not establish a trend. What stands out technically is the combination of native SwiftUI/Kotlin clients with a QuickJS sandbox and explicit per-plugin domain allow-lists, which is more engineering detail than typical aggregator apps disclose. However, the main distributables are an unsigned IPA and an APK that most readers cannot easily verify against the source, so evaluate the release artifacts accordingly.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. LNPANDY/HGhub-MacOS-iOS-VersionA cross-platform short-drama player built with Tauri for macOS and iOS, with gesture controls and stream caching.TypeScript110
  2. torrentplayer/torrentplayerPlay video and audio torrents straight from the swarm, with near-instant seeking to any moment, for desktop users.Rust530
  3. beilunyang/openhongguoUnofficial anonymous SDK for browsing Hongguo short dramas and resolving episode playback and decryption keys across six languages.Go122
  4. frostming/dsh-hongguoA DSH sidebar plugin that streams short dramas while a coding agent works, with history and task-aware prompts.JavaScript100
  5. Stonewuu/ai-fusion-videoAgent-driven workspace to script, storyboard, generate, and assemble short-drama videos.Java1,711