Sapphire Browser

(Beta 5 or later)

Using the collection folders the main menu, find the directory you wish to have Sapphire skip. Access the ‘mark menu’ by hitting the right arrow on your remote. Select “Mark this Directory to Skip Import”. If you don’t see the directory you wish to skip, make sure you are browsing in the “all” (red gem) view. See controlling sapphire browser if you aren’t familiar with these terms.

First make sure you have the latest version of Sapphire.

Your metadata file might have gotten corrupted. Deleting your metadata file and re-running “Import All Data” will resolve the issue.

• On your AppleTV
  • First follow steps 1-4 in the Sapphire Manual under installing Sapphire Manually.
  • Now we want to remove the metaData.plist file. Using the terminal type: “sudo rm -r /Users/frontrow/Library/Application Support/Sapphire/metaData.plist”.
• On your Mac
  • You want to remove the metaData.plist file. To do this, delete the “~/Library/Application Support/Sapphire/metaData.plist” from your home directory.

To uninstall Sapphire from your AppleTV:

• See steps 1-6 in the Sapphire Manual under installing Sapphire Manually.
• You may also want to remove the metadata and cover art. Using the terminal type: “sudo rm -r /Users/frontrow/Library/Application Support/Sapphire”.

To uninstall Sapphire from your Mac:

• See step 3 in the Sapphire Manual under installing Sapphire in Leopard.
• You may also want to remove the metadata and cover art. To do this, delete the “~/Library/Appication Support/Sapphire” folder in your home directory.

Sapphire has several importing methods.

• Populate File Data - Tells Sapphire to examine all files, and remember the file size, length and other information that can be gathered from the file itself.
• Fetch TV Show Data - Tells Sapphire that for every TV episode, gather more information about this episode from the internet.
• Fetch Movie Data - Tells Sapphire that for every Movie, gather more information about it from the internet.
• Import All Data - Tell Sapphire to do all of the above importers at once.

Any plugin displayed though the ATVLoader has to be approved by a site administrator as being the real deal. Sometimes it takes them a few days before they get the change to approve new submissions (updated versions).

Several TV shows have specials which are not part of the episode order, so a season and episode number can’t identify them. Sapphire gets around this by checking to see if the episode number starts with S (for special) and then doing a match on the episode title. This is contingent on TVRage containing the data (if it doesn’t, make and account and add it).

Some Examples (Only part following season/ep must match exactly):

• Battlestar.Galactica.S04ES1 Razor.avi (see Episode Listing)
• Doctor.Who.2005.3xS1 Time Crash.avi (see Episode Listing)

Yes - Sapphire lets the XML files override everything. This is a mechanism for you to change the data if you dislike what the import tools retrieved from the internet. Any missing data from XML files is filled in with data Sapphire collected from the internet or from the file itself. See the manual page for more details.

Yes - The solution is to join the two (or more) movies into a single file.

See: Advanced

The TV Show Virtual Directories are looking for their cover art in a different location.

Update: Beta 4.1 see Collection Art.

Most likely, Sapphire cannot write to the directory to store the cover art. Make sure the location where you stored your media isn’t mounted as read-only. The importer attempts to write posters and episode art to the directory structure, and so if it were read-only, then it will fail to write anything. You will have to mark them to re-import.

See: Advanced