Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Imports Apple iPhoto and Aperture libraries into XBMC. Creates Events, Albums, Faces, Places, Keywords, and Ratings listings.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Type||Name||Latest commit message||Commit time|
|Failed to load latest commit information.|
iPhoto plugin for XBMC ====================== This plugin imports an iPhoto or Aperture library into XBMC. After importing, you will see categories that correspond with their application counterparts: * Events/Projects * Albums * Faces * Places * Keywords * Ratings Your photo library can reside locally (on the machine on which you run XBMC) or can be located on a network share. Configuration ============= The plugin needs to know where your AlbumData.xml file is. If you haven't explicitly pointed iPhoto to a non-standard library location, the default of "~/Pictures/iPhoto Library" should work fine. Otherwise, please enter in the correct path in the plugin's settings dialog. Note that there is no default path if you're using Aperture. You will need to specify the path to the library that contains the ApertureData.xml. Aperture can support multiple libraries, but this plugin currently only supports one. ALSO NOTE: Aperture will ONLY generate the required ApertureData.xml if you have enabled "Share previews with iLife and iWork" in Preferences->Previews. The iPhoto plugin can also be configured to ignore certain album types. It is currently hard-coded to ignore albums of type "Book" and "Selected Event Album," but you can choose to ignore also: * Empty -- albums with no pictures. * Published -- MobileMe Gallery albums. * Flagged -- albums flagged in your photo application's interface. * Keywords -- any photos with these keywords will be hidden. All of these album types are ignored by default. If you select "Auto update library", the plugin will compare the modification time of your Library's XML file with its current database and update the database automatically on start. This is disabled by default, but is probably what you want after testing the plugin. You can also choose the view style for albums if you're using select skins. In Confluence, you may set this to "Image Wrap" or "Pic Thumbs". In Metropolis, you may set this to "Galary Fanart" or "Picture Grid". In all skins, if you choose "Default," it will preserve whatever view mode you have chosen in XBMC for each album; otherwise, it will force the view style to the one selected here. Referenced and Managed Libraries ================================ iPhoto and Aperture give you the option of managing your photos for you, by placing a copy of them within the library itself, or referencing your originals, leaving them in their original location on the filesystem. If your library is managed, you will select "Managed Library" in the plugin settings (this is the default). If your library is referenced and you are running XBMC on the same machine that you use iPhoto or Aperture, you may also select "Managed Library". If your library is referenced and resides on a share over the network, you need to tell the plugin how to access the originals. If on the machine you use iPhoto or Aperture your originals are accessed via, for instance, "/Volumes/Media/Pictures", they may not be mounted at the same point on the machine on which you run XBMC. If this is the case, you will need to configure the "Local root path to masters" and "Rewrite root path as" options. About Places support ==================== If the plugin is configured to support the Places feature of iPhoto or Aperture, it will parse the latitude/longitude pairs in the library and look up the corresponding addresses using Google. If Google reports one or more businesses near the coordinates, the plugin will use the name of the nearest business for the address to show in the Places category. Otherwise, the street address will be used. In both cases, the post code and country identifier are appended to the result. The Places feature can also download map images to display while you're browsing the Places category. Normally, you won't need to do anything to get this feature, besides enabling it in the plugin configuration. But, if you import your library many times within one day, Google may block you from retrieving map images. If you receive a map image with a red X over it, the plugin won't re-download the map until you clear the map image caches. You can do so by selecting "Remove cached maps" from the context menu of the Places category. Translations ============ If you'd like to help translate this plugin to another language, please send a patch to jingai at floatingpenguins dot com. If possible, patch against the most recent version at: http://github.com/jingai/plugin.image.iphoto Known Issues ============ * Keywords are not supported in iPhoto 9.4 and all versions of Aperture. See http://github.com/jingai/plugin.image.iphoto/issues/4 * Ratings are not supported in Aperture. See http://github.com/jingai/plugin.image.iphoto/issues/6 * Selecting previous picture sometimes erroneously selects next instead See http://trac.xbmc.org/ticket/11826 * Can only set default view mode in select skins See http://trac.xbmc.org/ticket/9952 Assistance ========== If you need help getting the plugin to work, please visit my thread on the XBMC forums: http://forum.xbmc.org/showthread.php?t=77612 Or the addon website at: http://www.floatingpenguins.com/plugin.image.iphoto/ When asking for help or reporting a potential bug, please be prepared to post your debug log from XBMC and, if you don't mind, your AlbumData.xml from your iPhoto library or ApertureData.xml from an Aperture library. Remember to remove any private information from all files before posting them. For iOS platforms (AppleTV2, iPhone, iPad, etc) please read: http://forum.xbmc.org/showthread.php?t=92480 For Mac: http://forum.xbmc.org/showthread.php?t=47124 For Linux: http://forum.xbmc.org/showthread.php?t=34655 For Windows: http://forum.xbmc.org/showthread.php?t=42708 Credits ======= jingai (jingai at floatingpenguins dot com) Original code: - Anoop Menon - Nuka1195 - JMarshal Icons: - Firnsy - brsev (http://brsev.com#licensing)