grafov · warutsutthi · Aug 26, 2014 · Aug 26, 2014 · Aug 26, 2014 · Aug 26, 2014
diff --git a/AUTHORS b/AUTHORS
@@ -0,0 +1,20 @@
+There are many persons contribute their code (include small patches)
+to the project. They listed below in an alphabetical order:
+
+- Alexander (Axel) I.Grafov <[email protected]>
+- Andrey Chernov <[email protected]>
+- Andrew Sinclair <[email protected]>
+- Bradley Falzon <[email protected]>
+- Denys Smirnov <[email protected]>
+- Fabrizio (Misto) Milo <[email protected]>
+- Hori Ryota <[email protected]>
+- Jamie Stackhouse <[email protected]>
+- Julian Cooper <[email protected]>
+- Kz26
+- Makombo
+- Scott Kidder <[email protected]>
+- Vishal Kumar Tuniki <[email protected]>
+- Zac Shenker <[email protected]>
+
+If you want to be added to this list (or removed for any reason)
+just open an issue about it.
diff --git a/M3U8.md b/M3U8.md
@@ -1,9 +1,33 @@
 <!--*- mode:markdown;mode:orgtbl -*-->
+
+<!---
+ Part of M3U8 parser & generator library.
+ This doc explaines M3U8 tag occurence in different versions
+ of HLS protocol and their status in Go library.
+
+ Copyleft 2013-2015 Alexander I.Grafov aka Axel <[email protected]>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+ ॐ तारे तुत्तारे तुरे स्व
+-->
+
 M3U8 tags cheatsheet
 ====================
 
 The table above describes tags of M3U8, their occurence in playlists of different types and their support status
-in the go-library. Current library version is 0.2.
+in the go-library. Current stable version of the library is 0.2.
 
 Legend for playlist types:
 
@@ -13,22 +37,23 @@ Legend for playlist types:
 <!--- Note: markdown table below prepared in Emacs Orgmode and automatically converted to Github Markdown format -->
 
 <!--- BEGIN RECEIVE ORGTBL specs -->
-| Tag | Occured in | Proto ver. | Lib ver. |
+| Tag | Occured in | Proto ver | In Go lib since |
 |---|---|---|---|
 | EXT-X-ALLOW-CACHE | MED | 1 | 0.1 |
 | EXT-X-BYTERANGE | MED | 4 | 0.1 |
 | EXT-X-DISCONTINUITY | MED | 1 | 0.2 |
 | EXT-X-DISCONTINUITY-SEQUENCE | MED | 6 |  |
 | EXT-X-ENDLIST | MED | 1 | 0.1 |
-| EXT-X-I-FRAME-STREAM-INF | MAS | 4 |  |
-| EXT-X-I-FRAMES-ONLY | MED | 4 |  |
+| EXT-X-I-FRAME-STREAM-INF | MAS | 4 | 0.3 |
+| EXT-X-I-FRAMES-ONLY | MED | 4 | 0.3 |
 | EXT-X-INDEPENDENT-SEGMENTS | MAS | 6 |  |
 | EXT-X-KEY | MED | 1 | 0.1 |
-| EXT-X-MAP | MED | 5 |  |
+| EXT-X-MAP | MED | 5 | 0.3 |
 | EXT-X-MEDIA | MAS | 4 | 0.1 |
 | EXT-X-MEDIA-SEQUENCE | MED | 1 | 0.1 |
 | EXT-X-PLAYLIST-TYPE | MED | 3 | 0.2 |
 | EXT-X-PROGRAM-DATE-TIME | MED | 1 | 0.2 |
+| EXT-X-SESSION-DATA | MAS | 7 |  |
 | EXT-X-START | MAS | 6 |  |
 | EXT-X-STREAM-INF | MAS | 1 | 0.1 |
 | EXT-X-TARGETDURATION | MED | 1 | 0.1 |
@@ -39,36 +64,37 @@ Legend for playlist types:
 
 <!---
 #+ORGTBL: SEND specs orgtbl-to-gfm
-| Tag                          | Occured in | Proto ver. | Lib ver. |
-|------------------------------+------------+------------+----------|
-|                              |            | <l>        | <l>      |
-| EXT-X-ALLOW-CACHE            | MED        | 1          | 0.1      |
-| EXT-X-BYTERANGE              | MED        | 4          | 0.1      |
-| EXT-X-DISCONTINUITY          | MED        | 1          | 0.2      |
-| EXT-X-DISCONTINUITY-SEQUENCE | MED        | 6          |          |
-| EXT-X-ENDLIST                | MED        | 1          | 0.1      |
-| EXT-X-I-FRAME-STREAM-INF     | MAS        | 4          |          |
-| EXT-X-I-FRAMES-ONLY          | MED        | 4          |          |
-| EXT-X-INDEPENDENT-SEGMENTS   | MAS        | 6          |          |
-| EXT-X-KEY                    | MED        | 1          | 0.1      |
-| EXT-X-MAP                    | MED        | 5          |          |
-| EXT-X-MEDIA                  | MAS        | 4          | 0.1      |
-| EXT-X-MEDIA-SEQUENCE         | MED        | 1          | 0.1      |
-| EXT-X-PLAYLIST-TYPE          | MED        | 3          | 0.2      |
-| EXT-X-PROGRAM-DATE-TIME      | MED        | 1          | 0.2      |
-| EXT-X-START                  | MAS        | 6          |          |
-| EXT-X-STREAM-INF             | MAS        | 1          | 0.1      |
-| EXT-X-TARGETDURATION         | MED        | 1          | 0.1      |
-| EXT-X-VERSION                | MAS        | 2          | 0.1      |
-| EXTINF                       | MED        | 1          | 0.1      |
-| EXTM3U                       | MAS,MED    | 1          | 0.1      |
+| Tag                          | Occured in | Proto ver | In Go lib since |
+|------------------------------+------------+-----------+-----------------|
+|                              |            | <l>       | <l>             |
+| EXT-X-ALLOW-CACHE            | MED        | 1         | 0.1             |
+| EXT-X-BYTERANGE              | MED        | 4         | 0.1             |
+| EXT-X-DISCONTINUITY          | MED        | 1         | 0.2             |
+| EXT-X-DISCONTINUITY-SEQUENCE | MED        | 6         |                 |
+| EXT-X-ENDLIST                | MED        | 1         | 0.1             |
+| EXT-X-I-FRAME-STREAM-INF     | MAS        | 4         | 0.3             |
+| EXT-X-I-FRAMES-ONLY          | MED        | 4         | 0.3             |
+| EXT-X-INDEPENDENT-SEGMENTS   | MAS        | 6         |                 |
+| EXT-X-KEY                    | MED        | 1         | 0.1             |
+| EXT-X-MAP                    | MED        | 5         | 0.3             |
+| EXT-X-MEDIA                  | MAS        | 4         | 0.1             |
+| EXT-X-MEDIA-SEQUENCE         | MED        | 1         | 0.1             |
+| EXT-X-PLAYLIST-TYPE          | MED        | 3         | 0.2             |
+| EXT-X-PROGRAM-DATE-TIME      | MED        | 1         | 0.2             |
+| EXT-X-SESSION-DATA           | MAS        | 7         |                 |
+| EXT-X-START                  | MAS        | 6         |                 |
+| EXT-X-STREAM-INF             | MAS        | 1         | 0.1             |
+| EXT-X-TARGETDURATION         | MED        | 1         | 0.1             |
+| EXT-X-VERSION                | MAS        | 2         | 0.1             |
+| EXTINF                       | MED        | 1         | 0.1             |
+| EXTM3U                       | MAS,MED    | 1         | 0.1             |
 -->
 
 
 IETF drafts notes
 -----------------
 
-[IETF](http://ietf.org) document currently in Draft status. Different versions of the document introduce changes of HLS protocol playlist formats. Last version of the HLS protocol is version 6.
+[IETF](http://ietf.org) document currently in Draft status. Different versions of the document introduce changes of HLS protocol playlist formats. Latest version of the HLS protocol is version 7.
 
 http://tools.ietf.org/html/draft-pantos-http-live-streaming
 
@@ -78,3 +104,4 @@ http://tools.ietf.org/html/draft-pantos-http-live-streaming
 * Version 4 of the HLS protocol described in draft07-draft08.
 * Version 5 of the HLS protocol described in draft09-draft11.
 * Version 6 of the HLS protocol described in draft12-draft13.
+* Version 7 of the HLS protocol described in draft14-draft19.
diff --git a/README.md b/README.md
@@ -5,17 +5,17 @@ M3U8
 This is a most complete opensource library for parsing and generating of M3U8 playlists
 used in HTTP Live Streaming (Apple HLS) for internet video translations.
 
-Features are:
+M3U8 is simple text format and parsing library for it must be simple too. It did not offer
+ways to play HLS or handle playlists over HTTP. So library features are:
 
-* Realized HLS specs up to version 3 of the protocol.
+* 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 usage with DRM systems like Verimatrix etc.
+* Encryption keys support for use with DRM systems like [Verimatrix](http://verimatrix.com) etc.
 * Support for non standard [Google Widevine](http://www.widevine.com) tags.
 
-Copyleft Alexander I.Grafov aka Axel <[email protected]>
-
-Library licensed under GPLv3.
+Library licensed under GPLv3. Copyleft by library authors (see [AUTHORS](AUTHORS)).
 
 Install
 -------
@@ -24,12 +24,12 @@ Install
 
 or get releases from https://github.com/grafov/m3u8/releases
 
-Documentation
+Documentation [![Go Walker](http://gowalker.org/api/v1/badge)](http://gowalker.org/github.com/grafov/m3u8)
 -------------
 
 Package online documentation (examples included) available at:
 
-* http://gowalker.org/github.com/grafov/m3u8 [![Go Walker](http://gowalker.org/api/v1/badge)](http://gowalker.org/github.com/grafov/m3u8)
+* http://gowalker.org/github.com/grafov/m3u8
 * http://godoc.org/github.com/grafov/m3u8
 
 Supported by the HLS protocol tags and their library support explained in [M3U8 cheatsheet](M3U8.md).
@@ -99,51 +99,46 @@ Related links
 Library usage
 -------------
 
-This library successfully used in streaming software developed for my employer and tested with
-generating of VOD and Live streams and parsing of Widevine Live streams. Also library usage noted
-in opensource software:
+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:
 
-* [Stream Surfer](http://streamsurfer.org) monitoring software.
-* [gohls](https://github.com/kz26/gohls) — HLS downloader.
+* [HLS downloader](https://github.com/kz26/gohls)
+* [Another HLS downloader](https://github.com/Makombo/hlsdownloader)
+* [HLS utils](https://github.com/archsh/hls-utils)
 
 M3U8 parsing/generation in other languages
 ------------------------------------------
 
 * https://github.com/globocom/m3u8 in Python
-* https://github.com/zencoder/m3uzi in Ruby
+* https://github.com/sethdeckard/m3u8 in Ruby
 * https://github.com/Jeanvf/M3U8Paser in Objective C
 * https://github.com/tedconf/node-m3u8 in Javascript
 * http://sourceforge.net/projects/m3u8parser/ in Java
 * https://github.com/karlll/erlm3u8 in Erlang
 
-Project status [![Is maintained?](http://stillmaintained.com/grafov/m3u8.png)](http://stillmaintained.com/grafov/m3u8)
----------------
+Project status [![Go Report Card](https://goreportcard.com/badge/grafov/m3u8)](https://goreportcard.com/report/grafov/m3u8)
+--------------
 
-In development.
+[![Build Status](https://travis-ci.org/grafov/m3u8.png?branch=master)](https://travis-ci.org/grafov/m3u8) [![Build Status](https://drone.io/github.com/grafov/m3u8/status.png)](https://drone.io/github.com/grafov/m3u8/latest)
 
-[![Build Status](https://travis-ci.org/grafov/m3u8.png?branch=master)](https://travis-ci.org/grafov/m3u8) for last commit from `master` or `draft` branches.
+Project maintainers:
 
-[![Build Status](https://drone.io/github.com/grafov/m3u8/status.png)](https://drone.io/github.com/grafov/m3u8/latest) for `master` branch.
+* Bradley Falzon @bradleyfalzon
+* Alexander Grafov @grafov
 
 Development rules:
 
-* Changes firstly applied to `draft` branch then after minimal testing with unit tests it merged with `master` branch.
-* Code in `draft` branch may be in inconsistent state.
-* After complete testing and one week usage with my prober for HLS [Stream Surfer](http://streamsurfer.org) it may be released as new library version (minor version number increased).
-* Each new API call or tag accompanied by at least one unit test until it released in a new library version.
-* Major version number increased on API changes or new tags (until v1.0 this rule is not applied).
-* I reserve the right to break the development rules if my life plans make me do it.
+* After complete testing and one week usage with my prober for HLS [Stream Surfer](http://streamsurfer.org) it may be released as new library version.
+* Each new API call or M3U8 tag accompanied by at least with one unit test till new release (this rule will be apply after v1.0).
+* Versioning scheme follows http://semver.org rules (but versions till v1.0 not support bacward compatibility, see release notes carefully).
 
-Project dashboard: https://waffle.io/grafov/m3u8
+Project dashboard: https://waffle.io/grafov/m3u8 [![Stories in Ready](https://badge.waffle.io/grafov/m3u8.png?label=ready&title=Ready)](https://waffle.io/grafov/m3u8)
 
 Roadmap
 -------
 
-For version 0.3:
-
-* Support tags from versions 4 and 5 of the specs.
-
-For version 1.0:
+To version 1.0:
 
-* Support for all M3U8 tags up to latest version of specs.
+* Support all M3U8 tags up to latest version of specs.
 * Code coverage by unit tests more than 90%
diff --git a/TODO.org b/TODO.org
@@ -12,10 +12,12 @@
 * Planned features
 ** DONE [#A] Support EXT-X-PROGRAM-DATE-TIME
 ** DONE [#A] Support for EXT-X-PLAYLIST-TYPE												 :proto3:
-** [#A] Support for EXT-X-I-FRAMES-ONLY																	 :proto4:
-** [#A] Support for EXT-X-I-FRAME-STREAM-INF														 :proto4:
-** [#A] Support for EXT-X-MAP																						 :proto5:
-** [#A] Support for EXT-X-START																					 :proto6:
+** DONE [#A] Support for EXT-X-I-FRAMES-ONLY                         :proto4:
+** DONE [#A] Support for EXT-X-I-FRAME-STREAM-INF                    :proto4:
+** DONE [#A] Support for EXT-X-MAP                                   :proto5:
+** TODO Add samples from iOS Devs Lib
+   https://developer.apple.com/library/ios/technotes/tn2288/_index.html
+** [#A] Support for EXT-X-START                                      :proto6:
 ** [#A] Support for EXT-X-DISCONTINUITY-SEQUENCE												 :proto6:
 ** [#B] Autoexpand option for playlist buffers
 ** [#B] CR/LF protection: characters within a quoted-string MUST NOT include linefeed (0xA), carriage-return (0xD) or double quote (0x22). :draft12:validation:
@@ -34,4 +36,7 @@
 ** [#C] Add examples of playlists with #EXT-X-KEY
 ** [#C] Cover each API call with unit test
 ** [#C] Cover each tag with unit test
-** Merge media playlists
+* Planned for M3U8 utils
+** Merge media playlists                                          
+** Rename segments by mask in a playlist
+
diff --git a/doc.go b/doc.go
@@ -1,6 +1,6 @@
 // Package M3U8 is parser & generator library for Apple HLS.
 
-// Copyleft 2013-2014 Alexander I.Grafov aka Axel <[email protected]>
+// Copyleft 2013-2015 Alexander I.Grafov aka Axel <[email protected]>
 
 // This program is free software: you can redistribute it and/or modify
 // it under the terms of the GNU General Public License as published by
@@ -19,18 +19,18 @@
 
 /*
 
-This is a most complete opensource library for parsing and generating of M3U8 playlists
-used in HTTP Live Streaming (Apple HLS) for internet video translations.
+This is a most complete opensource library for parsing and generating of M3U8 playlists used in HTTP Live Streaming (Apple HLS) for internet video translations.
 
-Features are:
+M3U8 is simple text format and parsing library for it must be simple too. It did not offer ways to play HLS or handle playlists over HTTP. Library features are:
 
-  * Support HLS specs up version 3 of the protocol.
+  * Support HLS specs up to version 5 of the protocol.
   * Parsing and generation of master-playlists and media-playlists.
-  * Offers structures for keeping playlists metadata.
-  * Encryption keys support for usage with DRM systems like Verimatrix etc.
+  * Autodetect input streams as master or media playlists.
+  * Offer structures for keeping playlists metadata.
+  * Encryption keys support for usage with DRM systems like Verimatrix (http://verimatrix.com) etc.
   * Support for non standard Google Widevine (http://www.widevine.com) tags.
 
-Library coded acordingly with IETF draft http://tools.ietf.org/html/draft-pantos-http-live-streaming-12
+Library coded accordingly with IETF draft http://tools.ietf.org/html/draft-pantos-http-live-streaming
 
 Examples of usage may be found in *_test.go files of a package. Also see below some simple examples.