openm3u8

openm3u8 is a Python library for parsing .m3u8 files, which are used as HTTP Live Streaming (HLS) playlists.

This project is a fork of m3u8 and is maintained by Wurl.

Documentation

Loading a playlist

To load a playlist into an object from uri, file path or directly from string, use the load/loads functions:

import openm3u8

playlist = openm3u8.load('http://videoserver.com/playlist.m3u8')
print(playlist.segments)
print(playlist.target_duration)

# if you already have the content as string, use

playlist = openm3u8.loads('#EXTM3U8 ... etc ... ')

Dumping a playlist

To dump a playlist from an object to the console or a file, use the dump/dumps functions:

import openm3u8

playlist = openm3u8.load('http://videoserver.com/playlist.m3u8')
print(playlist.dumps())

# if you want to write a file from its content

playlist.dump('playlist.m3u8')

Supported tags

• #EXT-X-TARGETDURATION
• #EXT-X-MEDIA-SEQUENCE
• #EXT-X-DISCONTINUITY-SEQUENCE
• #EXT-X-PROGRAM-DATE-TIME
• #EXT-X-MEDIA
• #EXT-X-PLAYLIST-TYPE
• #EXT-X-KEY
• #EXT-X-STREAM-INF
• #EXT-X-VERSION
• #EXT-X-ALLOW-CACHE
• #EXT-X-ENDLIST
• #EXTINF
• #EXT-X-I-FRAMES-ONLY
• #EXT-X-BITRATE
• #EXT-X-BYTERANGE
• #EXT-X-I-FRAME-STREAM-INF
• #EXT-X-IMAGES-ONLY
• #EXT-X-IMAGE-STREAM-INF
• #EXT-X-TILES
• #EXT-X-DISCONTINUITY
• #EXT-X-CUE-OUT
• #EXT-X-CUE-OUT-CONT
• #EXT-X-CUE-IN
• #EXT-X-CUE-SPAN
• #EXT-OATCLS-SCTE35
• #EXT-X-INDEPENDENT-SEGMENTS
• #EXT-X-MAP
• #EXT-X-START
• #EXT-X-SERVER-CONTROL
• #EXT-X-PART-INF
• #EXT-X-PART
• #EXT-X-RENDITION-REPORT
• #EXT-X-SKIP
• #EXT-X-SESSION-DATA
• #EXT-X-PRELOAD-HINT
• #EXT-X-SESSION-KEY
• #EXT-X-DATERANGE
• #EXT-X-GAP
• #EXT-X-CONTENT-STEERING

Running Tests

$ ./runtests

Contributing

All contributions are welcome, but we will merge a pull request if, and only if, it

• Has tests
• Follows the code conventions

If you plan to implement a new feature or something that will take more than a few minutes, please open an issue to make sure we don't work on the same thing.