Video Streaming

The base video url is /Video/{Id}/stream. Some players will have better results when the url has a video file extension, so we also provide several aliases to account for that:

• /Videos/{Id}/stream
• /Videos/{Id}/stream.mp4
• /Videos/{Id}/stream.asf
• /Videos/{Id}/stream.ogv
• /Videos/{Id}/stream.ts
• /Videos/{Id}/stream.webm
• /Videos/{Id}/stream.wmv
• /Videos/{Id}/stream.mp4
• /Videos/{Id}/stream.m4v
• /Videos/{Id}/stream.mkv
• /Videos/{Id}/stream.mpeg
• /Videos/{Id}/stream.avi
• /Videos/{Id}/stream.m2ts

If using a url with an extension, the extension should be based upon the output format, rather than the input.

Generally, it is recommend to use a url with a file extension that matches the format you wish to encode to as many players will perform better seeing the file extension in the url.

Item Id and MediaSourceId are the only required parameters.

All of the optional parameters can be viewed using the swagger documentation.

• AudioCodec
• AudioBitrate
• MaxAudioChannels
• AudioSampleRate
• VideoCodec
• VideoBitrate
• MaxWidth
• MaxHeight
• Profile (h264 profile)
• Level
• AudioStreamIndex
• SubtitleStreamIndex (if burning into the video)

Direct Stream

To direct stream a video file, simply use the static=true parameter.

Seeking

When direct streaming, the file will be served statically and client-side seeking will be possible. When transcoding, this will not be possible. In order to seek you'll have to stop the stream and start a new one using the StartTimeTicks parameter.