Yle plugin for librtmp
Copyright (C) 2010-2012 Antti Ajanki
License: GPLv2
Homepage: http://www.iki.fi/aoa/rtmpdump-yle
Source code: https://github.com/aajanki/yle-dl

This is a plugin for librtmp for downloading media files from the
video streaming services of the Finnish national broadcasting company
Yle: Yle Areena (http://areena-beta.yle.fi/ng/areena,
http://ylex.yle.fi/ylex-areena) and Elävä Arkisto
(http://www.yle.fi/elavaarkisto/).

Installation
------------

0. If this is a tar.gz package, goto to step 1. If this is the git
version of the source code, download a modified version of rtmpdump
from https://github.com/aajanki/rtmpdump/tree/plugin2 and unpack it
into a subdirectory called rtmpdump.

1. Install prerequisites: libssl, libcrypto, pthreads, libltdl, python.
Additionally in OS X libiconv and Xcode, and in MinGW libiconv.

On Debian/Ubuntu installing packages libssl-dev, libltdl-dev and
python-dev satisfies the dependencies.

2. Compile and install:

make
make install

To avoid conflict with system's librtmp package the recommended way is
to link librtmp statically with the following commands:

make LIB_RTMP="librtmp/librtmp.a -lltdl -rdynamic"
make install

On MacOS, append SYS=darwin:

make SYS=darwin
make install SYS=darwin

On MinGW:llä (Windows), append SYS=mingw:

make SYS=mingw
make install SYS=mingw

Usage
-----

yle-dl [yle-dl or rtmpdump options] URL

where URL is the address of the Areena or Elävä arkisto web page where
you would normally watch the video in a browser.

yle-dl options:

--latestepisode   Download the latest episodes
--showurl         Print librtmp-compatible URL, don't download
--vfat            Create Windows-compatible filenames
--sublang lang    Download subtitles, lang = fin, swe, smi, none or all
--rtmpdump path   Set path to rtmpdump binary
--destdir dir     Save files to dir

Type "rtmpdump --help" to see a full list of options.

When downloading from outside Finland, it may be necessary to add "-n
flashu.yle.fi" on the command line. Note that not all videos are
available outside Finland.

Firewall must allow outgoing traffic on ports 80 and 1935.

Examples
--------

yle-dl http://areena-beta.yle.fi/ng/areena/tv/1373722/#/play -o video.flv

yle-dl "http://www.yle.fi/elavaarkisto/?s=s&g=4&ag=28&t=&a=9390"