playlists-0.2.0.0: README.md

# Haskell Playlists Library and Tool

Playlists is a library for working with media playlist files.  The
original motivation for the library was extracting URLs for streaming
radio stations that use PLS and M3U playlist files.

The package also includes an executable that can dump the URLs from a
playlist file and convert between playlist file formats.

## Supported Formats

  * [PLS] []
  * [M3U and M3U8] [M3U]

## Future Plans

Some playlist files can be really big.  I plan on adding support for
incremental parsing and generating via [io-streams] [] at some point
in the future.

## Library Example

    import qualified Data.ByteString as BS
    import Text.Playlist

    readPlaylist :: Format -> IO Playlist
    readPlaylist fmt = do
      content <- BS.getContents
      case parsePlaylist fmt content of
        Left err -> fail $ "failed to parse playlist on stdin: " ++ err
        Right x  -> return x


## Executable Example

    $ playlist urls --format PLS < somefile.pls

    $ playlist convert --from PLS --to M3U < somefile.pls

[pls]: http://en.wikipedia.org/wiki/PLS_(file_format)
[m3u]: http://en.wikipedia.org/wiki/M3U
[io-streams]: http://hackage.haskell.org/package/io-streams