RTMPDump-YLE
(C) 2009 Antti Ajanki <antti.ajanki@iki.fi>
(C) 2009 Andrej Stepanchuk
Ohjelmistolisenssi: GPLv2

RTMPDump-YLE lataa video- ja äänitiedostoja YLE Areenasta
(http://areena.yle.fi/). TV- ja radio-ohjelmien lisäksi RTMPDump-YLE
voi ladata Areenan nettiradioita (http://areena.yle.fi/nettiradiot) ja
suoria lähetyksiä (http://areena.yle.fi/live).

RTMPDump-YLE perustuu Andrej Stepanchukin RTMPDump-ohjelmaan, joka
puolestaan perustuu team boxeen RTMPDumper-ohjelmakoodeihin.
JSON-viestien jäsentämiseen käytetään json-c-kirjastoa.

Asennus
-------

Vaaditut kirjastot: libssl, libcryto ja libxml.

Debianissa ja Ubuntussa tarvittavat kirjastot saa käyttöönsä
asentamalla paketit libssl-dev ja libxml2-dev.

./configure
make
make install

Käyttö
------

yle-dl areenavideosivu [--auth YLEPassi-eväste] [muut_valitsimet],

missä areenavideosivu on ladattavan ohjelman Areena-sivun osoite, eli
osoite, jonka kautta ohjelmaa voisi katsoa nettiselainta käyttäen.

Suoria lähetyksiä voi ladata myös ilman osoitteen syöttämistä
komennolla

yle-dl --live

Tämä lataa ensimmäisen ohjelman sivulta http://areena.yle.fi/live. Jos
muita suoria lähetyksiä ei ole käynnissä, tallennetaan otsikon "Aina
käynnissä" alla mainittu radiostudion lähetys.

Ohjelman toimintaa voi muokata lisäämällä komentoon muita valitsimia.
Luettelon muista mahdollisista valitsimista (englanniksi) näkee
komentamalla

yle-dl --help

YLE Passin vaativien ohjelmien lataaminen
-----------------------------------------

Jotkin Areenan ohjelmista ovat saatavilla vain TV-maksun maksaneille.
Voit ladata tällaisia ohjelmia kirjautumalla Ylen sivuille ja
syöttämällä YLE Passi -evästeesi yle-dl:lle seuraavasti:

1. Kirjaudu nettiselaimella sisään osoitteessa

https://login.yle.fi/login/index.php?language=1&url=areena.yle.fi

2. Avaa selaimen evästetietokanta. Firefoxissa
Edit->Preferences->Privacy->Show cookies.

3. Etsi eväste nimeltä ChatYleFi (verkkotunnus .yle.fi).

4. Kopioi evästeen sisältö ja anna se yle-dl:lle --auth-valitsimella.
Eväste on pitkä merkkijono joka alkaa YLE Passi
-käyttäjätunnuksellasi.

Esimerkkejä
-----------

* Ohjelman lataaminen automaattisesti nimettävään tiedostoon:

  yle-dl http://areena.yle.fi/video/261405

* Ohjelman lataaminen tiedostoon uutiset.flv:

  yle-dl http://areena.yle.fi/video/261405 -o uutiset.flv

* Keskeytyneen latauksen jatkaminen tiedostoon uutiset.flv:

  yle-dl http://areena.yle.fi/video/261405 -o uutiset.flv --resume

* YLE Radio 1 -nettiradion tallentaminen:

  yle-dl "http://areena.yle.fi/player/index.php?channel=1&language=fi"

* YLE Passin vaativan ohjelman lataaminen. --auth valitsimen parametri
on selaimesta haettu ChatYleFi-evästeen arvo.

  yle-dl http://areena.yle.fi/video/305452 --auth ChatYleFi-eväste
