Repository navigation
What’s new in TVPort 1.3
- Game version preview: Shows Next build and Last built, including the selected update before the first build. Reads actual game metadata and shows the revision when the version name is unavailable.
- Engine version checks: Compares the selected game with registered engine profiles, distinguishing verified code build-ID matches, version-only matches, different versions and missing profiles.
- Engine notes: Added game-specific notes and relevant shared engine documentation, available offline. Includes registered versions and source references.
- Engine information in Settings: Shows the nxnative source repository and base revision, TVPort source revision, bundled engine identifier and shader chain.
Building and installation
- Added Install for unchanged, verified builds, reusing existing generated files and shaders while checking signing.
- Artwork-only changes update app assets without repeating unchanged game extraction and shader work.
- Added an early Xcode signing check to catch account, provisioning and network problems before lengthy conversion.
- Local compilation and signing no longer depend on a live connection to the Apple TV.
- If installation or transfer fails after a successful build, TVPort keeps the build as Built · Install pending and continues with the next queued game.
- Compilation or signing failures, and manually stopping a build, still pause the queue.
- Fixed the tvOS compilation error involving
AVAudioSessionInterruptionReasonKey, retaining audio interruption handling.
Updates and DLC
- Updates and DLC discovered inside the original game folder or combined packages now appear in Updates & DLC.
- Clearly identifies the update selected for the next build and where automatically included content comes from.
- Allows adding updates and DLC during save operations or while another game builds.
- Locks changes only for the game currently building or waiting in the queue, with an explanation.
- Removed the general “under development” warning from the app.
Progress and logs
- Fixed delayed or missing live build output that could leave the interface showing Starting.
- Added structured engine progress, including file and shader counts when available.
- Explains when shaders need rebuilding because their toolchain or inputs changed.
- Removed the build log’s 4,000-line display limit.
- Made transfer status agree with the operation being performed.
- Standardized transfer sizes to decimal GB.
- Removed unreliable transfer-speed estimates, remaining-time estimates and “Waiting for transfer progress” messages.
Game-file recovery
- Added Transfer RomFS Again… to resend matching game data without rebuilding shaders, signing, reinstalling the app or changing saves.
- Checks the local build and installed app identity before allowing the transfer.
- Checks the resulting remote file size. The game’s startup check validates its RomFS identity.
Save management
- Fixed a restore operation that could delete neighbouring game files, including RomFS, by removing CoreDevice’s directory-cleanup option.
- Added checks for conflicting save layouts before writing, plus checks that neighbouring cache files remain present.
- Retained safety backups and read-back verification, with clearer recovery messages when a restore fails.
- Added detection of shared saves versus separate player saves for rebuilt games.
- Restore confirmations now explain the destination and whether restoring affects all players.
- Replaced misleading persistent “Apple TV unavailable” messages with clearer information about the failed check. Successful communication clears the relevant stale warning.
Build history and troubleshooting
- Added Build History…, recording build attempts, versions, update/DLC selections, engine details, settings, results and build locations.
- Added Mark as Working and personal notes for individual builds.
- Identifies missing or replaced build locations without duplicating or archiving game builds.
- Added Export Diagnostic Report…, combining recorded build information, build logs and the latest fetched run log.
- Reports can be reviewed and edited before export. Personal paths and recognizable identifiers or secrets are masked; saves, keys, game data and images are excluded.
Known limitation
Repeated transfer failures have been reported with large game files, particularly files over 12 GB. A fixed file-size limit has not been confirmed. Completed builds remain saved on the Mac for retrying installation or transfer.
Download and install
Download TVPort-1.3.zip, unzip it, and move TVPort.app to Applications. Quit the previous TVPort app after active work has finished, then open the new app. About TVPort should show 1.3, build 65.
This is the ready-to-run Mac app with its bundled engine. Xcode and the existing build dependencies are still required. The app is signed ad hoc and is not notarized. If macOS blocks its first launch, use System Settings → Privacy & Security → Open Anyway.
Your library and backup locations are retained. Earlier releases remain available in the release history.