Extension API

Learn how to build extensions for SeriesGuide.

An extension provides a piece of text and optionally a view intent for media items (currently only episodes). It might just link to external content (app deep-link, web page, ...) or trigger an action in another app (play, record, ...). Or just display some status information (e.g. "downloaded").

With SeriesGuide 13.1 and up users can add up to two extensions. Adding more is exclusive to subscribers and X Pass holders. http://seriesgui.de/whypay Don't like? Contact me.

Get started

1. If your Android project is built with Gradle or Maven, add the following dependency:
   com.uwetrottmann.seriesguide:seriesguide-api:1.2.0
   For everyone else, the API jar is available on Maven Central.
2. Create a new class that extends SeriesGuideExtension.
3. Add the required tags to your AndroidManifest.xml file. Read the class documentation of SeriesGuideExtension for details.

Install your extension side-by-side with SeriesGuide and you should be able to add it from the extension customization screen. The activity of this screen, ExtensionsConfigurationActivity, is also exported so you can directly start it if you want to direct users to it.

Sample extension

A sample extension Android project for Android Studio is available.

API Reference

Take a look at the API reference documentation.

Change log

1.2.0 (2015-07-13, released with 24-beta3)

• Add absolute number to Episode.

1.1.1 (2014-08-21)

• Updated Intents helper class to create intents that do not create new tasks.

1.1.0 (2014-04-02)

• Create Intents class to create intents for viewing shows or episodes with SeriesGuide.

1.0.1 (2014-03-26)

• Initial release. Extensions can provide actions for episodes.