Latest 0.1.3
License MIT
Platforms ios 8.0, tvos 9.0, osx 10.10

Pantomime is a lightweight framework for iOS, OSX and tvOS that can read and parse HTTP Live Streaming manifests.

Latest build

Build Status


You can use Carthage to install Pantomime by adding that to your Cartfile:

github "thomaschristensen/Pantomime"

via CocoaPods

To use CocoaPods just add this to your Podfile:

pod 'Pantomime'

via Swift Package Manager

To use Pantomime as a Swift Package Manager package just add the following in your Package.swift file.

import PackageDescription

let package = Package(
    name: "HelloWorld",
        dependencies: [
            .Package(url: "", majorVersion: 0)


To use the parser just do the following:

import Pantomime

let builder = ManifestBuilder()
if let url = NSURL(string: "") {
    let manifest = builder.parse(url)

The ManifestBuilder’s parse method expects a master playlist manifest
to be found at the other end of the URL. Once this has been parsed
all Media Playlist Manifests referred to in the master will also
be fetched and parsed.

Core Classes


The manifest builder can parse both Master and Media playlist manifests.
You can choose to let ManifestBuilder parse master and it’s media
playlists, or you can parse either the master or media playlists only.


Represents a master playlist and it holds a reference to a list of
media playlist objects


The media playlist object contains a list of all video segments and
other properties like target duration (max duration of each segment),
path, version, bandwidth, program-id and the starting media sequence


This object holds a reference to the actual video file (path), it’s
actual duration, sequence number and optional title.

Helper Classes


This is a protocol that defines how these text manifest documents can
be read line by line. Various implementations of this protocol exist
helping reading the documents from a File, a URL or from a String.
These implementations are FileBufferedReader, URLBufferedReader and


Is a utility class that can be used to construct the actual
implementation of BufferedReader by specifying which type is required.
(This class is already deprecated. Use the implementations of
BufferedReader directly)


An extension to the NSURL class has been made to assist in constructing
the right URL when given relative paths in the various manifest files.

let masterManifest = ""
let mediaManifest = "gear1/prog_index.m3u8"

if let masterManifestURL = NSURL(string: masterManifest) {
    let mediaManifestURL = masterManifestURL.URLByReplacingLastPathComponent(mediaManifest)
    // mediaManifestURL now =


The Pantomime Framework is released under the MIT License.


  • Construct Master and Media Playlist objects and write them as files

Latest podspec

    "name": "Pantomime",
    "version": "0.1.3",
    "summary": "Parsing of M3U8 manifest files for Swift",
    "description": "M3U8Parser4Swift reads and writes HTTP Live Streaming manifest files.nUse it to fetch a Master manifest and for parsing it. Supports thenInternet-Draft version 7. Can be used to throw events when various elementsnhave been parsed. Use it to contruct a new manifest from scratch.nSupports Master and Media playlist manifest files.",
    "homepage": "",
    "license": "MIT",
    "authors": {
        "Thomas Christensen": "[email protected]"
    "platforms": {
        "ios": "8.0",
        "tvos": "9.0",
        "osx": "10.10"
    "source": {
        "git": "",
        "tag": "0.1.3"
    "source_files": "sources"

Pin It on Pinterest

Share This