Put tvOS Browser on your Apple TV.

• A Mac with Xcode 27 or later, free from the Mac App Store.
• An Apple TV running tvOS 26 or later, on the same Wi-Fi or network as the Mac.
• An Apple ID. A free one works; see how long an install lasts.

Pick whichever is easier for you:

git clone https://github.com/eugenezimin/AppleTVBrowser.git

Then open the project in Xcode by double-clicking _Project/Browser.xcodeproj, or from Terminal:

open AppleTVBrowser/_Project/Browser.xcodeproj

1. In Xcode, open Xcode → Settings (or press ⌘ ,).
2. Go to the Accounts tab.
3. Click +, choose Apple Account, and sign in.

1. On the Apple TV, open Settings → Remotes and Devices → Remote App and Devices, and stay on that screen.
2. On the Mac, open Window → Devices and Simulators in Xcode. Your Apple TV appears under Discovered.
3. Click Pair and type in the code shown on your TV.

If the Apple TV asks for it after pairing, open Settings → Privacy & Security → Developer Mode on the TV, turn it on, and let the Apple TV restart. If it doesn't ask, it's already on and you can skip this step.

Apple only installs apps that are signed. Xcode does this for you; it just needs to know who you are.

1. In Xcode's left sidebar, click the blue Browser project, then select the Browser target.
2. Open the Signing & Capabilities tab.
3. Keep Automatically manage signing checked and choose your name under Team.
4. Change Bundle Identifier to something unique to you, for example com.yourname.tvbrowser.

1. At the top of the Xcode window, open the run destination menu and choose your Apple TV.
2. Press ⌘ R, or click the ▶ button.

The first build takes a minute or two. When it's done, tvOS Browser opens on your TV and stays on the Apple TV home screen.

• Move the cursor by swiping on the remote's touch surface, and click to open links.
• Double-click the touch surface to switch to scroll mode for long pages.
• Press Play/Pause to type a web address or search.
• Double-press Play/Pause for the side menu: tabs, favorites, history and settings.
• To watch a video full screen, press the full-screen button in the site's player. Want every video to open full screen when you click it? Turn on Side Menu → Video Playback → Enable Full Screen player.
• The ad blocker is already on. It takes a few seconds to prepare its rules on the very first launch.

After steps 2 to 5, you can build and install without opening Xcode again. In Terminal, inside the AppleTVBrowser folder, find your Apple TV's identifier:

xcrun devicectl list devices

Then build and install, replacing the placeholders:

xcodebuild -project _Project/Browser.xcodeproj -scheme Browser -configuration Release \
  -destination 'platform=tvOS,name=<Your Apple TV name>' \
  -derivedDataPath _Project/build -allowProvisioningUpdates build

xcrun devicectl device install app --device <device identifier> \
  _Project/build/Build/Products/Release-appletvos/Browser.app

If you cloned with Git, pull the latest code; if you used the ZIP, download it again. Then build and run as in step 6.

git pull

The ad-blocking filter lists ship with the app. To refresh them with the latest versions before building:

_Project/Scripts/update-content-blockers.sh

• The app no longer opens. With a free Apple ID, the 7-day signature has expired. Run it from Xcode again.
• The Apple TV doesn't show up in Xcode. Check both devices are on the same network, and keep the TV on the Remote App and Devices screen while pairing.
• Xcode shows a signing error. Make sure a Team is selected and the Bundle Identifier is unique to you.
• "Native Video Unavailable". The page didn't hand over a stream the native player can open. Start the video in the page first, then press its full-screen button.
• A site looks broken. Turn off the ad blocker for a moment (Side Menu → Content Blocking), or switch between desktop and mobile mode.

Still stuck? Open an issue on GitHub.