How to install a web browser on Apple TV

By , Nov 6, 2015

tvOS Web Browser Apple TV

Sideloading the tvOSBrowser that we reported on earlier is easy, it just takes a bit of massaging to make it all work. You’ll need to be familiar with our standard sideloading tutorial for sideloading apps, but there’s one additional step that you’ll have to take before it all comes together. In this tutorial, we’ll show you all that’s involved in a hands-on step-by-step video.

Step 1: Use our sideloading tutorial to sideload the tvOSBrowser on your Apple TV

The build will fail, and you will encounter an error that states: ‘UIWebView’ is unavailable: not available on tvOS

Step 2: Open the Applications folder

Step 3: Right click on Xcode.app and select Show Package Contents

Step 4: Open Developer →  Platforms → AppleTVOS.platform → Developer → SDKs → AppleTVOS.sdk → usr → include

Step 5: Double click Availability.h to open in Xcode

Step 6: Find the following lines:
#define __TVOS_UNAVAILABLE __OS_AVAILABILITY(tvos,unavailable)
#define __TVOS_PROHIBITED __OS_AVAILABILITY(tvos,unavailable)

Replace those lines with:

#define __TVOS_UNAVAILABLE_NOTQUITE __OS_AVAILABILITY(tvos,unavailable)
#define __TVOS_PROHIBITED_NOTQUITE __OS_AVAILABILITY(tvos,unavailable)

Step 7: Save your changes to Availability.h

Step 8: Try to rebuild the tvOSBrowser using the Play button in Xcode, and it should build successfully

Step 9: Find the tvOSBrowser app icon on your Apple TV and start browsing the web on your TV

It’s really a simple thing to do, and takes about 5 minutes, if that, from beginning to end. If you want a browser on your Apple TV, this is one way to do so.

This browser is very basic, but the original developer, Steve Troughton-Smith, is hoping that others take the foundation that he has laid and build on it.

As of now, here’s what you can do with the browser:

  • Tap on the center of the touch area of the Apple TV Remote to switch between cursor & scroll mode.
  • Click the touch area to click.
  • Menu will navigate back.
  • The Play/Pause button will let you input URLs (no fuzzy matching or auto-search).

Have you tried the tvOSBrowser on your Apple TV? If so, what did you think about it?

  • Share:
  • Follow:
  • Unknow Unknow

    That why Apple TV doesn’t has internet browser too complicated and pointless

    • Merman123

      I don’t know. If I could at least use the remote app to type addresses I might use an internet browser on it.

    • QuarterSwede

      It’s not pointless. This will enable you to login to hotel wifi when they use a login page the AppleTV can’t otherwise access. It’s even easier if you use the forked version for cursor control.

  • kurt

    Says I do not have permission to change the file because I do not own it.. Whats the deal with that?

  • Tl;dr

  • any body install kodi in the new apple tv4?

    • Collin

      Is that possible?

  • Steve

    tried this and for me wont work when I go to Availability file to edit those lines it says the file is locked and says I’m not the owner so wont let me unlock it.

    • lukemul69

      Getting the same result… I searched all over google with no result.

      • Kerry Kozma

        hey guys please check out my videos on youtube on how to fix this. search Nandor690 on youtube and I have Apple TV 4 videos for provenanceTV and tvOS Browser

      • Latif

        you need to have a developer account with apple to solve this problem which is not free its 99$ a year

      • lukemul69

        I have a developer account which I pay $99 for every year…. I managed to solve the issue days ago. The developer account was not the issue in this case.

    • Anonymous

      You need to sign it with your own “name”. Watch jeff side loading artical.

      • Steve

        Am logged in with own name..

      • lukemul69

        Tried that – doesn’t work.

      • QuarterSwede

        Not only that but you have to change the bundle identifier name to another unique one. Otherwise, it’ll refuse to build. So instead of “com.[devsname].tvbrowser” you need to make it something like “com.QuarterSwede.tvbrowser”

    • Madarä Uchíha

      best way to edit the availability.h file is to do a sudo nano on terminal and edit it on terminal . thats what i did when i got the locked message

      • lukemul69

        Tried the sudo method before I tried anything else didn’t work for me.

    • Kerry Kozma

      I have videos on my youtube channel showing you how to fix these errors. Check out my channel if you would like. Search Nandor690. My videos are specific to fixing error problems when trying to install these github apps on AppleTV 4

    • ProSzakal Aszakal

      Simply fix is just copy the file to desktop and then you can edit and save, after delete original file and copy edited file from desktop to the right place…

  • JayDee917

    So. Many.. Apple… TV…. Posts…..

    • Marcus

      Lol, Apple TV rumors have been going around for 3-4 years. Everyone is excited 🙂

  • Don’t forget the iOS apps Airbrowser and AirWeb; lots of features like bookmarks; pinch and scroll; and they Airstream to the TV from the iOS device. Voila ; TV browser

  • Lemerio P.

    I laughed so hard when I heard how many times you had to “then double-click” in the video. Lol anyways… I would try this if I had the latest Apple TV.

  • fernando rivera

    I can edit the file telling me that Is lock. and I need to unlock the file

  • Shami

    HELP !!!!! He writes “Could not add write permission to the file because you do not own it. Try modifying the permissions of the file in the Finder or Terminal.”
    What to do??

    • Bryan C

      klk

  • Bryan C

    While it was a fun little hack, I deleted the app within 10 about minutes playing with it. while it was stated that the app is very basic, it wasn’t made clear how basic. The cursor is difficult to control, videos won’t play and you can’t even input text into entry fields to search content on websites. The only thing this browser is good for is clicking links, nothing more. still neat though.

  • Bryan C

    While it was a fun little hack, I deleted the app within 10 about minutes of playing with it. While it was stated that the app is very basic, it wasn’t made clear how basic. The cursor is difficult to control, videos won’t play and you can’t even input text into entry fields to search content on websites. The only thing this browser is good for is clicking links, nothing more. still neat though.

  • GilMark F Sanchez

    I have AppleTv 3rd Gen is it possible to install web browser? I saw you are using AppleTv 4th Gen.

  • solomani

    This is useful, especially if you take you ATV to a hotel and want to stream since most hotels have a web-gateway you need to log into first which ATV cant connect to by default.

    I noticed I cant see my ATV in XCODE device list since upgrading to Sierra. Anyone else having issues?

    • Keith S

      While I realize not everyone owns a mac or iOS device, airplay is a FAR easier solution for those that do.

      • QuarterSwede

        Not when you use your iOS device while watching TV like a lot of people. Not everyone travels with more than one iOS device.