Ero sivun ”Yle-dl” versioiden välillä

Siirry navigaatioon Siirry hakuun
3 637 merkkiä lisätty ,  14. maaliskuuta 2022
Viimeisimmän version riippuvuudet
pEi muokkausyhteenvetoa
(Viimeisimmän version riippuvuudet)
 
(48 välissä olevaa versiota 8 käyttäjän tekeminä ei näytetä)
Rivi 1: Rivi 1:
{{DISPLAYTITLE:{{lcfirst:{{PAGENAME}}}}}}
{{ Ohjelma  
{{ Ohjelma  
| nimi=yle-dl  
| nimi           = yle-dl
| kuva=  
| kuva           =  
| kuvateksti=  
| kuvateksti     =  
| lisenssi=[[GPL]]v.2
| lisenssi       = [[GPLv3]]
| käyttöliittymä=teksti  
| käyttöliittymä = teksti
| kotisivu=[http://users.tkk.fi/~aajanki/rtmpdump-yle/index.html aajanki.github.com]
| kotisivu       = [https://aajanki.github.io/yle-dl/ aajanki.github.io/yle-dl]
 
| lähdekoodi    = [https://github.com/aajanki/yle-dl github.com/aajanki/yle-dl]
}}
}}
[[Kuva:Yle-dl.png|right|200px|thumb|yle-dl käytössä.]]
[[Kuva:Yle-dl.png|right|200px|thumb|yle-dl käytössä.]]
[[Kuva:Rtmpdump-yle.png|right|200px|thumb|Ohjetekstiä.]]
[[Kuva:Rtmpdump-yle.png|right|200px|thumb|Ohjetekstiä.]]
'''yle-dl''' on [[komentorivi]]ohjelma video- ja äänitiedostojen lataamiseen [[Yle Areena ja Elävä arkisto|Yle Areenasta ja Elävästä arkistosta]]. TV- ja radio-ohjelmien lisäksi yle-dl voi ladata [https://areena.yle.fi/audio/kanavat Areenan nettiradioita] ja [https://areena.yle.fi/tv/suorat suoria lähetyksiä]. Se toimii Linuxilla, Windowsilla ja macOS:lle.
Ylen ohjelmien lataaminen on sallittua vain yksityiseen käyttöön.
==Asennus lähdekoodeista==


'''yle-dl''' (''Yleisradio download'') on [[komentorivi]]ohjelma video- ja äänitiedostojen lataamiseen [[YLE Areena ja Elävä arkisto|YLE Areenasta ja Elävästä Arkistosta]]. TV- ja radio-ohjelmien lisäksi yle-dl voi ladata [http://areena.yle.fi/nettiradiot Areenan nettiradioita] ja [http://areena.yle.fi/live suoria lähetyksiä]. Se toimii Linuxilla, Windowsilla ja Mac OS X:llä.
===Riippuvuudet===


yle-dl perustuu Andrej Stepanchukin [[RTMPDump]]-ohjelmaan, joka puolestaan perustuu Team Boxeen RTMPDumper-ohjelmakoodeihin. JSON-viestien jäsentämiseen käytetään json-c-[[kirjasto]]a.
* Python 3.6+
* pip
* ffmpeg (tekstitys toimii vain ffmpegin versiolla 4.1 tai sitä uudemmilla)
* setuptools (jos asennat lähdekoodeista)


YLEn ohjelmien lataaminen on sallittua vain yksityiseen käyttöön.
Joidenkin harvojen ohjelmien lataamiseen tarvitaan lisäksi:


==Asennus lähdekoodeista==
* wget
 
===Asennus sekä päivitys===
Ohjelman voi asentaa myös ''[[pip]]''in avulla. Se löytyy myös [[AUR]]:sta Ja [[Ubuntu]]sta.
 
Vaaditut kirjastot ja ohjelmat:
python (3.6 tai uudempi), python-pip, ffmpeg


Ohjelman [[lähdekoodi]]paketin voi ladata sen [http://users.tkk.fi/~aajanki/rtmpdump-yle/index.html kotisivuilta]. Ladattu lähdekoodi täytyy tämän jälkeen [[kääntäminen|kääntää]].
{{oikeudet}}
# pip3 install --user --upgrade yle-dl


Kääntämistä varten tarvitaan [[OpenSSL]]:n kehitystiedostot, jotka yleensä löytyvät [[paketinhallintajärjestelmä|paketinhallinnasta]] nimellä <tt>openssl-devel</tt> tai <tt>libssl-dev</tt> sekä <tt>libcrypto-dev</tt> ja <tt>python-dev</tt>.  
====Asennus lähdekoodeista====
Ohjelman [[lähdekoodi]]paketin voi ladata sen [https://aajanki.github.io/yle-dl/ kotisivuilta]. Ladattu lähdekoodi täytyy tämän jälkeen [[kääntäminen|kääntää]].  


Debianissa ja Ubuntussa käännöstyökalut ja tarvittavat kirjastot löytyvät paketeista <tt>build-essential</tt>, <tt>libssl-dev</tt>, <tt>libjson0-dev</tt> ja <tt>python-dev</tt>.
Debianissa ja Ubuntussa käännöstyökalut ja tarvittavat kirjastot löytyvät paketeista <tt>build-essential</tt>, <tt>libssl-dev</tt>, <tt>libjson0-dev</tt> ja <tt>python-dev</tt>.
Rivi 29: Rivi 45:
  [[tar]] xf ''paketinnimi''
  [[tar]] xf ''paketinnimi''
Tämän jälkeen siirrytään paketista purettuun hakemistoon komennon [[cd]] avulla ja annetaan komennot make joka kääntää ohjelman ja make install asentaa ohjelman.
Tämän jälkeen siirrytään paketista purettuun hakemistoon komennon [[cd]] avulla ja annetaan komennot make joka kääntää ohjelman ja make install asentaa ohjelman.
make
 
  [[sudo]] make install
  [[sudo]] make install
Asennus Debian unstable (toukokuu 2016) ja Ubuntu 16.04
sudo apt-get install rtmpdump python python-crypto php-cli php-curl php-mcrypt php-xml php-bcmath
sudo phpenmod mcrypt
sudo make install
Asennus Debian 8 ja Ubuntu 15.10 ja niitä vanhemmissa versioissa.
sudo apt-get install rtmpdump python python-crypto php5-cli php5-curl php5-mcrypt
sudo php5enmod mcrypt
sudo make install


Mikäli viimeinen komento tuottaa virheilmoituksen ([[sudo]]n käyttöön ei ole oikeuksia), voi sen yrittää antaa muodossa
Mikäli viimeinen komento tuottaa virheilmoituksen ([[sudo]]n käyttöön ei ole oikeuksia), voi sen yrittää antaa muodossa
Rivi 47: Rivi 77:


Esimerkiksi:
Esimerkiksi:
  yle-dl http://areena.yle.fi/video/261405
  yle-dl https://areena.yle.fi/1-444655


[[Valitsin]] <tt>-o</tt> määrittelee kohdetiedoston nimen.
[[Valitsin]] <tt>-o</tt> määrittelee kohdetiedoston nimen.
  yle-dl http://areena.yle.fi/video/261405 -o /polku/hakemistoon/video.flv
  yle-dl https://areena.yle.fi/1-444655 -o /polku/hakemistoon/video.mkv


Videon voi putkittaa suoraan [[Mplayer]]iin seuraavasti:
Videon voi putkittaa suoraan [[mpv]]n seuraavasti:
   
   
  yle-dl http://areena.yle.fi/video/261405 -o - | mplayer -
  yle-dl https://areena.yle.fi/1-444655 -o - | mpv -


Muita valitsimia:
Muita valitsimia:
*'''--resume''' - jatkaa aikaisemmin keskeytynyttä latausta
<pre>
*'''-o''' - kohdetiedosto
optional arguments:
*'''--ylePassi YLEPassi-eväste''' - eväste
  -h, --help            näyttää tämän pikaohjeen
*'''--live''' - Suoran YleX lähetyksen lataaminen
  -V, --verbose, --debug
*'''--help''' - pikaohje
                        Näyttää laajennetun virheenjäljityksen
  -c FILENAME, --config FILENAME
                        asetustiedoston polku
Input and output:
  url                  Areenan, Elävän Arkiston tai Yle uutissivuston osoite
  -i FILENAME          Lukee URLit nimetystä tiedostosta, yksi URL per rivi
  -o FILENAME          Tallentaa suoratoiston nimettyyn tiedostoon
  --output-template TEMPLATE
                        Malline tiedoston nimen luomiselle kun ei käytetä -o-kytkintä. Malline tukee seuraavia korvikkeita:
                        ${title} korvataan jakson nimellä, ${series} sarjan nimellä, ${episode} on kauden numero ja
                        jaksonumero "S02E12", ${timestamp} on suoratoiston julkaisuaika "2018-12-01T18:30", ${date} on suoratoiston
                        julkaisu päivämäärä "2018-12-01", $$ on pakomerkki se korvataan kirjaimellisesti "$". Kaikki muu näkyy
                        kuten ovat.
  --pipe                Putkittaa suoratoiston stdout esimerkiksi mediatoistimelle. Esim. "yle-dl --pipe URL | vlc -"
  --destdir DIR        Tallentaa tiedostot DIR-sijaintiin
  --showurl            Tulostaa URL, muttei lataa
  --showtitle          Tulostaa suoratoiston otsikon, muttei lataa
  --showepisodepage    Tulostaa verkkosivun jokaiselle jaksolle
  --showmetadata        Tulostaa metatiedot saatavissa olevista suoratoistoista
  --vfat                Tekee Windows-yhteensopivat tiedostonimet
  --resume             Jatkaa aikaisemmin keskeytynyttä latausta
  --ratelimit BR        Enimmäiskaistan käyttö, kokonaisluku kt/s
  --proxy URI          HTTP(S)-välityspalvelin jota käytetään. Esimerkiksi: --proxy localhost:8118
  --postprocess CMD    Suorittaa komennon CMD onnistuneen latauksen jälkeen. CMD is called with two arguments: video, subtitle
 
Stream type and quality:
  --audiolang LANG      Valitse suoratoiston äänen kieli, "fin" tai "swe"
  --sublang LANG        Lataa tekstitykset, jos LANG on "all" (oletus) tai ei lataa tekstityksiä LANG ollessa "none".
  --hardsubs            Polttaa tekstitykset kuvaan jos mahdollista
  --latestepisode      Lataa sarjan viimeisimmän jakson
  --maxbitrate RATE    Enimmäisbittivirta suoratoiston lataamiseen, kokonaisluku kt/s tai "best" tai "worst".
  --resolution RES      Enimmäispystyresoluutio pikseleissä, oletus: korkein mahdollinen resoluutio
  --duration S          Tallentaa ainostaan ensimmäiset S sekunnit suoratoistosta
  --preferformat F      Haluttu videoformaatti: mkv (oletus) tai mp4. Käytössä vain kun ladataan ffmpeg:llä


Downloader backends:
  --backend BE          Lataajia, joita yritetään kunnes yksi niistä onnistuu (pilkulla eroteltu lista). Mahdollisia arvoja: "wget",
                        "ffmpeg", "adobehdsphp" = AdobeHDS.php, "youtubedl" = youtube-dl, "rtmpdump"
  --rtmpdump PATH      Asettaa polun rtmpdump binääriin
  --ffmpeg PATH        Asettaa polun ffmpeg binääriin
  --ffprobe PATH        Asettaa polun ffprobe binääriin
  --adobehds CMD        Asettaa komennon AdobeHDS.php suorittamiseen
  --wget PATH          Asettaa polun wget binääriin
</pre>


== Tiedostomuotojen muunnokset ==
== Tiedostomuotojen muunnokset ==


Areenan video- ja äänitallenteet lähetetään FLV-säiliömuodossa, jota harva mediasoitin tukee suoraan. FLV:n sisällä on kuitenkin H.264-videoraita ja AAC-ääniraita, joita useimmat soittimet osaavat purkaa, kun säiliömuodon vain vaihtaa MP4:ksi. Pelkkää ääntä sisältävissä radiotallenteissa (.fla-pääte) on AAC:n sijaan MP3-ääniraita, joka toimii FLV:stä ulos purettuna sellaisenaan.
Oletuksena yle-dl pyrkii tallentamaan MKV-säiliömuodossa. (.mkv-pääte). MKV:n sisällä on kuitenkin H.264-videoraita ja AAC-ääniraita, joita useimmat soittimet osaavat purkaa. Pelkkää ääntä sisältävissä radiotallenteissa (.mp3-pääte) on MP3-ääniraita.


Tässä kuvatut muunnokset ovat häviöttömiä, eli niillä ei ole mitään vaikutusta videon ja äänen laatuun.
Jos jostain syystä tarve tulee muuntaa MKV vaikkapa MP4-muotoon, alla on ohjeet. Tässä kuvatut muunnokset ovat häviöttömiä, eli niillä ei ole mitään vaikutusta videon ja äänen laatuun.


=== Videotallenteet MP4-muotoon ===
=== Videotallenteet MP4-muotoon ===


[[ffmpeg]] on kätevä komentorivityökalu, joka osaa mm. lukea FLV-säiliön sisällön ja siirtää sen sellaisenaan MP4-säiliöön:
[[ffmpeg]] on kätevä komentorivityökalu, joka osaa mm. lukea MKV-säiliön sisällön ja siirtää sen sellaisenaan MP4-säiliöön:


  [[ffmpeg]] -i tiedosto.flv -vcodec copy -acodec copy tiedosto.mp4
  [[ffmpeg]] -i tiedosto.mkv -vcodec copy -acodec copy tiedosto.mp4


Korvaa <tt>tiedosto.flv</tt> yle-dl:n tallentaman tiedoston nimellä ja <tt>tiedosto.mp4</tt> haluamallasi mp4-tiedoston nimellä. Voit käyttää myös tiedoston koko polkua: <tt>/polku/hakemistoon/tiedosto.flv</tt>
Korvaa <tt>tiedosto.mkv</tt> yle-dl:n tallentaman tiedoston nimellä ja <tt>tiedosto.mp4</tt> haluamallasi mp4-tiedoston nimellä. Voit käyttää myös tiedoston koko polkua: <tt>/polku/hakemistoon/tiedosto.mkv</tt>


=== Äänitallenteet MP3-muotoon ===
=== Äänitallenteet MP3-muotoon ===


Olettaen että FLV tai FLA -tiedostossa on MP3-ääniraita, sen voi kopioida ulos säiliöstä [[ffmpeg]]illä:
Vaikka MKV-tiedostoissa ääniraita on yleensä AAC-koodattu, MP3-ääniraidan voi kopioida ulos säiliöstä [[ffmpeg]]illä:
 
[[ffmpeg]] -i tiedosto.fla -acodec copy tiedosto.mp3


Saman voi tehdä myös [[MPlayer]]-ohjelmalla:
  [[ffmpeg]] -i tiedosto.mkv -vn -c:a libmp3lame tiedosto.mp3
  [[mplayer]] -dumpaudio tiedosto.fla -dumpfile tiedosto.mp3


=== Tiedoston sisällön tutkiminen ===
=== Tiedoston sisällön tutkiminen ===
Rivi 91: Rivi 160:
Jos et ole varma mediatiedoston säiliömuodosta ja sen sisältämien video- ja ääniraitojen formaateista, voit tutkia tiedostoa [[ffmpeg]]illä:
Jos et ole varma mediatiedoston säiliömuodosta ja sen sisältämien video- ja ääniraitojen formaateista, voit tutkia tiedostoa [[ffmpeg]]illä:


  [[ffmpeg]] -i tiedosto.flv
  [[ffmpeg]] -i tiedosto.mkv


Se kertoo Areenasta ladatusta videosta seuraavaa:
Se kertoo Areenasta ladatusta videosta seuraavaa:
  Input #0, <b>flv</b>, from 'Uusi päivä (S): Osa 143-2012-01-17-20:00:00.flv':
 
  Metadata:
  Input #0, <b>matroska</b>,<b>webm</b>, from 'Uusi Päivä: Rahan puutteessa on moni köyhtynyt: S2011E143-2019-02-15T00:01.mkv':
    duration        : 1668
  Metadata:
    moovPosition    : 28
    ENCODER        : Lavf58.20.100
    width          : 640
   Duration: 00:27:47.18, start: 0.000000, bitrate: 4036 kb/s
    height          : 360
    Stream #0:0: Video: <b>h264</b> (High), yuv420p(progressive), 1920x1080 [SAR 1:1 DAR 16:9], 25 fps, 25 tbr, 1k tbn, 50 tbc (default)
    videocodecid   : avc1
    Metadata:
    audiocodecid    : mp4a
      VARIANT_BITRATE : 4243601
    avcprofile      : 77
      DURATION        : 00:27:47.181000000
    avclevel        : 30
    Stream #0:1: Audio: <b>aac</b> (LC), 44100 Hz, stereo, fltp (default)
    aacaot          : 2
    Metadata:
    videoframerate  : 25
      VARIANT_BITRATE : 4243601
    audiosamplerate : 48000
      DURATION        : 00:27:47.161000000
    audiochannels  : 2
    Stream #0:2(fi): Subtitle: webvtt (default)
  Duration: 00:27:47.54, start: 0.000000, bitrate: N/A
    Metadata:
    Stream #0.0: Video: <b>h264 (Main)</b>, yuv420p, 640x360 [PAR 1:1 DAR 16:9], 25 tbr, 1k tbn, 50 tbc
      VARIANT_BITRATE : 4243601
    Stream #0.1: Audio: <b>aac</b>, 48000 Hz, stereo, s16
      COMMENT        : ohjelmatekstitys
      DURATION        : 00:27:37.920000000
At least one output file must be specified


==Jakelukohtainen asennus==
==Jakelukohtainen asennus==
===Arch Linux sekä siihen pohjautuvat===
[[AUR]] löytyy kolme vaihtoehtoa, joista pelkkä yle-dl on paras vaihtoehto.
yay -S {{AUR|yle-dl}}


===Fedora, RHEL, CentOS===
===Fedora, RHEL, CentOS===


Yle-dl on saatavilla [[RPM Fusion]]ista [[Fedora]]lle ja [[Red Hat Enterprise Linux]]ille ja sen kanssa yhteensopiville jakeluille, kuten [[CentOS]]ille.
yle-dl on saatavilla [[RPM Fusion]]ista [[Fedora]]lle ja [[Red Hat Enterprise Linux]]ille ja sen kanssa yhteensopiville jakeluille, kuten [[CentOS]]ille.


Jos [[RPM Fusion#Fedoran_vakaat_versiot|RPM Fusion on otettu käyttöön]], Yle-dl:n asentaminen onnistuu komennolla
Jos [[RPM Fusion#Fedoran_vakaat_versiot|RPM Fusion on otettu käyttöön]], yle-dl:n asentaminen onnistuu komennolla
   [[su]] -c "yum install yle-dl"
   [[su]] -c "yum install yle-dl"


==Katso myös==
==Katso myös==
*[[Youtube-dl]]
*[[youtube-dl]]
*[[Metacafe-dl]]
*[[Metacafe-dl]]
*[[Nicovideo-dl]]
*[[nicovideo-dl]]


==Aiheesta muualla==
==Aiheesta muualla==
* [http://aajanki.github.com/yle-dl/index.html yle-dl kotisivu]
* [https://login.yle.fi/ Yle Passin] rekisteröityminen
* [http://aur.archlinux.org/packages.php?ID=29792 archlinux] yle-dl
* [http://mandriva-fi.org/wiki/Yhteis%C3%B6n_tarjoamat_lataukset#RTMPDump-YLE Mandriva] yle-dl
* [https://login.yle.fi/ YLE Passin] rekisteröityminen




2

muokkausta

Navigointivalikko