Aspect Ratio

When set, any variants or representations matching the specified aspect ratio will be removed from their respective playlists. Square videos (width equal to height) are never removed.

Support

Protocol

HLS DASH
yes yes

Keys

name key
aspect ratio ar()

Values

value meaning example
L Landscape ar(L)
P Portrait ar(P)

Values are case-insensitive (L and l are equivalent).

  • Landscape: any video where width > height
  • Portrait: any video where height > width
  • Square: width == height — never filtered out

Usage Example

Remove landscape variants (keep portrait):

$ http http://bakery.dev.vtg.paramount.tech/ar(L)/star_trek_discovery/S01/E01.m3u8

Remove portrait variants (keep landscape):

$ http http://bakery.dev.vtg.paramount.tech/ar(P)/star_trek_discovery/S01/E01.m3u8

Remove both (only square variants survive):

$ http http://bakery.dev.vtg.paramount.tech/ar(L,P)/star_trek_discovery/S01/E01.m3u8

Combined with other filters:

$ http http://bakery.dev.vtg.paramount.tech/ar(P)/fps(60)/star_trek_discovery/S01/E01.m3u8

This site uses Just the Docs, a documentation theme for Jekyll.