Skip to content
Everframe
Sign inGet started →
iOS SDK

tvOS, reported with the whole story.

Crash reports and one-gesture quick capture from your Apple TV apps — link a test Apple TV once, hold Play/Pause, title the capture on the dashboard.

Get started → See a real report

The iOS SDK targets tvOS. Native crashes, memory kills and the errors your app passes to captureException become reports with the trail of screens and the device, and release health tracks each app version. Link a test Apple TV to yourself or your team, and holding Play/Pause files a draft with the screenshot, replay and logs that you title on the dashboard.

quick capture screenshotreplay (per app)logsscreen trailcrash reportsdevice

Reporting from Apple TV apps

Apple TV apps are among the hardest to debug from the field: a tester sees a glitch in the living room and has to describe it from memory, or film the screen with a phone. On a TV there is no keyboard and no screenshot key, so Everframe does not put a reporter on the TV. The iOS SDK reports crashes and errors from the Apple TV app on its own, with the trail of what happened before, and a linked Apple TV files a quick capture when you hold Play/Pause. Quick capture on real devices covers linking, team devices and the gestures.

Linked Apple TVs

An Apple TV is linked to one teammate, whose captures are private drafts, or to the project as a team device, whose captures land in the shared inbox. It can pass from one person to the next in seconds, and each capture is attributed to whoever held it. Admins can change the gesture in the app’s Quick capture card, or record it from a real Siri Remote.

The same envelope as every other screen

The same Swift SDK that powers your iPhone app targets tvOS. A tvOS report is the same envelope as one from your phone or web app, so webhooks, triage rules and the dashboard treat it the same way — the stack, the trail of screens and the device.

Release health for tvOS

The Swift SDK records foreground sessions for each shipped Apple TV app version. Release health shows tvOS separately, with a platform filter and crash-free session rates. Native crashes count when they are tied to the session; inferred memory kills and unexplained exits remain unknown outcomes. Debug builds are excluded by default, and disabling the reporter keeps crash-only health collection active.

Without an SDK

Xcode’s Crashes organizer, a paired Apple TV in Xcode and TestFlight feedback each cover part of the picture. tvOS crash logs walks through what each one gives you on Apple TV, and which failures none of them record.

Crash reporting on tvOS

Native crashes in your Apple TV app become reports on the next launch, and foreground memory kills are reported as inferred terminations, without a stack. Errors your app passes to captureException are reported too, with the app version and the device.

What every tvOS report carries

  • Native crashes with the stack once symbols are uploaded, and foreground memory kills as inferred terminations.
  • Errors your app passes to captureException, with the trail of screens before them. Replay when it is enabled for the app.
  • A screenshot of exactly what the TV rendered on a quick capture, masked before it leaves the device.
  • App, SDK, OS and device metadata, crash-free session rates per app version, and who holds the linked Apple TV.

Install

// Package.swift
.package(url: "https://github.com/scriptx-com/everframe", from: "1.2.1")

Questions

How do I file a bug from an Apple TV?

Link the Apple TV under Project settings → Devices in the dashboard, then hold Play/Pause on the Siri Remote for about 1.5 seconds. A draft with the screenshot, replay and logs lands in the dashboard's capture card, and you title it there.

Does the Apple TV app need a keyboard or a special remote?

No. Nothing is typed on the TV, and the Siri Remote stays a remote. On a linked Apple TV the gesture's presses don't reach your app, so a capture doesn't also pause playback.

Do people watching on other Apple TVs see anything?

No. Quick capture only fires on a linked Apple TV or a debug build. End users of a release build see no change.