API for Third-Party Apps & Services

  • Updated

Overview

Developers of third-party apps and services can leverage Infuse's powerful video playback features to play, bookmark, and download videos using flexible URL schemes. Support for x-callback is also available which allows for returning back to another app once an action has been completed.

Available platforms: iPhone, iPad, Apple TV, and Mac

Usage Examples

Play a single file, and return to another app when finished

infuse://x-callback-url/play?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv

Play a single file with external subtitles added

infuse://x-callback-url/play?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv&
sub=http://192.168.162.100/Movies/movie.srt

Save (bookmark) a video URL to play later

infuse://x-callback-url/save?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv

Save (bookmark) a video URL and begin downloading it (iOS/macOS only)

infuse://x-callback-url/save?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv&
download=1

URL Encoding

Per the x-callback-url spec, all querystring values should be url-safe or encoded. Unencoded URLs may work in some cases, but when using actions with multiple parameters or URLs with multiple keys you will probably need to manually encode your URLs.

Examples

Unencoded URL

http://192.168.162.100/Movies/movie.mkv

Encoded URL

http%3A%2F%2F192.168.162.100%2FMovies%2Fmovie.mkv
Share this article

Was this article helpful?

65 out of 100 found this helpful

Have more questions? Submit a request