Repository navigation
TVPort 1.2
TVPort 1.2 (build 26) updates the embedded engine and adds game attachments, separate Top Shelf covers, a new app icon and Mac interface improvements. It retains the save-management, artwork and controller features from 1.1.
Download
Download TVPort-1.2.zip, unzip it, and open TVPort.app on an Apple-silicon Mac. This is the ready-to-run Mac app with its engine included; you do not need to build TVPort from source. Xcode, its Apple TV/iOS SDKs and Metal toolchain, the build tools, and an Apple TV paired through Xcode are still required to build and install games.
The app is signed ad hoc and is not notarized, matching the 1.1 distribution. macOS may require System Settings → Privacy & Security → Open Anyway on first launch. A SHA-256 checksum is provided alongside the download.
TVPort 1.1 and its app download remain available.
What’s new in TVPort 1.2
- Updated the embedded nxnative engine and shader tools while retaining TVPort’s Apple TV adaptations.
- Fixed Unity 6000.3 shader parsing and the Apple TV startup check that incorrectly rejected GPUs using decoded BC textures.
- Added drag-and-drop for game folders and NSP, XCI, NSZ and XCZ files.
- Added an Updates & DLC section: attach files from other folders or drives, check that they belong to the game, and apply them on the next Build & Install.
- Added a separate Top Shelf cover with PNG/JPEG import, a wide preview, and independent zoom and position controls.
- Made the full build log selectable and readable in dark mode. The frame-rate counter now defaults to off for new games.
- Added a new app icon and refined labels, alignment and toolbar spacing.
- Fixed Last Run Stats appearing out of view. It now opens in a dedicated panel with loading status, clear errors, Refresh and a selectable run log.
Existing features and instructions remain below.
Existing features
Manage Saves retains offline browsing, local save imports, backup and restore by player/save slot, Back Up All Saves, Finder access and optional iCloud Drive backup storage. Automatic artwork lookup, icon cropping, A/B and X/Y swapping, and configurable build folders are also retained. See the project page for the full feature list and new screenshots.
Updating and compatibility
- Rebuild and install a game to apply engine, artwork or DLC changes; existing installed game apps retain their previous engine until rebuilt. The updated shader tools can require shaders to be rebuilt.
- Game compatibility varies. Build checks do not guarantee that every game will run. The new DLC workflow has passed package and build-wiring tests, but has not yet been play-tested on Apple TV.
- This release does not announce Switch 2 or web-view support on Apple TV.
Validation
The Mac app builds successfully and its signature and ZIP integrity were checked. All 92 TVPort tests passed. The 320 package checks passed across the initial run and a rerun of the 65 incremental checks with their required dependency installed. Python lint adds no findings. Generated standard and wide Top Shelf images have matching central artwork at both scales, and choosing a custom cover leaves the app icon unchanged. The project owner confirmed the corrected Top Shelf cover and Last Run Stats on the Apple TV.
Embedded nxnative base: 777a5f6c, with TVPort adaptations. Engine ID: 58f51e57a811; shader chain: 0ad559cdbb28.
Thanks to the original TVPort, nxnative and NX2Apple contributors. Their credits, licenses and project information remain in the repository and app.