English | 简体中文
A native macOS IPTV/VOD player for Apple Silicon with Xtream, M3U/XMLTV, selected TVBox/CatVod/CatPaw-style providers, and libmpv playback.
Built with Swift and SwiftUI/AppKit. Android is an optional compatibility layer for selected Java/Dex providers.
Native macOS · Xtream · IPTV/VOD · M3U/XMLTV · libmpv · Multi-provider Search · QuickJS/Node Spiders
The latest stable release is 0.6.1 (Build 101) · macOS 12.0+ · Apple Silicon
(arm64) only. This patch adds Android component storage management and uninstall.
Download the Developer ID signed and Apple-notarized v0.6.1 DMG. This release passed stapling, Gatekeeper assessment and installation smoke tests.
Open the DMG and drag OKVideoMac.app to Applications. You do not need to
disable Gatekeeper or SIP. Checksums, release notes, source archives, SBOMs,
and notices are published with each release.
OKVideoMac is a player and provider client. It does not include third-party video sources, accounts, cookies, parsing services, or DRM keys.
- Android storage categories: view managed components, installation cache, Android user data and backups separately, with an estimate for the selected removal.
- Safe managed-component uninstall: remove recognized Android components managed by OKVideoMac after its Android session has been confirmed stopped.
- Keep your Android data: user data and login state, backing/encryption files, Android home, private ADB identity, user-data backups and runtime selection stay. External SDK files are never uninstall targets. Reinstall managed components later when needed; a separate Android user-data deletion action is not offered.
- Recovery and documentation: interrupted maintenance can be resumed; English and Chinese project descriptions now give existing Native Xtream equal visibility.
Native Xtream was introduced in 0.6.0, including authentication, Movies, Series,
Movie/Series search and Basic Live. Xtream EPG, catch-up/timeshift and direct_source
remain unsupported. See the 0.6.1 release notes.
 Multi-provider search |
 Detail and episode navigation |
 Live channel browser |
 VOD playback |
 Live TV playback |
These 0.6.1 captures use the English interface and fictional scenic demo data; they contain no third-party catalogue, account, credential or private URL. See the screenshot manifest for the complete bilingual file map and image-processing notes.
- Native Mac experience. A SwiftUI/AppKit interface designed for Apple Silicon, with native windows, sheets, keyboard behavior, accessibility, and macOS navigation—not a repackaged mobile interface.
- libmpv playback. VOD and live playback use libmpv/FFmpeg, with seeking, tracks, subtitles, playback speed, screenshots, fullscreen, and bounded fallback between available lines.
- Flexible provider runtimes. Native Xtream and CMS JSON plus selected TVBox/CatVod
QuickJS, CatVod/CatPaw-style Node, and Java/Dex
csp_Spider paths. The compatibility boundary is explicit rather than advertised as universal. - Search and library. Isolated multi-provider search, details, favorites, history, progress restoration, and long-series episode navigation.
- Live TV on macOS. Import M3U, TXT, or JSON channel lists, use multiple lines, and load XMLTV EPG data without Android.
- Managed Android Runtime. When a supported Java/Dex Spider really needs Android, the app can install and manage its own pinned environment. Advanced users may explicitly choose a compatible External SDK instead.
- Release engineering. Public DMGs are Developer ID signed, notarized, stapled, checked by Gatekeeper, and accompanied by hashes and source/SBOM material.
| Capability | Status | Notes |
|---|---|---|
| Native macOS UI | Supported | SwiftUI/AppKit; no Android UI shell |
| Apple Silicon | Supported | arm64, macOS 12.0 or later |
| VOD and libmpv playback | Supported | Media behavior still depends on the source/server |
| Live TV and XMLTV EPG | Supported | M3U, TXT, and JSON import paths |
| Native Xtream | Supported | Authentication, Movies, Series, Movie/Series search and Basic Live; server differences apply |
| Native CMS JSON | Supported | Home, category, filter, detail, search, and play handoff |
| QuickJS Spider | Selected | Compatible scripts matching the implemented API |
| Node Spider | Selected | CatVod/CatPaw-style video-interface subset |
Java/Dex csp_ Spider |
Experimental | Requires Managed Runtime or a confirmed External SDK |
| Managed Android Runtime | Available | Recommended Android mode; installed only when needed |
| Managed component storage / uninstall | Available | Categorized usage; preserves user data and external SDKs |
| External Android SDK | Available | Explicit advanced-user choice; never auto-selected from PATH |
| Intel Mac | Not supported | No Intel or Universal Binary release is provided |
Compatibility depends on the source format, runtime, API shape, parsing requirements, and media behavior—not only on an ecosystem name. See the full compatibility guide.
Most of OKVideoMac does not need Android. Native providers, QuickJS and Node Spiders, live TV, XMLTV, search, and ordinary playback run directly on macOS.
Only selected Java/Dex csp_ Android Spider sources use the optional Android
Bridge:
- Managed Runtime (recommended): on the first real Dex request, OKVideoMac
asks for confirmation, downloads the pinned JRE/Android components into its
private Application Support directory, verifies them, and resumes the
request. No Android Studio, Homebrew ADB, system Java,
ANDROID_HOME, or manually created AVD is required. - External SDK (advanced): users who already have a compatible Android SDK
can select and confirm it in Settings. OKVideoMac does not silently switch
modes because Android Studio, Homebrew,
PATH, or environment variables expose another SDK.
Android Compatibility can show categorized storage usage and safely uninstall Android components managed by OKVideoMac when they are no longer needed. Android user data and login state, private ADB identity, user-data backups, runtime selection, and external Android SDKs are preserved. The confirmation shows estimated reclaim based on the recognized installation; it does not promise a fixed amount of space. See Android storage and uninstall.
Managed installation is transactional and separate from Emulator session management. Full behavior, storage, repair, licensing, and current real-machine validation limits are documented in Android Bridge Setup.
- Download the latest stable DMG, open it, and move the app to Applications.
- Launch OKVideoMac and add a provider configuration or live playlist that you are authorized to use.
- Browse, search, open a detail page, or import an M3U/TXT/JSON live list.
- If a selected Java/Dex provider needs Android, follow the in-app Managed Runtime prompt. Other provider and live paths need no Android setup.
| Source / runtime | Level | Current scope |
|---|---|---|
| Native Xtream | Supported | Authentication, Movies, Series, Movie/Series search and Basic Live; server differences apply |
| Native CMS JSON | Supported | Main provider path |
| CMS XML / native type 4 | Partial | Narrower coverage than CMS JSON |
| TVBox/CatVod-style QuickJS | Selected | home, category, detail, search, play, and selected helpers |
CatVod/CatPaw-style Node .js.md5 |
Selected | Supported video-interface subset; not the complete CatPawOpen protocol |
Java/Dex Android csp_ |
Experimental | Selected CatVod-style methods through the optional Bridge |
| M3U / TXT / JSON live lists | Supported | Dedicated live importer; top-level TVBox lives is not wired to it |
| XMLTV EPG | Supported | Remote HTTP(S), gzip, cache, and channel matching |
| Parser type 0 / 1 | Partial / Supported | WKWebView sniffing / JSON parsing |
| Parser types 2 / 3 / 4 | Unsupported | Fields may parse, but there is no complete execution path |
OKVideoMac implements selected TVBox-, CatVod-, and CatPaw-style interfaces; it is not an official client for those projects and does not promise that every public or private provider will work.
- No video catalogue, IPTV service, provider account, cookie, parser service, or DRM key is bundled.
- You choose the configurations, scripts, playlists, and media you are authorized to access. Remote Node bundles have broad execution capability; load only sources you trust.
- Logs and diagnostics are designed to redact credentials and private paths, but issue reports should still be reviewed before publication.
- OKVideoMac does not implement DRM bypass. Please use the project only with content and services you are permitted to access.
- macOS 12.0 Monterey or later;
- Apple Silicon (
arm64); Intel Macs are not supported; - network access for remote providers/media and, if selected, Managed Runtime installation;
- sufficient free disk space only when the optional Managed Android Runtime is installed.
OKVideoMac is an independent, native macOS TVBox-style provider client—not an official TVBox app and not an Android wrapper. It implements selected compatible configuration and Spider paths, so people looking for a TVBox for Mac should check the compatibility table before assuming a particular source will work.
No. It is a player/provider client. You supply configurations and playlists that you are authorized to use; no third-party catalogue, account, cookie, parsing service, or DRM key is bundled.
Not for normal use, and not for Managed Runtime. If a selected Java/Dex Android Spider needs Android, OKVideoMac can download and manage the required environment after you confirm. External SDK remains an optional advanced mode.
That provider contains Android bytecode. OKVideoMac runs the supported subset through a private Android Bridge; Native, QuickJS, Node, live-TV, and XMLTV paths do not use it.
It supports selected CatVod/FongMi-style QuickJS APIs and a selected CatVod/CatPaw-style Node video subset. Java/Dex support is Experimental. It is not complete TVBox, CatVod, CatPaw, or CatPawOpen ecosystem compatibility.
No. Current releases target Apple Silicon only; the app and optional Android Runtime are not shipped as an Intel or Universal Binary stack.
- Java/Dex compatibility remains Experimental. The Managed API 35 profile has real Emulator/Bridge/Dex E2E evidence on one M1 / macOS 14.8.8 host; Managed Emulator E2E on macOS 12, 13, and 15 remains unverified.
- QuickJS, Node, cloud, and web-sniffing paths cover selected interfaces and may need updates when upstream implementations change.
- Top-level TVBox/FongMi
lives, catchup/timeshift, parser types 2/3/4, and DRM are not supported. - Playback ultimately depends on libmpv, codecs, headers/cookies, the media server, and the selected provider.
- A large legacy database may cause a one-time startup pause.
The repository separates core models/networking, SQLite persistence, macOS UI, native playback bridges, provider runtimes, Managed Runtime installation, and Android Emulator sessions. Installation and session lifecycle are deliberately separate state machines.
Release builds require the repository's controlled scripts and fail-closed checks; a local Debug compile is not a public release artifact.
The 0.6.1 / Build 101 DMG passed Release packaging, Developer ID signing,
Apple notarization (Accepted), stapling, Gatekeeper and installation smoke tests
under the DMG release process. Tag v0.6.1 pins
release commit 25155f52fb8c416f3245c9a829a93175dec9857b; matching source archives,
SBOMs and checksums accompany the download. Later documentation updates do not
change that signed binary or its source snapshot. The v0.6.0 release remains unchanged. See the 0.6.1 release notes
and source release process.
- Detailed project documentation
- Compatibility guide
- Android Bridge Setup
- Build from source
- Architecture
- Android storage and uninstall
- 0.6.1 release notes
- Changelog
- Security policy
OKVideoMac is distributed under the GNU General Public License v3.0. Third-party components remain subject to their respective licenses and notices.