Installing Sapphire Manually

These instructions are intended to be used to install Sapphire Manually on your AppleTV.  There are two different methods for installation.  The first is using the installer, and the second is through manual installation.

Installer

1. We need the IP address for the AppleTV – to find it go to the AppleTV’s Menu and select Settings -> Network. For these instructions we will assume the IP Address is 192.168.100.100.
2. We need to make sure SSH is enabled. To turn it on, go to the Awkward TV plugin and select the SSH Service button. The button will say “SSH Service Enabled” when it’s turned on. This step only applies to the original ATV software, not updated versions.
3. Now we need to SSH into the AppleTV. Using the terminal* type: “ssh -1 frontrow@192.168.100.100”. Remember to use your AppleTV’s IP Address.
4. The password is “frontrow”
5. Now we need to get the new version on the AppleTV. From your computer, copy the installer file on to your AppleTV’s frontrow partition. Use an SFTP program, to transfer to the IP address found above
6. Now execute the installer; type “sh ./Sapphire-1.0b6.3.sh” Change the version number to match the file you downloaded
7. It may ask for a password.  It is “frontrow”.  It should then complete installation and restart Front Row for you.

Manual Installation

There is now a tutorial on iClarified you can use for reference when following the steps below.

-WARNING- READ THIS TUTORIAL FIRST. Under no circumstances attempt this installation if you use windows.  Windows cannot extract the zip file correctly. If you are not confident in what you are going to be doing PLEASE DON’T PREFORM THIS TYPE OF INSTALLATION and use the installer.

1. We need the IP address for the AppleTV – to find it go to the AppleTV’s Menu and select Settings -> Network. For these instructions we will assume the IP Address is 192.168.100.100.
2. We need to make sure SSH is enabled. To turn it on, go to the Awkward TV plugin and select the SSH Service button. The button will say “SSH Service Enabled” when it’s turned on.
3. Now we need to SSH into the AppleTV. Using the terminal* type: “ssh -1 frontrow@192.168.100.100”. Remember to use your AppleTV’s IP Address.
4. The password is “frontrow”
5. Now we need to make sure we can write to the OSBoot volume. Using the terminal* type: “sudo mount -uw /”. Again, the password is “frontrow”.
6. Now our AppleTV is ready for an install. If you already have a version of Sapphire Installed we need to remove it. Using the terminal* type: “sudo rm -r /System/Library/CoreServices/Finder.app/Contents/PlugIns/Sapphire.frappliance”.
7. Now we need to get the new version on the AppleTV. From your computer, copy the Sapphire.frappliance folder on to your AppleTV’s frontrow partition.
8. Now we need to move the Sapphire.frappliance folder from the frontrow partition to the OSBoot partition. Using the termianl* type: “sudo mv ~/Sapphire.frappliance /System/Library/CoreServices/Finder.app/Contents/PlugIns/”
9. Almost done! we just need to reload the AppleTV’s UI. Using the terminal* type: “sudo reboot”.
10. Wait for the AppleTV to reboot.

* To open a terminal window type “Terminal” into spotlight – it will be the top hit.