From AwkwardTV
Jump to: navigation, search


With a combination of hacks from this site, you can get a fully working web browser (Mozilla Firefox) working on the AppleTV. Firefox will be used using a USB keyboard and mouse plugged (via a USB hub) into


  • An SSH enabled AppleTV
  • An Intel Mac
  • A USB keyboard and mouse (with USB hub if not built into keyboard)


Enabling USB for keyboard and mouse support

If you do not have bspatch installed on your AppleTV (you have updated to v1.1) then copy bspatch and bzip2 from your Intel Mac onto your AppleTV and put them in the /usr/bin directory.

Patch the Kernel on your AppleTV to allow USB devices. You do not need to follow the instructions (loading kexts) for enabling USB Mass storage support unless you need an external USB storage device (hard drive, USB pen drive etc). The kernel patch is all that is required.

Installing System Prefernces

Install System Preferences onto your AppleTV. This is needed to enable the mouse pointer.

Enable the Mouse Poiner

Enable the Mouse Pointer on your AppleTV. The mouse pointer will only be visible if finder is not running (ie, only when you are running applications) so you don't need to worry about it being visible in the main AppleTV interface.

Install Firefox

Download the latest version of Firefox and copy the Firefox .dmg to your AppleTV.

ssh to your AppleTV and run the following commands

sudo hdiutil mount Firefox\
cp -r /Volumes/Firefox/ /Users/frontrow/Applications/

Install and Configure AwkwardTV Applications Menu

This can be done from the AwkwardTV menu if you patched your AppleTV with a patchstick

Configure the Applications Menu by editing the file /Users/frontrow/Documents/Applist.plist. Here is a copy of mine:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "">
<plist version="1.0">

The important part is running the firefox-bin file rather than firefox (it didn't seem to work on mine)


To run, Simply go to Applications from the main menu and select Firefox. After a few seconds Firefox will appear (if not, change the killfinder option to /true in the config file - see Applications Menu). After you quit Firefox, you will be returned to the main menu.


This procedure can be used to run any Apple application as long as dependencies are met. Presumably it works with Safari, but I haven't checked. Happy browsing! This guide was written from my AppleTV!

Adding Plug-In's (AppleTV)

Enabling things like flash and quicktime is actually fairly easy but you will need a few files. You can get the plugins off of a Leopard 10.5 install but you will need frameworks from 10.4. Also the needed frameworks are not in the Combo update, so you will need the install CDs or a booted OS 10.4 system.

Step 1:

Copy over any plugins from /Library/Internet Plug-Ins/*.plugin that you want to have. I have tested Quicktime and Flash and can confirm that they work. Note: You need the .plugin versions, there may also be .xpt plugins but these are for Firefox and will be of no use.

You will need to create a /Library/Internet Plug-Ins/ folder on the AppleTV and put the files there.

-bash-2.05b$ md5 /Library/Internet\ Plug-Ins/Flash\ Player.plugin/Contents/MacOS/Flash\ Player /Library/Internet\ Plug-Ins/QuickTime\ Plugin.plugin/Contents/MacOS/QuickTime\ Plugin 
MD5 (/Library/Internet Plug-Ins/Flash Player.plugin/Contents/MacOS/Flash Player) = f4f2bce6ee216e97ed48e649edd47191
MD5 (/Library/Internet Plug-Ins/QuickTime Plugin.plugin/Contents/MacOS/QuickTime Plugin) = e8265ff56537d905c9f0a8be8d2202f0

Step 2: Silverlight plug-in 2.0

pax -r -z -f /Volumes/Silverlight.2.0/Silverlight.2.0.pkg/Contents/Archive.pax.gz
sudo mv Library/Internet\ Plug-Ins/Silverlight.plugin/ /Library/Internet\ Plug-Ins/Silverlight.plugin
sudo chown -R root:wheel /Library/Internet\ Plug-Ins/
sudo chmod -R 755 /Library/Internet\ Plug-Ins/

You also need to copy all the following fonts from a mac to the appleTV:

/Library/Fonts/Arial Black.ttf
/Library/Fonts/Arial Bold Italic.ttf
/Library/Fonts/Arial Bold.ttf
/Library/Fonts/Arial Italic.ttf
/Library/Fonts/Comic Sans MS Bold.ttf
/Library/Fonts/Comic Sans MS.ttf
/Library/Fonts/Courier New Bold Italic.ttf
/Library/Fonts/Courier New Bold.ttf
/Library/Fonts/Courier New Italic.ttf
/Library/Fonts/Courier New.ttf
/Library/Fonts/Georgia Bold Italic.ttf
/Library/Fonts/Georgia Bold.ttf
/Library/Fonts/Georgia Italic.ttf
/Library/Fonts/Trebuchet MS Bold Italic.ttf
/Library/Fonts/Trebuchet MS Bold.ttf
/Library/Fonts/Trebuchet MS Italic.ttf
/Library/Fonts/Trebuchet MS.ttf
/Library/Fonts/Verdana Bold Italic.ttf
/Library/Fonts/Verdana Bold.ttf
/Library/Fonts/Verdana Italic.ttf
/Library/Fonts/Microsoft/Lucida Sans Unicode.ttf

Step 3:

Locate the proper CoreAudioKit Framework. I used the one off of my OSX 10.4.10 install disk. To extract this framework extract the /Volumes/Mac OS X Install Disc 1/System/Installation/Packages/Essentials.pkg/Contents/Archive.pax.gz archive and then copy ./System/Library/Frameworks/CoreAudioKit.framework from the archive to your AppleTV. Finally move the framework to our /System/Library/Frameworks Folder.

CoreAudioKit.framework can also be located in the 10.4u SDK included in XCode

-bash-2.05b$ md5 /System/Library/Frameworks/CoreAudioKit.framework/CoreAudioKit 
MD5 (/System/Library/Frameworks/CoreAudioKit.framework/CoreAudioKit) = 47410bdc321b62e7a1d6bc61f8d545

  • 17-10-07 - (Cybix) - I've managed to get Skype working using the exact same methods for Firefox. Only instead of copying the from a fresh mounted firefox image, I copied from a mounted Skype image. (from my Macbook Pro to AppleTV) Works great however haven't yet tested a voice call. more at