Add-on:Vimeo

= Introduction =


 * In order to use this plugin you will need the latest stable Dharma 10.0 release of XBMC. Older versions will not work.*

This project is a plugin for the open-source media center XBMC, that enables XBMC to interface with Vimeo.

Features

 * Non-intrusive user notifications
 * Video thumbnail browsing for a more pleasant user experience
 * Searching (including locally cached searches)
 * Explore Vimeo feature allowing casual browsing of Vimeo from your couch.
 * Adding and removing "likes"
 * Listing a users "likes"
 * Joining or leaving a group
 * Listing a groups videos
 * Subscribing and Un-subscribing to channel.
 * Authorize plugin access to user data on Vimeo from within plugin only
 * Listing a channels videos and listing all new subscription videos
 * Listing a contacts uploads, albums, groups, "likes" and channel subscriptions
 * Plays videos that can't be embedded

Browser extensions
Adds a "Play in XBMC" button under vimeo videos.

Some embeded videos will also have a "Play in XBMC" button, these may be badly placed.


 * Firefox extension
 * Chrome extension

= Known problems =
 * One of the main features of the plugin is that it defaults to thumbnails view for video items. This only works when using the default "Confluence" skin as the plugin is dependent on the Id defined for confluences thumbnails view.
 * It's currently impossible to search for a contact, and therefore not possible to add or remove a contact from withing the plugin. This is a limitation of vimeo's underlying API, Add or remove contact may be added in future, but searching will only be possible if vimeo add's this to their API.
 * It's also impossible to refine a search and limit it to a specific user, channel or group, again this is a limitation of Vimeo's API.
 * The plugin uses Vimeo Oauth API, and thus requires a synchronized system clock on the machine running XBMC. All communication with Vimeo will fail if the system has a time drift of even a few minuts.

= Feature request = If you have a feature request then create a new post in the Vimeo support thread.

= Reporting a bug = If you are having problems with the plugin or just have a query please do read the documentation and do a search on the XBMC Vimeo support thread before posting.

If you believe you have found a new bug, create a log (see below) and post in the Vimeo support thread.

Creating a usefull debug log
Typically users will report errors with descriptions that lack many important details. While we take all user reported errors seriously, its often is impossible to help if without a proper debug-log, this guide will take you through the steps to create such a log.

As such, if you want any help with this issue you must follow these steps. $HOME/.xbmc/temp/xbmc.log $User/Library/Logs/xbmc.log \Users\\AppData\Roaming\XBMC\xbmc.log
 * 1) Open the plugin and go to "Advanced" in settings, enable "Plugin debug" and confirm.
 * 2) Find your debug Log here:
 * Linux::
 * Mac OSX:
 * Windows 7 & Vista:
 * 1) Paste your debug log to http://pastebin.com/ ( Do NOT upload part of the log, we need the ENTIRE log. )
 * 2) Post a message in this thread with your debug log.

If you have problems following the guide, please ask on the forum thread and we will help you through it.

= Testing/Status = Integration and unittests are run continously by Jenkins

http://tc.tobiasussing.dk/jenkins/view/Vimeo/

= Thanks = Thanks to mishk for his fork of dkm's vimeo-python client (can be found here) this greatly simplified development of the plugin and saved us a lot of sleepless nights fighting with oauth :)