A HTTP Live Streaming (HLS) python library
Apple provides a number of tools to work with HLS however these are only usable on OS X. This library aims to include the functionality of these tools, plus more, and offer this across multiple platforms.
To ensure full support of a version during initial development of this library, version support will be iterated from the first to the latest. We do plan on supporting all versions before the first release.
pyhls currently supports Version 1 of the HTTP Live Streaming specification
as defined in the Pantos specification
To create a manifest:
>>> import pyhls
>>> manifest = pyhls.create('master.m3u8')
>>> manifest.add_stream(media='1.ts', playlist='1.m3u8')
This will create a master and media playlist for the media file '1.ts'.
Once you have finished setting up the manifest, you can write out the manifest and all it's dependencies to a folder.
>>> manifest.out(destination='/mymanifests')
('master.m3u8', '1.m3u8', '1.ts')
To parse a manifest, simply do:
manifest.parse('master.m3u8')
To validate a manifest:
warnings, errors = pyhls.validate('master.m3u8')
This will return you a list of warnings and errors, each with a description and line number.
To edit a manifest:
manifest = pyhls.parse('master'.m3u8)
manifest.add_stream(media='2.ts', playlist='2.m3u8')
When you parse a manifest, you can then edit it just like you would when creating.
Overview on how things currently stand:
- Build out the structure of the package.
- Add full create, parse, validate and edit support for version 1.
- Iterate on support for all other versions.
- Add validation for video/audio/subtitle media files.
- Add support for creating media files.
- Add support for encryption of media files.