forked from aajanki/yle-dl
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.fi
178 lines (114 loc) · 5.21 KB
/
README.fi
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
Apuohjelma videoiden lataamiseen Yle Areenasta
Copyright (C) 2010-2021 Antti Ajanki, [email protected]
Ohjelmistolisenssi: GPLv3
Kotisivu: https://aajanki.github.io/yle-dl/
Lähdekoodi: https://github.com/aajanki/yle-dl
yle-dl on apuohjelma tiedostojen lataamiseen Yle Areenasta
(https://areena.yle.fi), Elävästä arkistosta
(http://yle.fi/aihe/elava-arkisto) ja Ylen uutissivustolta
(http://yle.fi/uutiset/).
Asennusohjeet
-------------
Alla on yleiset asennusohjeet. Yksityiskohtaisemmat asennusohjeet
Debianille, Ubuntulle, Mac OS X:lle, Windowsille ja Androidille
löytyvät tiedostosta OS-install-instructions.md.
### 1. Asenna riippuvuudet:
* Python 3.6+
* pip
* ffmpeg (tekstitys toimii vain ffmpegin versiolla 4.1 tai sitä uudemmilla)
* setuptools (jos asennat lähdekoodeista)
Joidenkin harvojen ohjelmien lataamiseen tarvitaan lisäksi:
* wget
### 2. Asenna yle-dl
Asenna seuraavaksi yle-dl joko asentamalla esikäännetty paketti (ei
vaadi lähdekoodien lataamista):
pip3 install --user --upgrade yle-dl
tai lataamalla lähdekoodit ja ajamalla seuraava komento
lähdekoodihakemistossa:
python3 setup.py install --user
### 3. Lisää tarvittaessa hakemisto hakupolulle
Jos komentotulkki valittaa, ettei se löydä yle-dl:ää yrittäessäsi suorittaa ohjelmaa, lisää asennushakemisto hakupolulle näille komennoilla:
```
# Lisää polun komentotulkkin tämänhetkiseen sessioon
export PATH=$PATH:$HOME/.local/bin
# Tekee muutoksesta pysyvän. Tämä vaatii muokkaamista, jos käytät
# jotain muuta komentotulkkia kuin bash.
echo export PATH=$PATH:\$HOME/.local/bin >> ~/.bashrc
```
Käyttö
------
yle-dl [valitsimet] URL
tai
yle-dl [valitsimet] -i tiedosto
Korvaa URL webbi-osoitteella, missä ladatavaa ohjelmaa voisi katsoa
nettiselaimen kautta. URL voi olla joko Yle Areenan tai Elävän
arkiston osoite.
Valitsimet:
-o filename Tallenna striimi nimettyyn tiedostoon
-i filename Lue käsiteltävät URLit tiedostosta, yksi URL per rivi
--latestepisode Lataa viimeisimmän jakson sivulta
--showurl Tulostaa videon URL, ei lataa tiedostoa
--showtitle Tulostaa ohjelman nimen, ei lataa tiedostoa
--showmetadata Tulostaa metatietoja ohjelmasta. Katso docs/metadata.md
--vfat Tuota Windows-yhteensopivia tiedoston nimiä
--sublang lan Jätä tekstitykset lataamatta, jos lang on "none"
--resolution r Rajoita ladattavan striimin pystyresoluutiota
--maxbitrate br Rajoita ladattavan striimin bittinopeutta (kB/s)
--postprocess c Suorita ohjelma c onnistuneen latauksen jälkeen.
Ohjelmalle c annetaan parametriksi ladatun videotiedoston nimi
ja mahdollisten tekstitystiedostojen nimet.
--proxy uri Käytä HTTP(S)-proxyä. Esimerkki: --proxy localhost:8118
--destdir dir Aseta hakemisto mihin tiedostot tallennetaan
--pipe Ohjaa striimi stdout:iin, esim. "yle-dl --pipe URL | vlc -"
-V, --verbose Tulosta enemmän tietoja latauksen etenemisestä
Luettelon mahdollisista valitsimista (englanniksi) näkee
komentamalla
yle-dl --help
Lataaminen SOCKS5-proxyn kautta on mahdollista käyttämällä
tsocks-ohjelmaa.
Suorien TV-lähetysten tallentaminen
-----------------------------------
yle-dl https://areena.yle.fi/tv/suorat/yle-tv1
yle-dl https://areena.yle.fi/tv/suorat/yle-tv2
yle-dl https://areena.yle.fi/tv/suorat/yle-teema-fem
Tallenna tunti (eli 3600 sekuntia) sitten TV1:llä näytettyä lähetystä:
yle-dl --startposition -3600 https://areena.yle.fi/tv/suorat/yle-tv1
libav:n käyttö ffmpegin sijaan
------------------------------
yle-dl --ffmpeg avconv --ffprobe avprobe ...
Asetustiedosto
--------------
Kahdella viivalla (--) alkavien valitsimien arvot voi asettaa myös
asetustiedostossa. Asetukset luetaan tiedostosta ~/.yledl.conf tai
tiedostosta, jonka nimi annetaan --config-valitsimella. Lähdekoodien
mukana tulee esimerkkitiedosto yledl.conf.sample.
Asetustiedoston syntaksi: avain=arvo, avain=true.
Komentorivivalitsimet ohittavat asetustiedostossa annetut arvot, jos
sama valitsin on määritelty kummallakin tavalla.
Valmiit asennuspaketit
----------------------
Katso lista saatavilla olevista asennuspaketeista osoitteesta
https://aajanki.github.io/yle-dl/#packages
Integraatiotestien ajaminen
---------------------------
pytest-3
Jotkin testit onnistuvat vain suomalaisesta IP-osoitteesta, koska osa
Areenan videoista on saatavilla vain Suomessa. Oletuksena tällaiset
testit jätetään suorittamatta. Ajaaksesi myös nämä testit käytä
"--geoblocked"-vipua:
pytest-3 --geoblocked
Esimerkkejä
-----------
* Areenan ohjelman lataaminen automaattisesti nimettävään tiedostoon:
yle-dl https://areena.yle.fi/1-1544491
* Elävän arkiston ohjelman kaikkien jaksojen lataaminen:
yle-dl http://yle.fi/aihe/artikkeli/2010/10/28/studio-julmahuvi-roudasta-rospuuttoon
* Ohjelman lataaminen tiedostoon uutiset.mkv:
yle-dl https://areena.yle.fi/1-1544491 -o uutiset.mkv
* Lataa uusimmat uutiset
yle-dl --latestepisode https://areena.yle.fi/?q=uutiset
* Toistaminen suoraan videotoistimessa:
yle-dl --pipe https://areena.yle.fi/1-2409251 | mpv --cache=1000 --slang=fi -
* Ladatun tiedoston jatkokäsitteleminen skriptillä (katso esimerkki
scripts/muxmp4-tiedostossa):
yle-dl --postprocess scripts/muxmp4 https://areena.yle.fi/1-1864726