Skip to content

About

Yingxia: a native SwiftUI TVBox player for Apple TV, iPhone, iPad and Mac.

Resources

Stars

211 stars

Watchers

0 watching

Forks

Repository files navigation

Yingxia app icon

Yingxia

All your sources. One big screen.
A native TVBox player for Apple TV, iPhone, iPad and Mac.

yingxia.getmegaportal.com  ·  Download for Mac  ·  Install on iPhone, iPad & Apple TV  ·  Developer guide

SwiftUI Platforms Version

Yingxia's Watch Now screen on Apple TV


Yingxia (映匣) plays your TVBox subscriptions the way an Apple app should: live channels, on-demand catalogs, and one search across every source, all in SwiftUI and AVKit. No web views, no ported Android screens, no account.

👉 See it in action at yingxia.getmegaportal.com, including the intro film.

✨ Highlights

📺 Live TV, laid out like a guide Bring M3U or TXT playlists. Browse by group, search channels, and keep your favorites close.
🔎 Search everything at once One query runs across every source in your subscription, and results appear as they arrive.
🗂️ Every source gets its own shelf Browse each source's categories and pages with nothing but the Siri Remote.
🧩 Plugins on device Runs JSON, JavaScript and JAR sources, plus Python on Mac. Lightweight ports go first, with the original plugin as a fallback.
🛟 Your subscription, kept safe Import any TVBox JSON subscription by URL. A failed refresh never wipes the last working copy.
🎬 Native playback AVPlayer with HLS, clear error screens with Retry, and a separate Picture in Picture player window on Mac.
🔒 Private by design No account and no analytics. Everything stays on your device, and logs redact credentials.
🌏 Speaks your language English, Japanese, and Traditional and Simplified Chinese, following your system setting.

Live TV guide Global search

📦 Get it

Platform Status
Mac (macOS 15+, Apple silicon) ✅ Free download, signed and notarized
Apple TV (tvOS 26+) 🧪 Preview. Download the IPA and sideload it
iPhone & iPad (iOS 18+) 🧪 Preview. Download the IPA and sideload it

The iPhone, iPad and Apple TV apps aren't on the App Store yet. The install guide walks you through installing them with your own Apple account (a free one works), keeping them signed, and fixing common problems.

🛠️ Build from source

You'll need Xcode, XcodeGen, JDK 19 with Maven, a standalone Node.js binary, and uv.

export JAVA_HOME="$(/usr/libexec/java_home -v 19)"
Scripts/build-java-host.sh      # bundled JVM plugin runtime
Scripts/build-script-host.sh    # JavaScript host
Scripts/build-python-host.sh    # Python host
xcodegen generate
open TVBox.xcodeproj            # pick TVBox-macOS, TVBox-iOS or TVBox-tvOS

Physical iPhone, iPad and Apple TV builds need your own signing team in Xcode. The developer guide covers command-line builds, tests, source audits, the plugin runtime architecture, and more.

🧭 Project map

Path What's inside
App/ SwiftUI screens and platform playback
Sources/TVCore/ Subscriptions, networking, catalogs, localization, runtime boundaries
Runtime/ JVM, JavaScript and Python plugin hosts
Vendor/ Vendored DEX interpreter and QuickJS
website/ The yingxia.getmegaportal.com site
Docs/ Install guide, developer guide, runtime status, third-party notices

🙏 Acknowledgements

Yingxia stands on the shoulders of FongMi/TV (reference implementation), DexLoom, unidbg, Unicorn, dex2jar, QuickJS-ng and others. Licenses and details are in THIRD_PARTY_NOTICES.

License

Yingxia's original code is licensed under the GNU General Public License v3.0 (GPL-3.0-only).

Copyright (C) 2026 jo32 and Yingxia contributors.

You may use, modify, and redistribute Yingxia under the terms of this license. When distributing a covered modified version, you must also provide its corresponding source code under GPL-3.0. The software is provided without warranty.

Third-party code and bundled dependencies retain their own licenses and copyright notices; see Third-Party Notices.

⚖️ Disclaimer

Yingxia is a player. It does not host, provide or endorse any media content, and it shows only what the subscriptions you add provide. You are responsible for using sources you have the right to access. Apple TV, iPhone, iPad and Mac are trademarks of Apple Inc. This project is not affiliated with Apple.

Made with SwiftUI · yingxia.getmegaportal.com

About

Yingxia: a native SwiftUI TVBox player for Apple TV, iPhone, iPad and Mac.

Resources

Stars

211 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages