TVNZ On Demand Apple TV

TVNZ and TV3 On Demand on Apple TV

New Zealand Apple TVMy wife watches more on-demand shows than broadcast tv but she has to watch it on her 13″ MacBook rather than the 30″ tv on the wall. Being the wonderful husband I am, I set about on a little geek DIY mission to get TVNZ and TV3 on demand playing through our Apple TV.

It was a lot harder than I thought and quite a few people asked how I pulled it off, so here’s the lowdown, if you give this a try yourself, please leave a comment about how you got on :)

What You’re Going to Need

Update your Apple TV

Update your Apple TV to the latest official version. In theory this means just using the built-in update feature on the Apple TV itself but if that doesn’t work (like it didn’t for me) then:

  1. Download the latest (in my case v4.2.2) firmware file to your computer.
  2. Connect your Apple TV to your computer via USB.
  3. Open iTunes, choose the Apple TV from the left menu.
  4. Option-click Restore to choose a custom restore file (the one you downloaded).

Jailbreak your Apple TV

Don’t be scared of this, it’s legal, doesn’t void warranty, your usual Apple TV menus are there (but with a few extras) and you can always roll back using the above step if you change your mind. There are various options for jailbreaking but since we’re going to install aTV Flash as our operating system, let’s use the jailbreak software that they’ve built themselves. It’s called SeasOnPass, it’s free, just follow the official instructions and you’ll be fine.

Of course it wasn’t that easy in my case, it kept failing at the “Restoring in iTunes” step. Perhaps it’s because I had a beta version of iTunes, who knows. Before it stalled, the SeasOnPass installer did download an IPSW setup file, my solution was to find this file (just search for “.ipsw” to find yours) and then do the same workaround as above for updating via iTunes but choose this new IPSW file instead of the official v4.2.2 file.

Install aTV Flash

This was fairly painless (apart from the $20), just run the aTV Flash installer on your Mac and you are ready to fire up your Apple TV with some new menu options.

Enable XBMC

Again, this was fairly painless, just go to the new Maintenance menu > Manage Extras > XBMC. It’ll need to download and activate, after a restart you’ll see a new XBMC item in your menu. Unfortunately XBMC is a whole new operating system and the Apple TV will restart before and after you activate it, but it doesn’t take too long. XBMC isn’t as pretty or slick as the native Apple menus but it gives us an operating system that can handle NZ On Demand media.

Install the NZ OnDemand plugin

I’ve been told by others that with some versions of XBMC you can just find an “NZ OnDemand” add-on in the menus but I couldn’t find it. So here’s my workaround:

  1. Download the NZ OnDemand plugin manually (that link goes to a folder, grab the latest zip).
  2. Copy the zip file to your Apple TV somewhere, I used the free Cyberduck app. Open the app, choose Open Connection, choose SFTP/SSH as the connection type, use the Apple TV’s IP address as the Server, username is “root” and password is “alpine” by default. It doesn’t matter too much where you put the zip file, I went with /private/var/mobile/Updates/
  3. Choose System > Settings > Add-ons > Install From Zip File. Click on Home Folder (your only option) then Updates, then our file.

Watch NZ On Demand

Phew, so finally we can now choose NZ OnDemand from our Video > Add-ons menu. Each of the providers have slightly different menu structures for browsing videos but if you’ve got this far it won’t take you long to get the hang of it. Enjoy!


Please feel free to leave your success stories, corrections or alternate solutions in the comments below.

31 thoughts on “TVNZ and TV3 On Demand on Apple TV”

  1. Hi Andrew

    I got as far as downloading the NZ on Demand zip- it came as a folder . I uploaded the folder to apple TV – could find the folder going into xbmc – install from zip file – could find the NZ on Demand folder – but as I opened each folder in it there was nothing that allowed me to click OK. Any ideas. Is there a specific file in the Zip folder I should upload. Any suggestions appreciated.



    1. You’ve done well to get that far, so close! XBMC will only let you choose a .zip file so the file you download needs to remain as a zip. If you’re on a Mac sometimes it will extract zipped downloads to a folder automatically which you don’t want, however you could re-zip it if needed. Let me know how you get on!

  2. Has anyone tryed anything like this with a WD TV Live media player? Would be ideal if it was possible, but not savvy enough to work it out myself!

  3. Thanks for the guide, I have the plugin installed but get a script error when trying to bring up most popular shows in the TVNZ on demand section.

    Any suggestions?

    1. My AppleTV is unplugged at the moment (just got it back from my parents!), I’ll try and take a look at this on the weekend. It could be that the TVNZ site feed has changed and the plugin needs a corresponding update.

  4. Hello – just found this by googling. I have it all working but only TV3 streams. The TVNZ one will call the listings under “All Shows”, but none of the other categories such as “Most Popular”. After listing the shows, each show sub-folder is empty, and there is nothing to play. Any further ideas? Who is the clever person who designed the plugin? I wonder if they will update it?

    1. Yeah it’s a bit rocky at the moment. looks like TVNZ have changed their feed, hopefully I’ll have a chance to look at it over the Christmas break but ideally the original developer will release an update *fingers crossed* :)

  5. A kiwi in the US looking for a descent new bulletin. Plug-in installed just fine, but same script error that Kyle got on TV3. Parliament worked just fine – hope you can fix it. cheers

  6. Hi

    Does the AppleTV work if you have a non-mac computer? Interested in streaming TV on Demand and You Tube on our TV and found this blog as we are trying to figure out the best way to do it. Someone suggested a Play Station 3, but this seems a far more economical solution! Thanks.

    1. Yes you can use an Apple TV with Windows, it syncs via iTunes which will work on both platforms. As you’ll see from the other comments the OnDemand support is a little sketchy but YouTube is pretty smooth, especially if you have an iPhone you can use as your remote (much easier to type searches from your phone than the Apple TV standard remote :)

  7. Great help – thanks. Was looking around for where to find the On Demand stuff and not having much luck, but this worked a treat (obviously TVNZ doesn’t work but that seems known).
    Also, I did not have or need to have aTV Flash installed, works without it okay.

  8. Hi Andrew.
    Cheers for your hard work mate, dont think my family is ever going to watch traditional t.v animore.

    hows the plugin for isky coming along. I have an isky account and wanted if you needed any help with building this plugin.willing to help out in any way I can if you need it.Im not a py programer but will give it a go. really keen on this plugin just for my sports channel and should seal the deal for my HTPC. will make a donation if you get this going. :-)

  9. I second the iSKY script – let’s raise some cash for Mark Honeychurch (mark.honey) to do his magic and fix TVNZ while he’s at it… iPad 3 ought to do it??

    Who wants to SPEARhead the attack? Anyone?

    (P.S. thanks for the clear instructions Andrew)

  10. Following this thread, it is not altogether obvious if you can watch TVNZ, or just TV3. Has the TVNZ problem been fixed (and by whom)? Is it likely to get fixed? Is it a good idea to get an Apple TV with the express purpose of watching TVNZ Ondemand?

    1. Hi Peter. When I wrote the article TV3 and TVNZ were working, then we lost TV3, but I have heard that it is working again! TV3 changed the way they feed the show data but the latest plugin (linked to in the article above) was updated one week ago and now supports TV3 again.

      If the only reason you are buying the aTV was to watch NZ onDemand you might be disappointed, I get lower quality reception on the aTV than I do on my computer and as you can see from these comments, things can go wrong! But why not pick up an aTV on TradeMe and if it doesn’t work you can always resell it for a similar amount?

      PS – Another plus for the aTV is that the latest software update lets you stream any content from your iPad and iPhone to your TV. If TV3 or TVNZ ever bring out an iOS app then you could stream it to your TV that way.

      1. Thanks Andrew,

        We actually use Tivo to do about 90% of our viewing in time shift mode. We also have a satellite set-top box/hard-drive to give us the option of picking up a third simultaneous program as well as the SBS channels (used to get the Channel 9 ones as well till they went off air just before xmas).

        What we were looking for was to seamlessly add TVNZ Ondemand (and TV3) into the mix.

        My children in Australia get the equivalent with an out-of-the-box Sony Blu-ray player.


  11. Hi,

    I followed your excellent instructions and it worked first time. I have patched my PC before with the free Patchstick but splashed out on fire core this time and well worth the money. I too can only get TV3 and 4 to work and it does appear that the TVNZ is not available. I would too love to be able to see TVNZ feeds on my TV rather than watching them on my Mac.

    Has anyone tried the firefox and flash add ons for ATV and got TVNZ ondamand working that way?

    1. That would be awesome! The platform has been very underutilised by Apple, hopefully this is a sign that they’re going to put more focus on this device in the future.

  12. Hi,

    Awesome work with the plugin.

    Any idea when you will update tvnz on demand? So that will work again.

    Having an isky plugin would be awesome

  13. Hi Andrew,
    Have got the zip file downloaded to ATV but when i go to install from zip file I get the NZ on demand plug in but nothing that says update, if I click on tehe zip file I get a language file come up. What am i doing wrong?

  14. with limited geek know-how I happened upon this site, awesome!
    I have been looking into buying a media player but I haven’t been able to get a definite answer on whether or not we can watch all the NZ ondemand channels?
    I’m getting the impression from previous posts that we can’t.
    Is that the case?

  15. Hi Andrew

    I’m really keen to jump in and set up Apple TV as per your instructions above. Just one question – Are the instructions still relevant?

  16. Hi all. Fancy my excitement when I stumbled upon this thread. I’d love to give this a go but wonder the same as Craig (above). I have 3rd Gen Appletv and have heard that you are not able to jailbreak these. Thanks in advance.

    1. Hi there, I subscribed to thinking that ATV3 could be broken, but have been advised that it’s still weeks/ months away. Also have to pay more for the TvFlash but again can’t use until ATV3 is jail token, very frustrating.

  17. Thanks for the latest round of questions folks. I am not actually running a jailbroken Apple TV anymore so I’m not sure if it’s possible to jailbreak the latest version. Originally I only jailbroke my ATV to access TVNZ and TV3 on-demand but I have since moved on to using Netflix and Hulu for 100% of my TV (I haven’t seen any NZ TV broadcasts in over a year now).

    If you are really keen to get the NZ services on your ATV then please put aside an afternoon and see if you can work it out. Then please come back here and let us know how you got on.

    Personally I’d highly recommend ditching the NZ providers completely and going for Netflix and/or Hulu, it’s so much easier and there are much better shows. Perhaps I’ll do an article on that some time, but in short you’ll just need an American IP address which you can get seamlessly from Slingshot and Orcon recommends using a third party.

    Happy online TV-ing everyone!

  18. American IP address! That’s the ticket ahy. I was becoming all despondent wit ATV and not being able to use Netflicks. I’ll give that a go. Thanks for all your advice.

Leave a Reply

TVNZ On Demand Apple TV