______________________________________________________________________________

YouTube Downloader v0.57                                  (C) 2009, 2010 Pepak
http://www.pepak.net/download/youtube-downloader/         http://www.pepak.net
______________________________________________________________________________

Nstroj pro stahovn videa z YouTube a dalch webovch loi videa. Funguje 
z pkazov dky, odkud pijme libovoln poet URL ke staen, ppadn
soubor se seznamem URL. Soubory ukld pod nzev z YouTube, preferuje
HD video, pokud je k dispozici.



PODPOROVAN WEBY
----------------

 - 5min.com:
     - http://www.5min.com/Video/Customizable-Xbox-360-Controller-Brings-Gaming-to-the-Disabled-299179952

 - Aktualne.cz:
     - http://aktualne.centrum.cz/video/?id=316586

 - AlternativaTV.cz:
    - http://alternativatv.cz/hudba/play/12102/?hiq=1
    - http://alternativatv.cz/video/play/12225/
    - http://alternativatv.cz/encyklopedie/play/86
    - http://alternativatv.cz/magazin/priloha/9319/12292
    - http://alternativatv.cz/film/play/9911/
    - http://alternativatv.cz/scena/play/12307/

 - AngryAlien.com:
     - http://www.angryalien.com/0605/freddyjasonbuns.asp

 - AutoTube.cz:
     - http://www.autotube.cz/roadtube/612-jak-na-dopravni-zacpu.html

 - Barrandov.tv:
     - http://www.barrandov.tv/54698-nikdy-nerikej-nikdy-upoutavka-epizoda-12

     Pozn.: Jde o streamovan formt podle protokolu RTMP. Viz ne.
     Pehrt jde napklad programem The KMPlayer.

 - Bing.com:
     - http://www.bing.com/videos/watch/video/surfer-mounts-hd-camera-to-board/1abwgqhhl

 - Blenus.com:
     - http://www.blennus.com/index.php?option=content&task=view&id=1027&Itemid=

 - Blip.tv:
     - http://blip.tv/play/hIVV4tIUAg
     - http://blip.tv/file/1607673/
     - http://thespoonyone.blip.tv/file/1607673/

 - Bofunk.com:
     - http://www.bofunk.com/video/10444/ingenious_way_to_mow_your_grass.html

 - Bolt.com (BoltAgain.ning.com):
     - http://boltagain.ning.com/video/vacation-wellness

 - Bomba.cz:
     - http://www.bomba.cz/video/simpsnovi-vs-cesti-politici/

 - Break.com
     - http://www.break.com/usercontent/2007/10/South-Africa-Win-Rugby-World-Cup-385706.html
     - http://embed.break.com/MzU5NDE4
     - http://media1.break.com/static/app/v1/global/swf/player10.swf?sVidLoc=http%3a%2f%2fvideo1.break.com%2fdnet%2fmedia%2f2007%2f8%2fdude-blows-off-firecracker-in-teeth.flv&sThumbLoc=http%3a%2f%2fmedia1.break.com%2fdnet%2fmedia%2f2007%2f8%2fdude-blows-off-firecracker-in-teeth.jpg&contentURL=http%3a%2f%2fwww.break.com%2findex%2fdude-blows-off-firecracker-in-teeth.html&sShareURL=http%3a%2f%2fwww.break.com%2findex%2fdude-blows-off-firecracker-in-teeth.html%23TellAFriendhttp%3a%2f%2fstats.break.com%2finvoke.txt&iContentID=359418&autoplay=0&embed=2&contentidencoded=359418&categoryid=4&userid=1620903&mode=embed&linktitle=Funny+Videos&sVidTitle=EMBED-Dude+Blows+Off+Firecracker+In+Teeth&icon=1B608EE7AFCE3765E176F3C6FBB98002B3D18C64572F2307D76FAB7CA970F3B1D7D7

 - Cas.sk
     - http://www.cas.sk/clanok/172890/testovanie-brzd-trochu-inak.html
     - http://adam.cas.sk/clanky/7431/moto-aston-martin-rapide-2011.html

 - CekniTo.cz / CekniTo.sk
     - http://www.ceknito.cz/video/446074

 - CeskaTelevize.cz
     - http://www.ceskatelevize.cz/ivysilani/309292320520025-den-d-ii-rada/
     - http://www.ceskatelevize.cz/program/port/541-elektronicke-knihy/
     - http://www.ceskatelevize.cz/program/10252893246-07.08.2010-08:32-24-prizma.html

     Pozn.: Jde o streamovan formt podle protokolu RTSP over HTTP. Viz
     ne v poznmkch ke knihovn MSDL_DLL.DLL.

 - CestyKSobe.cz:
     - http://www.cestyksobe.cz/novinky/nejnovejsi-a-nejzajimavejsi-porady/642.html

 - Clipfish.de:
     - http://www.clipfish.de/video/3306089/baby-kaenguruh-versucht-zu-schwimmen/
     - http://www.clipfish.de/special/lets-dance/home/

 - CrunchyRoll.com:
     - http://www.crunchyroll.com/library/Naruto_Shippuden

     Pozn.: This provider usesTento poskytovatel pouv protokol RTMP. Viz
     poznmky ne.

 - CSmaTalent.cz, CSmaTalent.sk:
     - http://www.csmatalent.cz/epizody-cz/detail/divadlo-29-8-2010.html
     - http://www.csmatalent.sk/epizody/detail/divadlo-29-8-2010.html

 - CT24.cz:
     - http://www.ct24.cz/regionalni/87267-vrchlabsky-zamek-ma-vlastni-miniaturu/video/1/
     - http://www.ct24.cz/regionalni/87267-vrchlabsky-zamek-ma-vlastni-miniaturu/

     Pozn.: Skutenm poskytovatelem je esk televize a plat proto vechno,
            co pro CeskaTelevize.cz.

 - Current.com:
     - http://current.com/shows/the-rotten-tomatoes-show/92561962_angelina-jolies-top-5-hottest-parts.htm

 - DailyHaha.com:
     - http://www.dailyhaha.com/_vids/dog-chasing-shadow.htm

 - DailyMotion.com:
     - http://www.dailymotion.com/video/x8w3pf_condoms-are-bady_fun

 - DeutscheBahn.com:
     - http://bewegtbild.deutschebahn.com/btvo/site/index.php?s=5600&ids=143306

 - DevilDucky.com:
     - http://www.devilducky.com/media/213159/

 - DoubleAgent.com:
     - http://www.doubleagent.com/agent/tiffany/video-blog/video-28
     - http://www.doubleagent.com/play/are-you-a-tweetbook-twit

 - EbaumsWorld.com:
     - http://www.ebaumsworld.com/video/watch/80973186/

 - eHow.com:
     - http://www.ehow.com/video_4871930_clean-computer-monitor-glass.html

 - ESPN.go.com:
     - http://espn.go.com/video/clip?id=5163631

 - EVTV1.com:
     - http://www.evtv1.com/player.aspx?itemnum=15099&aid=

 - Facebook.com:
     - http://www.facebook.com/video/video.php?v=1131482863478

 - FileCabi.net:
     - http://www.filecabi.net/video/hiddendogstopsrobbery.html

 - Flickr.com:
     - http://www.flickr.com/photos/landersz/2403626167/

 - Free.Zoznam.sk:
     - http://free.zoznam.sk/video/Splhajuci-buldozer

 - FreeCaster.tv:
     - http://freecaster.tv/freeski/1012253

 - FreeRide.cz:
     - http://www.freeride.cz/snowboard/clanky/trix/tricktip-fs-grind-fs-revert-by-honza-smekal--9323/
     - http://www.freeride.cz/snowboard/video/freeridecz-karneval-2010-by-shymonkey--9121/

 - FreeVideo.ru:
     - http://freevideo.ru/video/view/?id=v14445361101

 - GameAnyone.com:
     - http://www.gameanyone.com/game/PC/936.html
     - http://www.gameanyone.com/video/88319

 - GodTube.com:
     - http://www.godtube.com/featured/video/jesus-your-co-pilot-or-leader

 - GrindTV.com:
     - http://www.grindtv.com/surf/video/surfing_ancientstyle_surfboards_in_peru_wred_bull_team/

 - Guba.com:
     - http://www.guba.com/watch/3000693318/Pulp-Fiction-Laugh-Track

 - iHned.cz:
     - http://video.ihned.cz/c1-44411910-sef-narodniho-muzea-kdyz-zafouka-vitr-vypadne-nam-za-noc-az-deset-oken

 - ima.umn.edu:
     - http://www.ima.umn.edu/videos/?id=1187

     Pozn.: Jde o streamovan formt podle protokolu RTMP. Viz ne.

 - iPrima.cz:
     - http://www.iprima.cz/videoarchiv/44524/all/all
     - http://www.iprima.cz/videoplayer/85680

 - Joj.sk:
     - http://televizia.joj.sk/tv-archiv/krimi-noviny/22-05-2010.html

 - Kukaj.sk:
     - http://www.kukaj.sk/videa/5860/

 - LibimSeTi.cz:
     - http://video.libimseti.cz/basket-trosku-jinak/f1ea1c7fcc03?uid=

 - LiveLeak.com:
     - http://www.liveleak.com/view?i=6f4_1272904024
     - http://www.liveleak.com/e/57d_1278546690

 - LiveVideo.com:
     - http://www.livevideo.com/liveshow/brian3maria

 - Markiza.sk:
     - http://video.markiza.sk/archiv-tv-markiza/dnes/36829

     Pozn.: Poady mohou bt tvoeny nkolika rznmi video soubory.

 - MediaSport.cz:
     - http://www.mediasport.cz/rally-cz/video/09_luzicke_cerny_rz1.html

     Pozn.: Nzev videa nen nikde na strnce dostupn, pouv se proto
            pvodn nzev, jak je soubor uloen na serveru.

 - MegaVideo.com:
     - http://www.megavideo.com/?v=2MJBY4HB

 - MetaCafe.com:
     - http://www.metacafe.com/watch/4577253/kick_ass_release_trailer/

 - MojeVideo.cz:
     - http://mojevideo.cz/view.php?id=5332

 - Mpora.com:
     - http://video.mpora.com/watch/xfnGGmZDC/

 - MSFotbal.CT24.cz:
     - http://msfotbal.ct24.cz/article.asp?id=339
     - http://msfotbal.ct24.cz/video.asp?video_id=95
     - http://msfotbal.ct24.cz/video.asp

     Pozn.: Skutenm poskytovatelem je esk televize a plat proto vechno,
            co pro CeskaTelevize.cz.

 - MustWatch.hztz.cz:
     - http://mustwatch.hztz.cz/film/lecba-rakoviny-zevnitr-healing-cancer-from-inside-out/

 - Muzu.tv:
     - http://www.muzu.tv/elizarickman/cinnamon-bone-music-video/670078?country=cz

 - MySpace.com
     - http://vids.myspace.com/index.cfm?fuseaction=vids.individual&videoid=63620005

     Pozn.: Jde o streamovan formt podle protokolu RTMP. Viz ne.

 - Myubo.sk:
     - http://www.myubo.sk/page/media_detail.html?movieid=deac5b36-9efe-4176-a1e9-01088aa24696

 - N-joy.cz:
     - http://n-joy.cz/video/shank-5-minut-hrani/il18d8bbuynet5gk

 - NavratDoReality.cz:
     - http://navratdoreality.cz/?p=view&id=5766

 - NothingToxic.com:
     - http://www.nothingtoxic.com/media/1279921781/Bad_Doggie_Eats_An_Entire_Swiffer_Mop

 - Nova.cz:
     - http://archiv.nova.cz/multimedia/ulice-1683-1684-dil.html

     Pozn.: Jde o streamovan formt podle protokolu RTMP. Viz ne.
     Pehrt jde napklad programem The KMPlayer.

 - Novinky.cz:
     - http://video.novinky.cz/video/doporucujeme/?videoId=10869&page=1

 - OverStream.net:
     - http://www.overstream.net/view.php?oid=uinsn9n7uomx
     - http://www.overstream.net/swf/player/oplx?oid=m8t4s4uzibl0

 - PCPlanets.com:
     - http://www.pcplanets.com/videos-225353-Bamboo.shtml

     Pozn.: Poskytovatel by ml fungovat, ale vytrvale vrac HTTP chybu 403
     (forbidden). Stejn se ovem chov i samotn flashov pehrva, zejm
     tedy nejde o chybu v YTD ale bu o chybn video nebo nap. nepodporovan
     stt uivatele.

 - PublicTV.cz:
     - http://www.publictv.cz/cz/menu/3/videoarchiv/clanek-535-re-play/1718/
     - http://www.publictv.cz/videoarchiv/535/1718/

 - Raajje.tv:
     - http://www.raajje.tv/video/991/president-anni-diving

 - Revver.com:
     - http://www.revver.com/video/2378230/super-mario-bros-2-on-the-nes-level-x/

 - RingTV.com:
     - http://www.ringtv.com/video/frankie_gomez_training/

 - Rozhlas.cz:
     - http://www.rozhlas.cz/vltava/porady/_zprava/676996

     Pozn.: Poady mohou bt tvoeny nkolika rznmi audio soubory.

 - RuTube.ru:
     - http://rutube.ru/tracks/3201791.html?v=ee2f0d03562f2cf3b28e6cad55f353e4

 - SevenLoad.com:
     - http://en.sevenload.com/shows/Food-Drink/episodes/4YXLHBt-How-To-Make-Elegant-No-Bake-Cheesecake

 - Snotr.com:
     - http://www.snotr.com/video/4280

 - Spike.com:
     - http://www.spike.com/video/prince-of-persia/3355664

 - Stagevu.com:
     - http://stagevu.com/video/jomxdgbvxnip

 - Stickam.com:
     - http://www.stickam.com/viewMedia.do?mId=188284575

 - Stream.cz:
     - http://www.stream.cz/video/437197-meziplyn-30

     Pozn.: V obsluze stream.cz je chyba, kvli kter nkdy video sthnout
     jde a jindy nejde. Pina nen znma, vypad ale na njak asovac
     problm v knihovn Synapse, protoe sta vloit na vhodn msto 
     breakpoint nebo prodlevu a hned problm zmiz.

     Pozn.: Stream.cz slou jako content-delivery-network pro adu dalch
     slueb, napklad pro televizn stanici ko.

 - StreetFire.com:
     - http://www.streetfire.net/video/porsche-911-gt2_2007066.htm

 - StupidVideos.com:
     - http://www.stupidvideos.com/tv/homepage_1/Amazing_Aquarium/
     - http://www.stupidvideos.com/video/Fliers_Fall_Under_Friendly_Fire/?m=new

 - STV.LiveTV.sk (Slovensk televzia):
     - http://stv.livetv.sk/tvarchive//video/video.html?video=52655

     Pozn.: Nzev videa nen nikde na strnce dostupn, pouv se proto
            pvodn nzev, jak je soubor uloen na serveru.
     Pozn.: Jde o streamovan formt podle protokolu RTSP over HTTP. Viz
     ne v poznmkch ke knihovn MSDL_DLL.DLL.

 - Tangle.com:
     - http://www.tangle.com/view_video?viewkey=fe586286e688a7cb197e

 - TeacherTube.com:
     - http://teachertube.com/viewVideo.php?video_id=177149&title=Top_10_Mistakes_New_Teachers_Make

 - TodaysBigThing.com:
     - http://www.todaysbigthing.com/2010/06/01

 - Tontuyau.com:
     - http://www.tontuyau.com/v.asp?id=21715

 - TotallyCrap.com:
     - http://www.totallycrap.com/videos/videos_man_tries_to_commit_suicide_by_laying_under_a_truck/

     Pozn.: Jde o streamovan formt podle protokolu RTMP. Viz ne.

 - TV7.cz:
     - http://www.tv7.cz/?vid=1062

 - TVNoe.tbsystem.cz (TV Noe):
     - http://tvnoe.tbsystem.cz/index.php?cs/videoarchiv/hlubinami-vesmiru-2010-04-12-mikulasek

 - TVcom.cz:
     - http://bojove-sporty.tvcom.cz/video/545-budo-show-zlin-2006-dil-1.htm

     Pozn.: Jde o streamovan formt podle protokolu RTSP over HTTP. Viz
     ne v poznmkch ke knihovn MSDL_DLL.DLL.

 - TVPraha11.cz (Metropol TV):
     - http://www.tvpraha11.cz/zastupitelstvo/index.php?file=9285&jednani=66

 - UStream.tv:
     - http://www.ustream.tv/recorded/7022540

 - VideaCesky.cz:
     - http://www.videacesky.cz/serialy/upoutavka-na-treti-radu-the-guild

 - VideoAlbumy.azet.sk:
     - http://videoalbumy.azet.sk/land-rover/A1OFbSJBBXOF6yyp/

 - VideoClipsDump.com:
     - http://www.videoclipsdump.com/media/1951/Karate_Fail/

 - Videu.de:
     - http://www.videu.de/video/4etN3FlaaY

 - Vimeo.com:
     - http://www.vimeo.com/10777111

 - VitalMtb.com:
     - http://www.vitalmtb.com/videos/member/Practice-at-the-bmx-track,2631/bubb120491,1836

 - Wimp.com:
     - http://www.wimp.com/frazilice/

 - Wrzuta.pl:
     - http://w772.wrzuta.pl/film/7KI3ZUDHrUK/
     - http://goovnoh.wrzuta.pl/audio/8U1t8UQ4f8W/

 - Youtube.com:
     - http://www.youtube.com/v/b5AWQ5aBjgE
     - http://www.youtube.com/watch/v/b5AWQ5aBjgE
     - http://www.youtube.com/watch?v=b5AWQ5aBjgE
     - http://www.youtube.com/view_play_list?p=90D6E7C4DE68E49E
     - http://www.youtube.com/titanicpiano14
     - http://www.youtube.com/user/titanicpiano14

 - ZkoukniTo.cz:
     - http://www.zkouknito.cz/video_59813_holcicka-strasila-medveda



Podporovan porno weby:

 - Dachix.com
 - EmpFlix.com
 - ExtremeTube.com
 - Grinvi.com
 - KeezMovies.com
 - MegaPorn.com
 - PornHost.com
 - PornHub.com
 - PornoTube.com
 - RedTube.com
 - Rude.com
 - Shufuni.com
 - SlutLoad.com
 - SpankingTube.com
 - SpankWire.com
 - TnaFlix.com
 - Tube8.com
 - XHamster.com
 - XNXX.com
 - XTube.com
 - XVideoHost.com
 - XVideos.com
 - YouJizz.com
 - YouPorn.com
 - Yuvutu.com



PROTOKOL RTMP
-------------

Od verze 0.15 program zahrnuje podporu pro streamovan video podle protokolu
RTMP. Protokol je implementovn pomoc knihovny vznikl drobnou pravou 
projektu RTMPDUMP (http://rtmpdump.mplayerhq.hu). Tato implementace m adu
nedostatk, se ktermi je teba potat:

1) Neum pesn urit celkovou velikost videa. Velikost je odhadovna na
   zklad dosud staen velikosti, dosud staenho asu a celkovho asu
   videa.

2) Z knihovny nejsou do Downloaderu pedvny informace o chybch. Msto
   toho je v TEMP adresi uivatele generovn klasick log projektu RTMPDUMP,
   ve kterm lze piny ppadnch chyb dohledat.

3) Aby lo stahovat z RTMP stream, jsou vyadovny nsledujc DLL knihovny:
   - RTMPDUMP_DLL.DLL - je soust YTD.
   - CRYPTOEAY32-0.9.8.DLL - soust OpenSSL verze 0.9.8. V OpenSSL me bt
       pojmenovna i CRYPTOEAY32.DLL.
   - SSLEAY32-0.9.8.DLL - soust OpenSSL. Alternativn jmno SSLEAY32.DLL.

4) Nelze stoprocentn detekovat, zda bylo video staeno kompletn.



PROTOKOLY MMS/RTSP
------------------

Od verze 0.17 je podporovna rodina protokol kolem MMS a RTSP (mimo jin
Microsoft streamy, Real streamy a ada dalch). Protokol je implementovn
pomoc knihovny vznikl drobnou pravou projektu MSDL (http://msdl.sf.net/).
Potejte s tm, e clem bylo mt pravu hotovou rychle a s minimem zmn
v pvodnm projektu (podobn jako u podpory RTMP ve), take jsem spoustu
monch variant prost ignoroval; a je budu potebovat, rozm pslun
pravy MSDL.

Pozn.: Celkov velikost stahovanho streamu je jen odhad, kter nemus bt
pln pesn. Klidn se me stt, e penos skon v 93 % a pesto se
ohls jako spn - a pehrnm skuten zjistte, e stream je staen
kompletn.



PLAYLISTY
---------

Od verze 0.19 jsou podporovny zdroje, ve kterch je jeden poad tvoen
nkolika samostatnmi medilnmi soubory (nap. Markiza.sk). YouTube
Downloader momentln neumouje vybrat, kter ze soubor se sthnou a
kter ne - stahuj se vdy vechny.



KONVERZE STHNUTCH SOUBOR
---------------------------

Od verze 0.50 podporuje YouTube Downloader funkci, kter do jist mry
umouje konvertovat sthnut soubory do jinch formt - nabz rozhran,
pomoc kterho lze po dokonen downloadu nebo po kliknutm na pslun
tlatko v grafickm prosted spustit extern aplikaci a pedat j jmno
sthnutho souboru (a ppadn dal parametry). Tato extern aplikace pak
me udlat cokoliv, vetn konverze do jinho formtu. 

V demonstranch konfiguranch souborech jsou nadefinovny ti zkladn
konverze, vyuvajc program MEncoder (soust projektu MPlayer, domovsk
strnka http://www.mplayerhq.hu) pro

a) pevod videa do kontejneru AVI. Tato funkce je velmi rychl a nedochz
   pi n ke zmn kvality, nemus ale fungovat pro vechny vstupn formty
   (nap. pro mnoho soubor .FLV, ne-li pro vechny) a hlavn zmn jenom
   kontejner, ale ne obsah, take pro pehrn stle potebujete kodeky,
   kter byly poteba pro pvodn video. Vznam konverze je vcemn omezen
   jen na programy, kter nepodporuj jin kontejnery ne AVI.

b) konverzi videa do kontejneru AVI s kodekem XVID+MP3. Zde u jde o plnou
   rekompresi, s vlastnostmi v zsad opanmi ne u pevodu kontejneru -
   je to pomal a dochz ke ztrt kvality, ale funguje to pro (skoro)
   vechny vstupn soubory a vsledek pak pehrajete v kadm pehrvai,
   pokud ovem podporuje kodek XVID (to u jsou dnes snad vechny).

c) konverzi videa do kontejneru AVI s kodekem H264+MP3. Plat to sam co pro
   pedchoz ppad.

Pro vechny ti varianty jsou nastaveny njak zkladn parametry, ovem 
zdrazuji, e moje zkuenosti s konverzemi jsou miziv a tud ty parametry
s jistotou nebudou optimln. Nebute tedy pekvapeni dosaenmi vsledky.
Pokud se najde njak expert ochotn moje nastaven zoptimalizovat, budu jen
rd.

Co potebujete udlat pro to, aby konverze chodily:

1. Sthnout si a nainstalovat kompletn MPlayer (obsahuje i MEncoder.exe).

2. MEncoder.exe zkoprovat do adrese v PATH nebo do adrese, kde je
   nainstalovan YouTube Downloader.

3. Aktivovat konvertovn. Slou k tomu nastaven <converters><activated>,
   kter je standardn nastaveno na hodnotu 0 (nula) a kter muste pepsat
   na hodnotu 1. Konfiguran soubor zobrazte pmo z programu tlatkem
   "Upravit konfiguran soubor", pak v nm najdte "<activated>" (bez 
   uvozovek) a pepite nulu za nm na jedniku.

4. a) Pokud chcete automaticky zkonvertovat vechny soubory:

      V grafickm prosted kliknout na ikonku "Vybrat konvertova" (film s
      tukou) a vybrat si jeden z pednastavench konvertova. Od t chvle
      budou vechny nov staen soubory pedhozeny tomuto konvertovai
      (ve vchozm stavu jeden po druhm, program je nastaven tak, aby 
      v jednu chvli automaticky bel jen jeden konverzn proces).

   b) Pokud chcete zkonvertovat jen soubory, kter sm urte:

      V grafickm prosted vybrat jeden nebo vce soubor a kliknout na
      ikonu "Zkonvertovat" (film se zelenou ipkou). Konverze bude sputna
      pro vechny zvolen filmy, bez ohledu na to, kolik jich je a jestli
      byly spn dokoneny.

Pokroil uivatel mohou zsahem do konfigurace zmnit nastaven tchto
loh nebo pidat lohy pln nov. Pokud vm nevyhovuje MEncoder, mete
pout jin program - a nemuste se vbec omezovat na programy pro konverzi
videa, funkce je napsna natolik obecn, abyste mohli teba spustit njak
BAT skript nebo video nkomu poslat mailem. Popis dostupnch nastaven je
uveden ne v sekci Konfigurace.

Ve verzi spoutn z pkazovho dku tato funkce podporovna nen - tuto
verzi je mon skriptovat "samu od sebe" a m pipad zbyten zavdt
duplicitn funkci, kter pinese jen zven riziko chyb a dnou skutenou
vhodu.



KONFIGURACE
-----------

Od verze 0.50 pouv YouTube Downloader pro svoji konfiguraci XML soubor
"ytd.xml". Umstn me bt ve dvou mstech:

1) Adres, ve kterm je YTD.exe. Toto je primrn umstn.

2) Adres "YouTube Downloader" v uivatelskm profilu Windows (%APPDATA%).
   Toto umstn se zkoum v ppad, e primrn XML soubor neexistuje
   nebo e je v nm pro aplikaci vypnut penositeln (portable) reim.

Konfiguran parametry jsou vdy ukldny jako obsahy XML tag. V souladu
s XML standardem jsou nzvy tag citliv na velikost psmen (case-sensitive);
jejich obsahy obecn citliv nejsou (case-insensitive), ale je vhodn pouvat
v nich jen mal psmena. Logick hodnoty (ano-ne) jsou ukldny jako "1" (ano)
a "0" (ne).

<ytd> 
  - Koenov prvek; jeho nzev me bt v zsad libovoln, program to (zatm) 
    nekontroluje. Obsahuje vechna nastaven.

<config>
  - Potomek <ytd>; obsahuje zkladn konfiguraci spolenou pro grafickou i 
    textovou verzi programu.

  <portable_mode>
    - Potomek <config>; obsahuje logickou hodnotu urujc, jestli YTD pracuje
      v penositelnm (portable) nebo standardnm reimu. Ani jeden z reim
      nezapisuje do registru Windows, li se vak tm, do kterho XML souboru
      jsou ukldna uivatelsk nastaven: v portable reimu se zapisuj do 
      souboru "ytd.xml" v adresi, ve kterm je program nahrn (a kde tedy 
      mus bt prvo zpisu, pokud se m konfigurace ukldat spn), ve 
      standardnm reimu se ukldaj do "ytd.xml" v uivatelskm profilu (kde 
      je za bnch okolnost prvo zpisu vdy).
    - Mon hodnoty jsou "1" (zapnout portable reim) a "0" (vypnout).
    - Vchoz hodnota je "0".

  <language_mode>
    - Potomek <config>; uruje, jak jazyk m bt pouit pro zobrazen text
      programu. 
    - Monmi hodnotami jsou dvouznakov ISO kdy jazyk, viz sekce Lokalizace
      ne. Povolen je i przdn etzec, kter zna jazyk podle nastaven
      operanho systmu.
    - Vchoz hodnota je przdn etzec (jazyk podle nastaven OS).
    - Pozor: V distribunm archvu jsou k dispozici jazykov soubory jen pro
      etinu ("cs") a anglitinu ("en"); dal jazyky ekaj na to, a je 
      nkdo pelo.

  <destination_path>
    - Potomek <config>; uruje, do kterho adrese se maj videa ukldat.
    - Monou hodnotou je bu przdn etzec (zna aktuln pracovn adres,
      co je obvykle adres, ze kterho byl program sputn), nebo libovoln
      platn cesta, absolutn ("c:\download") i relativn ("..\downoad").
      V ppad portable verze doporuuji vyhnout se absolutnm cestm a 
      pouvat bu przdn etzec nebo cestu relativn,
    - Vchoz hodnota je przdn etzec (aktuln pracovn adres).
    - Odpovd parametru -o na pkazov dce.

  <error_log>
    - Potomek <config>; uruje, do kterho souboru se bude ukldat seznam URL,
      kter se z njakho dvodu nepodailo sthnout.
    - Monou hodnotou je bu przdn etzec (k, e se seznam chybnch URL
      ukldat nebude) nebo cesta k souboru.
    - Vchoz hodnota je przdn etzec (neukldat seznam chyb).
    - Grafick verze programu tuto poloku nepouv.
    - Odpovd parametru -e na pkazov dce.

  <overwrite_mode>
    - Potomek <config>; k, jak se m program zachovat v ppad, e pi
      ukldn videa naraz na existujc soubor.
    - Mon hodnoty jsou:
        "ask" - zeptat se uivatele na akci.
        "never" - peskoit soubor (pedpoklad: u byl staen dve).
        "always" - pepsat soubor (pedpoklad: pedchoz verze je chybn).
        "rename" - pojmenovat nov soubor tak, aby ml jedinen jmno
                   (pedpoklad: pvodn soubor je jin ne ten, co stahuji 
                   te).
    - Vchoz hodnota je "ask" (zeptat se uivatele).
    - Odpovd parametrm -k (ask), -n (never), -a (always), -r (rename) na
      pkazov dce.

  <proxy_server>
    - Potomek <config>; umouje nastavit proxy server pro vai s. Proxy 
      server je v souasn dob podporovn a oven pro protokoly HTTP a 
      MMS/RTSP. V ppad protokolu RTMP se mi nepodailo funknost ovit.

    <active>
      - Potomek <proxy_server>; k, jestli je proxy server aktivn (bude
        se pouvat) nebo neaktivn.
      - Mon hodnoty jsou "1" (pouvat proxy) a "0" (nepouvat proxy).
      - Vchoz hodnota je "0" (nepouvat proxy).

    <host>
      - Potomek <proxy_server>; uruje adresu, na kter proxy server ek.
      - Mon hodnoty: przdn etzec (nepouvat proxy) nebo libovoln
        ppustn internetov adresa (seln nebo domnov jmno).
      - Vchoz hodnota je przdn etzec (nepouvat proxy).

    <port>
      - Potomek <proxy_server>; uruje port, na kterm proxy server ek.
      - Mon hodnoty: sla od 1 do 65535. Bn jsou hodnoty 3128, 8080.
      - Vchoz hodnota je 3128.

    <user>
      - Potomek <proxy_server>; uruje uivatelsk jmno, kterm se svmu
        proxy serveru pihlaujete. Podporovno je pouze pro protokol HTTP
        a jeho funknost nen ovena.
      - Monou hodnotou je libovoln platn uivatelsk jmno nebo przdn
        etzec (autorizace se nepouv).
      - Vchoz hodnotou je przdn etzec (autorizace se nepouv).

    <password>
      - Potomek <proxy_server>; uruje heslo pro pihlen k proxy serveru.
      - Monou hodnotou je jakkoliv etzec.
      - Vchoz hodnotou je przdn etzec (bez hesla).

<gui>
  - Potomek <ytd>; obsahuje nastaven specifick pro grafickou verzi programu.
    Za normlnch okolnost tyto daje nemnte run, ale nap. kliknm na
    tlatka a podobn.

  <auto_start_downloads>
    - Potomek <gui>; k, jestli se maj nov pidan odkazy automaticky
      spoutt nebo jestli si je spustte sami run tlatkem Start.
    - Mon hodnoty jsou "1" (spoutt automaticky) a "0" (pokat na dost
      uivatele).
    - Vchoz hodnotou je "1" (spoutt automaticky).

  <check_for_new_version>
    - Potomek <gui>; uruje, jestli se m program pi sputn grafick verze
      pokusit o zjitn dostupnosti novjch verz. I v ppad, e test
      zakete, me program novou verzi zjistit, ale jen na vydn - bu 
      parametrem -v na pkazovm dku nebo tm, e otevete okno "O 
      aplikaci".
    - Mon hodnoty jsou "1" (zjiovat verze) a "0" (nezjiovat).
    - Vchoz hodnotou je "1" (testovat novou verzi).

<modules>
  - Potomek <ytd>. V tto sekci se nachzej specifick nastaven pro 
    jednotliv poskytovatele.

  <CeskaTelevize_cz>
    - Potomek <modules>; obsahuje nastaven pro eskou televizi a odvozen
      odkazy (Port, T24 atd.).

    <prefer_real_media>
      - Potomek <CeskaTelevize_cz>; uruje, ve kterm formtu se bude video
        stahovat.
      - Mon hodnoty jsou "0" (pouvat formty Microsoftu) a "1" (pouvat
        formty Real Media).
      - Vchoz hodnotou je "0" (stahovat ve formtech Microsoft).

<converters>
  - Potomek <ytd>. V tto sekci jsou nadefinovny parametry jednotlivch 
    konvertova (aplikac volanch funkc Konverze nebo automaticky po
    sthnut filmu).

  <activated>
    - Potomek <converters>; slou programu jako dkaz, e uivatel etl 
      dokumentaci a je si tud vdom toho, e konvertovn nebude fungovat
      samo od sebe, ale je teba ho naped vhodnm zpsobem nastavit.
    - Mon hodnoty jsou "0" (konvertery nejsou aktivovny) a "1" (jsou).
    - Vchoz hodnotou je "0" (konvertory nejsou aktivovny).

  <selected>
    - Potomek <converters>; uruje, kter konvertova se m automaticky pout
      pro vechny sthnut filmy.
    - Mon hodnoty jsou przdn etzec (automatick konverze se nebude
      provdt) nebo nkter hodnota atributu "id" poloek <converter> (viz
      dle).
    - Vchoz hodnotou je przdn etzec (neprovdt automatick konverze).

  <max_threads>
    - Potomek <converters>; uruje, maximln kolik automatickch konverznch 
      loh sm soubn probhat. Doporuuji nechat zde hodnotu 1, a pokud u
      ji budete zvyovat, nezvyujte ji nad poet procesor ve vaem potai.
      I to me bt pli, pokud chcete mt rychlou odezvu systmu.
    - Mon hodnoty jsou sla od nuly ve, piem nula vypn automatick
      konverze.
    - Vchoz hodnotou je 1.

  <converter>
    - Potomek <converters>; kad vskyt tto poloky definuje jeden konkrtn 
      konvertova. Kad konvertova mus mt atribut "id" s njakou jedinenou 
      hodnotou, kter bude pouita do <selected>.

    <title>
      - Potomek <converter>; obsahuje nzev, kter se bude zobrazovat uivateli
        ve formuli pro vbr konvertovae.
      - Monou hodnotou je libovoln etzec. Program sm s nm nijak nepracuje,
        jen ho zobrazuje uivateli, proto je vhodn zvolit nco popisnho.
      - Vchoz hodnotou je przdn etzec.

    <exe_path>
      - Potomek <converter>; uruje nzev programu nebo skriptu, kter se m 
        spustit. Pokud nen program v PATH nebo v adresi YouTube Downloaderu,
        mus zde bt uvedena cel cesta.
      - Monou hodnotou je libovoln cesta, me obsahovat i mezery (v takovm
        ppad ji NEDVEJTE do uvozovek).
      - Vchoz hodnotou je przdn etzec.

    <command_line>
      - Potomek <converter>; obsahuje pkazovou dku, kter bude programu
        pedna. Krom pevnch parametr (nap. -ovc copy -oac copy) zde mohou
        bt i promnn, kter YouTube Downloader nahrad skutenmi daji.
        Jsou to:

          {$FULLPATH} .... cel cesta k souboru
          {$FILENAME} .... pouze nzev souboru bez cesty
          {$FILEPATH} .... jen adres souboru (cesta souboru bez nzvu)
          {$FILEEXT} ..... ppona souboru, vetn teky
          {$FILENOEXT} ... nzev souboru bez cesty a bez ppony
          {$TITLE} ....... nzev filmu (nap. pro ely tagovn)


      - Monou hodnotou je libovoln etzec, i przdn.
      - Vchoz hodnotou je przdn etzec.

    <visibility>
      - Potomek <converter>; uruje, jak se m konvertova spoutt.
      - Mon hodnoty jsou "visible" (standardn sputn), "minimized"
        (konvertova se spust normln, ale jeho okno bude minimalizovno)
        a "hidden" (konvertova se spust neviditeln).
      - Vchoz hodnota je "minimized".



SYNTAXE
-------

  ytd.exe <param> [<param>] [<param>] ...

  kde <param> je bu URL, nebo jedna z nsledujcch monost:

    -?, -h ........ Zobraz npovdu.
    -i <soubor> ... Sthne vechna URL z textovho souboru <soubor>, kde
                    kad dek reprezentuje jednu URL.
    -o <cesta> .... Soubory se budou stahovat do adrese <cesta>. Vchoz
                    hodnotou je aktuln pracovn adres.
    -e <soubor> ... Do souboru <soubor> se budou zapisovat vechny downloady,
                    kter skonily chybou.
    -s <zdroj> .... <zdroj> (soubor nebo URL) se prohled na podporovan
                    odkazy a ty nalezen se sthnou.
    -l ............ Zobraz seznam podporovanch poskytovatel mdi.
    -v ............ Zkontroluje dostupnost novj verze programu.
    -n ............ Nikdy nepepisovat existujc soubory.
    -a ............ Vdy pepsat existujc soubory.
    -r ............ Pokud soubor se stejnm nzvem existuje, automaticky
                    vygenerovat nov nzev, kter u bude jedinen.
    -k ............ Pokud soubor existuje, zeptat se uivatele (vchoz).

  Nap.: ytd.exe "http://www.youtube.com/watch?v=6wXkI4t7nuc"
         ytd.exe -i c:\temp\seznam.txt
         ytd.exe -a "http://www.youtube.com/watch?v=6wXkI4t7nuc"

  Pokud nejsou uvedeny parametry, spust se grafick verze programu.



NVRATOV KDY
--------------

Verze pro pkazov dek podporuje nvratov kdy (errorlevel). Mon hodnoty
jsou:

  0 ..... Operace a vechny downloady probhly spn. 
          Pozor! V ppad stahovn z playlistu nebo ze souboru s URL sta,
          aby se spn sthnul libovoln odkaz. Pokud chcete vyuvat 
          nvratov kdy, je vhodn stahovat vdy jen jeden soubor a pro vce
          soubor zavolat vckrt YouTube Downloader.
  1 ..... Chyba pi ktermkoliv downloadu.
  2 ..... Nebyly nalezeny dn pouiteln URL.
  3 ..... Neplatn syntaxe. Byl uveden neznm parametr nebo nebyla uvedena
          povinn hodnota parametru (nap. pro parametr -i, viz ve).
  4 ..... Chybn obsah parametru. Chyba je vyvolna u parametr s povinnou
          hodnotou, pokud sice hodnota je zadna, ale jej obsah nen oekvn
          - nap. pokud za parametru -i zadte nzev neexistujcho souboru).
  254 ... Aplikace byla peruena z popudu uivatele.
  255 ... V aplikaci dolo k vjimce, tzn. chyba v programu.



LOKALIZACE
----------

Pro lokalizaci pouv YouTube Downloader GNU GetText. Pro ppadn zjemce
to znamen, e pokud GetText znte, mete se okamit pustit do tvorby novho
pekladu. Pokud zatm GetText neznte, doporuuji se s nm seznmit, protoe
jde o jeden z nejrozenjch lokalizanch nstroj. Jedin problm je,
najt njak srozumiteln nvod - ty, co jsem nael, jsou vesms dost obtn
iteln, pokud u dopedu nevte, o co v GetTextu jde. Ale s vhodnm nstrojem,
jako je nap. POEdit (http://www.poedit.net/), se to d zvldnout za pochodu.

Pro pekldn budete potebovat soubor "default.pot", kter obsahuje zkladn
(nepeloen) texty. Najdete ho v adresi "Source\Locale". Pomoc POEditu nebo
jinho nstroje (klidn si vystate i s Notepadem, akort to bude nepohodln)
ho ulote do souboru "default.po" (.pot je vzor, .po je pracovn soubor) ,
v nm jednotliv texty pelote a hotov peklad pak zkompilujete do souboru
"default.mo". Tento soubor pak ulote do adrese "(exe)\Locale\(jazyk)\LC_MESSAGES",
kde:
   - "(exe)" je adres, ve kterm je uloen "ytd.exe"
   - "(jazyk)" je adres pojmenovan podle dvouznakov ISO zkratky jazyka;
     pro etinu to je "cs", pro anglitinu "en", dal si mete dohledat na
     Wikipedii: http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

Pokud jde o jazyk, pro kter jsou nastavena vae Windows, ml by se pout
automaticky pi ptm sputn YTD. Ppadn si mete vynutit pouit
tohoto jazyka pomoc nastaven "Language" v INI souboru (viz ve).

Pokud mi svj peklad polete (budu potebovat oba soubory, "default.mo"
i "default.pot), rd ho zaadm do budoucch verz YouTube Downloaderu.



PODPORA
-------

Podporu naleznete na nsledujcch strnkch:

- Pepakovo frum: 
  http://forum.pepak.net
- Strnka YouTube Downloader: 
  http://www.pepak.net/download/youtube-downloader/
- Strnka YouTube Downloader - podpora: 
  http://www.pepak.net/download/youtube-downloader-podpora/



NAPSALI O PROGRAMU
------------------

http://blog.zarohem.cz/clanek.asp?cislo=1605



LICENCE
-------

YouTube Downloader je publikovn pod tzv. novou BSD licenc. Jej text 
naleznete v souboru DOC/LICENSE.TXT.

Pokud potebujete program pelicencovat pod jinou licenci, dejte mi vdt.

Komponenty tetch stran, umstn v adresi SOURCE/LIB, se d svmi 
vlastnmi licencemi. Z tohoto dvodu nelze pout licenci GNU GPL (dnou
verzi) ani na YouTube Downloader, ani na odvozen programy!

Knihovny a jejich licence:

- DxGetText
  - autoi: Lars B. Dybdahl, Peter Thrnqvist
  - zdroj: http://dxgettext.po.dk/
  - licence: vlastn, freeware
  - popis: Podpora pro lokalizace (dal jazyky) programu

- MSDL
  - autor: Jun "metro" Oyama (me_t_ro@yahoo.com)
  - zdroj: http://msdl.sourceforge.net/
  - licence: GNU GPL v3
  - popis: Nstroj pro stahovn protokol MMS, RTSP a jejich variant

- MSDL_DLL
  - autor: Pepak
  - zdroj: http://www.pepak.net/download/youtube-downloader/
  - licence: GNU GPL v3
  - popis: MSDL upraven tak, aby se volalo jako DLL knihovna

- NativeXml
  - autor: Nils Haeck
  - zdroj: http://www.simdesign.nl/xml.html
  - licence: vlastn, freeware
  - Prce s XML

- PerlRegEx
  - autor: Jan Goyvaerts
  - zdroj: http://www.regular-expressions.info/delphi.html
  - licence: Mozilla Public License 1.1
  - popis: Vyhodnocovn regulrnch vraz

- RTMPDUMP
  - autoi: Andrej Stepanchuk, Howard Chu
  - zdroj: http://rtmpdump.mplayerhq.hu/
  - licence: GNU GPL v2
  - popis: Nstroj pro stahovn protokolu RTMP a jeho variant.

- RTMPDUMP_DLL
  - autor: Pepak
  - zdroj: http://www.pepak.net/download/youtube-downloader/
  - licence: GNU GPL v2
  - popis: RTMPDUMP upraven tak, aby se volal jako DLL knihovna

- Silk Icon Pack
  - autor: Mark James
  - zdroj: http://www.famfamfam.com/lab/icons/silk/
  - licence: Creative Common Attribution 2.5
  - popis: Ikonky Silk pouit v grafick verzi programu.

- Synapse
  - autor: Luk Gebauer
  - zdroj: http://synapse.ararat.cz/
  - licence: vlastn, freeware
  - popis: Prce s TCP/IP, HTTP a dalmi sovmi protokoly

Jazykov verze:

- Sloventina: Vladimr Kubala (kubalav@gmail.com), 26.8.2010
