Sapphire
Feed your addiction – Your AppleTV & Mac just got better.
  • Sapphire Installation Instructions (1.0b5)

    • To install Versions of Sapphire B4 – B6.1 See installation instructions:


  • Sapphire Installation Instructions (1.0b4.x)

    • See installation instructions:
    • With the addition of the “Mark to Clear Metadata” it is highly recommended that you make a backup copy of your “~/Library/Application Support/Sapphire” folder.
    • If the Collection Art folder is missing you will need to re-run the import tools to get Sapphire to build it.
      • First use the mark menu to mark your files to be refetched.
      • Then run the import tools.


  • Installing Sapphire Manually

  • These instructions are intended to be used to install Sapphire Manually on your AppleTV. You will probably only need to do this if Sapphire is unavailable through the ATVLoader (it takes a little while for new versions to get approved by AwkwardTV to be listed).

    -WARNING- READ THIS TUTORIAL FIRST. If you are not confident in what you are going to be doing PLEASE DON’T PREFORM THIS TYPE OF INSTALLATION and wait for the ATVLoader to be updated.

    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.


  • Sapphire Installation Instructions (1.0b4)

    • If you haven’t already patched your AppleTV or are new to the community consider using AwkwardTV’s Beginner’s Guide.
    • Download the Sapphire Plug-in here or through the AwkwardTV’s ATVLoader.
    • If Sapphire is unavailable on the ATVLoader here are some instructions on how to install Sapphire Manually.
    • Restart your Apple TV (restart Finder)
    • Access the Sapphire main menu using your Apple TV.
    • Go to the Settings Menu and select “Hide Collections”. This menu will let you choose which folder paths will be available from the main menu. Note that hiding a folder path doesn’t stop the import tools from looking for files there.
    • Also inside the Settings Menu, select “Don’t Import Collections”. Checking folder paths in this menu will tell the import tools which folders to skip.
    • From the Main Menu, selecting “Import All Data” will run all three import tools simultaneously. However, if you choose to run the import tools separately (through the Settings Menu), it is strongly recommended that you use “Fetch TV Show Data” before using the “Fetch Movie Data” tool. This will allow the movie importer to skip files already discovered to be TV Shows. See the Sapphire File Formats if your files aren’t successfully being imported.
    • Be patient. The import tool(s) can take a considerable amount of time depending on how many files are in your collection. During testing, a fresh import on ~1 Tera byte worth of TV Shows & 200+ movies took about 20 minutes. If you are running the import(s) for the first time, you will want to stick around to select titles & movie posters for your collection. The import tool(s) will be a bit slower if you are using the airport (wireless connection).
    • Once the import has finished, you might want to tag the TV episodes you have already watched, or tag your favorites. The best way to do this is to select TV Shows from the main menu. Once you have found a directory or file you wish to “Mark as Favorite” or “Mark as Watched”, press the right arrow key to bring up the Mark Menu. Select the appropriate mark operation by pressing the Play/Pause button.
    • Enjoy your fully personalized TV Show & Movie virtual directories packed full of episode and movie information! To switch between Unwatched , Favorite and Browse menu views simply push the left arrow key.

  • Controlling Sapphire Browser

  • On the AppleTV:

    With beta 4 we have changed the way the Apple Remote interacts with Sapphire. Specifically the left and right arrow buttons now have dedicated tasks while using the browser.

    Sapphire Remote

    In Leopard:

    The Apple remote will respond exactly the same as it does for the AppleTV (See above). In addition to the remote, you can use the keyboard to control Sapphire with the following keys:

     

    To Select, Play or Pause use:

    Return -or- Space Bar

    To go back (same as hitting the menu button on the remote):

    ESC

    Toggle View:

    Left Arrow ( <– )

    Mark Menu:

    Right Arrow ( –> )

    Move Selector UP:

    UP Arrow

    Move Selector DOWN:

    DOWN Arrow

     


  • Installing Sapphire Browser in Leopard

  • Sapphire will now run on any (Intel or PPC) Mac running Leopard.

    This information has been moved to the Sapphire Manual

    See: Installing Sapphire in Leopard


  • Sapphire Installation Instructions (1.0b3.1)

    • If you haven’t already patched your AppleTV consider using AwkwardTV’s Patchstick.
    • Download the Sapphire Plug-in Here or through AwkwardTV’s ATVLoader.
    • Unzip and place the Sapphire.frappliance folder inside the directory: /System/Library/CoreServices/Finder.app/Contents/PlugIns/ (on your Apple TV’s OSBoot partition).
    • Restart your Apple TV (restart Finder)
    • Access the Sapphire main menu using your Apple TV.
    • Go to the Settings Menu and select Populate Show Data. This import tool will go through your /frontrow/Movies/ directory collecting file information (size, duration, audio & video format) used when browsing through Sapphire. ATVFiles XML files will also be imported with this tool.
    • Be patient. The import tool can take a considerable amount of time depending on how many files are in your collection. During testing, a fresh import on ~1 Tera byte worth of TV Shows took about 5 minutes. The import might be slower if you are using the airport (wireless connection).
    • Once the import has finished, you might want to tag the files you have already watched, or tag your favorite files. The best way to do this is to select Browse Shows from the main menu. Once you have found a directory or file you wish to “Mark as Favorite” or “Mark as Watched”, use the right arrow to toggle to the Mark mode. Select the file/directory and mark appropriately. To toggle back into “Select” mode hit the left arrow.
    • If you would like to fetch TV Episode information for your media collection, this would be a good time to run it. Sapphire fetches episode information from TVRage. To do this, go to the Settings menu and select Fetch TV Data. While this tool is running it will ask you to select from a list of TV show titles to match the current file being processed. See the Sapphire File Formats if your files aren’t successfully being imported.
    • Enjoy your fully personalized Unwatched and Favorite Shows menus packed full of Episode information!