Popularity

7.8

Stable

Activity

0.0

Declining

Stars 1,223

Watchers 39

Forks 312

Last Commit about 2 months ago

Description

This is the most complete opensource library for parsing and generating of M3U8 playlists used in HTTP Live Streaming (Apple HLS) for internet video translations.

Programming language: Go

License: BSD 3-clause "New" or "Revised" License

Tags: Video Video Processing Playlist Parsing Apple HLS

Latest version: v0.11.1

M3U8 alternatives and similar packages

Based on the "Video" category.
Alternatively, view M3U8 alternatives based on common mentions on social networks and blogs.

Pion WebRTC

9.7 9.2 M3U8 VS Pion WebRTC

Pure Go implementation of the WebRTC API
goav

8.3 0.0 M3U8 VS goav

Golang bindings for FFmpeg (This repository is no longer maintained)

InfluxDB - Purpose built for real-time analytics at any scale.

InfluxDB Platform is powered by columnar analytics, optimized for cost-efficient storage, and built with open data standards.

Promo www.influxdata.com

gmf

7.4 0.0 M3U8 VS gmf

Go Media Framework
gortsplib

7.1 8.7 M3U8 VS gortsplib

RTSP 1.0 client and server library for the Go programming language
go-astisub

6.8 5.2 M3U8 VS go-astisub

Manipulate subtitles in GO (.srt, .ssa/.ass, .stl, .ttml, .vtt (webvtt), teletext, etc.)
go-libav

6.7 0.0 M3U8 VS go-libav

Go language bindings for ffmpeg libraries
go-astits

6.6 3.8 M3U8 VS go-astits

Demux and mux MPEG Transport Streams (.ts) natively in GO
libvlc-go

6.3 0.0 M3U8 VS libvlc-go

Handcrafted Go bindings for libVLC and high-level media player interface
gst

5.3 0.0 M3U8 VS gst

Go bindings for GStreamer (retired: currently I don't use/develop this package)
Vnc2Video

5.0 0.0 M3U8 VS Vnc2Video

A fully featured VNC client written in golang
go-m3u8

4.5 0.0 M3U8 VS go-m3u8

Parse and generate m3u8 playlists for Apple HTTP Live Streaming (HLS) in Golang (ported from gem https://github.com/sethdeckard/m3u8)
v4l

4.0 0.0 M3U8 VS v4l

Facade to the Video4Linux video capture interface.
go-mpd

2.2 5.1 M3U8 VS go-mpd

Go library for parsing and generating MPEG-DASH Media Presentation Description (MPD) files
libgosubs

2.0 0.0 M3U8 VS libgosubs

golang library to read and write various subtitle formats
golibnotify

1.0 2.6 M3U8 VS golibnotify

Go bindings for libnotify -- Create and update OS notifications in linux

Do you think we are missing an alternative of M3U8 or a related project?

Add another 'Video' Package

Popular Comparisons

README

M3U8

This is the most complete opensource library for parsing and generating of M3U8 playlists used in HTTP Live Streaming (Apple HLS) for internet video translations.

M3U8 is simple text format and parsing library for it must be simple too. It does not offer ways to play HLS or handle playlists over HTTP. So library features are:

Support HLS specs up to version 5 of the protocol.
Parsing and generation of master-playlists and media-playlists.
Autodetect input streams as master or media playlists.
Offer structures for keeping playlists metadata.
Encryption keys support for use with DRM systems like Verimatrix etc.
Support for non standard Google Widevine tags.

The library covered by BSD 3-clause license. See [LICENSE](LICENSE) for the full text. Versions 0.8 and below was covered by GPL v3. License was changed from the version 0.9 and upper.

See the list of the library authors at [AUTHORS](AUTHORS) file.

Install

go get github.com/grafov/m3u8

or get releases from https://github.com/grafov/m3u8/releases

Documentation

Package online documentation (examples included) available at:

Supported by the HLS protocol tags and their library support explained in [M3U8 cheatsheet](M3U8.md).

Examples

Parse playlist:

    f, err := os.Open("playlist.m3u8")
    if err != nil {
        panic(err)
    }
    p, listType, err := m3u8.DecodeFrom(bufio.NewReader(f), true)
    if err != nil {
        panic(err)
    }
    switch listType {
    case m3u8.MEDIA:
        mediapl := p.(*m3u8.MediaPlaylist)
        fmt.Printf("%+v\n", mediapl)
    case m3u8.MASTER:
        masterpl := p.(*m3u8.MasterPlaylist)
        fmt.Printf("%+v\n", masterpl)
    }

Then you get filled with parsed data structures. For master playlists you get Master struct with slice consists of pointers to Variant structures (which represent playlists to each bitrate). For media playlist parser returns MediaPlaylist structure with slice of Segments. Each segment is of MediaSegment type. See structure.go or full documentation (link below).

You may use API methods to fill structures or create them manually to generate playlists. Example of media playlist generation:

    p, e := m3u8.NewMediaPlaylist(3, 10) // with window of size 3 and capacity 10
    if e != nil {
        panic(fmt.Sprintf("Creating of media playlist failed: %s", e))
    }
    for i := 0; i < 5; i++ {
        e = p.Append(fmt.Sprintf("test%d.ts", i), 6.0, "")
        if e != nil {
            panic(fmt.Sprintf("Add segment #%d to a media playlist failed: %s", i, e))
        }
    }
    fmt.Println(p.Encode().String())

Custom Tags

M3U8 supports parsing and writing of custom tags. You must implement both the CustomTag and CustomDecoder interface for each custom tag that may be encountered in the playlist. Look at the template files in example/template/ for examples on parsing custom playlist and segment tags.

Library structure

Library has compact code and bundled in three files:

structure.go — declares all structures related to playlists and their properties
reader.go — playlist parser methods
writer.go — playlist generator methods

Each file has own test suite placed in *_test.go accordingly.

Library usage

This library was successfully used in streaming software developed for company where I worked several years ago. It was tested then in generating of VOD and Live streams and parsing of Widevine Live streams. Also the library used in opensource software so you may look at these apps for usage examples: