From AwkwardTV
Jump to: navigation, search

This article briefly describes how Elgato EyeTV can be launched on Apple TV.

It is entirely possible to use EyeTV software with a USB TV-tuner to turn the Apple TV into a live-tv tuner and video recording device (DVR).

EyeTV 3.0.2 succesfully runs on ATV Take 2 (2.0.2 - 2.1 and 2.2 (but remote does not work))! EyeTV 3.0.3 and up doesn´t work they need leopard.


  1. SSH enabled ATV
  2. NitoTV installed
  3. USB enabled (use nitotv smart installer)
  4. USB TV Tuner compatible with EyeTV

Initial EyeTV Installation

(based on http://www.rhyme.it/2008/05/01/appletv-eyetv-recordertv/)

  1. Attach the USB TV Tuner to the ATV
  2. Switch on your ATV. Select NitoTV. Play any file.
  3. While the movie is playing, via VNC or with a usb keyboard, press “f”. This should toggle mplayer’s fullscreen mode.
  4. Press pause on your remote.
  5. Via an ssh session upload the EyeTV installation program (EyeTV*.dmg)
  6. Mount it (sudo hdiutil mount EyeTV.dmg), and mount aptv in write mode (sudo mount -uw /)
  7. Copy the whole folder EyeTV.app to ~/Applications/
  8. Start it (open ~/Applications/EyeTV.app) At this point, you should see the welcome screen of Elgato.
  9. Complete the installation.
  10. Exit EyeTV (use command-Q or mouse)
  11. When finished, simply reboot aptv. (sudo reboot).

You should now have EyeTV installed

I recommend setting EyeTV to startup in full screen menu - in EyeTV menu select Preferences in the Full Screen section check Start EyeTV in full screen

Note: don't copy over a pre-installed copy of EyeTV.app - it will not work. You need a fresh (uninstalled) copy of EyeTV.app

Add EyeTV entry to AppleTV menu

You can now access EyeTV from NitoTV application menu.

If you are using NitoTV tell EyeTV to display on screen menu when you press the remote menu key twice, press and hold menu key to access EyeTV's on screen menu (this is the default EyeTV setting):

 defaults write  com.elgato.eyetv "apple remote menu button behavior" -int 0 

an alternative to NitoTV is to use iScripts, however nito is better since it will let you use the remote control to exit EyeTV so you can work entirely keyboardless (with iScripts you need a keyboard)

Install iScripts Write the iScript configuration file (or edit using your favorite editor)

cat <<EOT > ~/Documents/Scripts/apps.plist 
<?xml version=”1.0″ encoding=”UTF-8″?>
<!DOCTYPE plist PUBLIC “-Apple//DTD PLIST 1.0//EN” “http://www.apple.com/DTDs/PropertyList-1.0.dtd”>
<plist version=”1.0″>

If you are using iScripts tell EyeTV to display on screen menu when you press the remote menu key once:

 defaults write  com.elgato.eyetv "apple remote menu button behavior" -int 1 

also an "alternative" is to use the XBMC launcher just add:

	<string>/Library/Application Support/EyeTV/EyeTV Helper.app/Contents/MacOS/EyeTV Helper</string>

to /System/Library/CoreServices/Finder.app/Contents/PlugIns/XBMCLauncher.frappliance/Contents/Info.plist

but here is the same problem to quit like at iScripts

Launch EyeTV

You can now launch EyeTV using NitoTV or iScripts.

You can navigate using the AppleTV remote control (and also using the remote control supplied with your TV Tuner card)

I haven't found a way to quit EyeTV using the remote from iScripts, you will need to use your keyboard to send command-Q for now unless you are launching from NitoTV application menu.

Both LiveTV, recording, EPG and scheduling work very smoothly!

You can also use RemoteBuddy to Quit EyeTV but it can't use the build in remote receiver only the EyeTV remote receiver build in the Stick (tested with EyeTV Diversity) And you can use it only 30days of the testperiod because regestration doesn't work... perhaps anyone get's it done :)

Compatible TV Tuners

The following TV Tuners are known to work with AppleTV (please add your Tuner card if it works!)

  • Pinnacle PCTV Hybrid Pro
  • Elgato eyetv Diversity
  • Elgato eyetv hybrid
  • Pinnacle DVB-T Stick
  • Terratec Cinergy S USB
  • Twinhan Alpha Mac
  • Miglia Mini TV
  • Freecom DVB-T USB
  • ATI TV Wonder USB 2.0
  • Hauppauge WinTV-HVR-950
  • Plextor ConvertX PVR TV402U


PyeTV is an open source frontrow plugin that allows access to EyeTV from the frontrow menu.

It is not yet available for the ATV, although it should be relatively simple to port it over to the AppleTV.