osklil / hls-fetch

Download and decrypt videos served by the HTTP Live Streaming (HLS) protocol.

hls-fetch

Introduction

hls-fetch is a small program that downloads and decrypts HTTP Live Streaming (HLS) videos. HLS is commonly used for streaming video on Apple iOS devices.

hls-fetch can download videos from web pages with embedded

It is written in Perl.

Author and Feedback

hls-fetch is written by Oskar Liljeblad [email protected].

This software is a work in progress and there are probably many ways it can still be improved. If you'd like to contribute patches, ideas, or bug reports, please don't hesitate contacting me!

License

hls-fetch is copyright (C) 2012 Oskar Liljeblad.

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/.

Download

The latest hls-fetch can be downloaded from GitHub:

• https://github.com/osklil/hls-fetch

Requirements

• Perl 5.10.0 (or later). Debian: perl

• OpenSSL (only needed for encrypted streams). Debian: openssl

• HTML::Parser Perl module. Debian: libhtml-parser-perl

• LWP::UserAgent Perl module. Debian: libwww-perl

• JSON Perl module. Debian: libjson-perl

• URI Perl module. Debian: liburi-perl

Usage

All you need to specify on the command line is the URL to fetch. hls-fetch will download the page and look for a

Run 'hls-fetch --help' for further usage information.

Future

On SIGINT and other terminating signals, make sure temporary files are removed.

Autodetect data in URL so that the --embedded/--playlist/--svtplay options are not necessary.

References

• HTTP Streaming with Encryption under Linux: http://www.opensolutions.ie/blog/2010/08/http-streaming-with-encryption-under-linux/

• HTTP Live Streaming: http://en.wikipedia.org/wiki/HTTP_Live_Streaming

hls-fetch's Issues

dump the whole hls structure, not an mp4

How hard would it be to implement a recursive copy of the full hls structure instead of creating a single mp4 from a single bitrate?

Bad decrypt due to key being fetched as decoded data

I've had trouble downloading a stream due to a bad decrypt error from OpenSSL. It turns out the wrong decrypt key was assembled when doing the faux hexdump of the fetched key file. This in turn was because the crypt key file was fetched as decoded utf8 data, although it's just a series of bytes. I fixed this by making this modification: https://github.com/alimony/hls-fetch/commit/6714efb15fe09efcfc9acb115eb41e7bd3c7abac

Would you be interested in a pull request with this fix?

invalid playlist, no header

I get a strange error when downloading from svtplay.

server:/storage1/hls-fetch# ./hls-fetch --svtplay
http://www.svtplay.se/video/1861168/fukushima
no output file specified, assuming video.ts
http://svtplay16p-f.akamaihd.net/i/se/open/20140308/1365368-001A/DOKUMENT_UTIFRA-001A-7da850e7501b699d_,900,348,564,1680,2800,.mp4.csmil/master.m3u8?cc1=name=Svenska~default=yes~forced=no~uri=http://media.svt.se/download/mcc/wp3/undertexter-wsrt/1365368/1365368-001A/C(sv)/index.m3u8~lang=sv: invalid playlist, no header

Can't verify SSL peers without knowing which Certificate Authorities to trust

Hello,

Is there a way for this error message ?
"cannot fetch playlist: 500 Can't verify SSL peers without knowing which Certificate Authorities to trust"

How do I install this after installing all given 5 modules ?

cannot fetch encryption key

cannot fetch encryption key: 403 Forbidden

Can I enter encryption key manually?

Cannot fetch encryption key: 400 Bad Request

I seem to be getting this even though I can clearly see the key being grabbed.

Any reason as to why I am getting this? Thanks.

For decryption

I'm newbie to program and tried to install Perl & OpenSSL on my PC
I finally make the way out to run Perl, but the decryption didn't go smooth.
Is it something to do with the key file? I have no idea of how to get the key...
What I am trying to download is: http://logirl.favclip.com/video/tgs_concert05.html
I can get the m3u8, but I think that I have some problems on the decryption