BAKALÁŘSKÁ PRÁCE. Software na vyhledávání a stahování titulků Matyáš Černohous. Vedoucí práce: Mgr. Martin Trnečka,

Transkript

1 BAKALÁŘSKÁ PRÁCE Software na vyhledávání a stahování titulků 2018 Matyáš Černohous Vedoucí práce: Mgr. Martin Trnečka, Ph.D Studijní obor: Aplikovaná informatika, prezenční forma

2 Bibliografické údaje Autor: Název práce: Typ práce: Pracoviště: Rok obhajoby: 2018 Studijní obor: Vedoucí práce: Počet stran: 43 Přílohy: Jazyk práce: Matyáš Černohous Software na vyhledávání a stahování titulků bakalářská práce Katedra informatiky, Přírodovědecká fakulta, Univerzita Palackého v Olomouci Aplikovaná informatika, prezenční forma Mgr. Martin Trnečka, Ph.D 1 CD/DVD český Bibliograhic info Author: Title: Thesis type: Department: Year of defense: 2018 Study field: Supervisor: Page count: 43 Supplements: Thesis language: Matyáš Černohous Software for searching and downloading subtitles of movies bachelor thesis Department of Computer Science, Faculty of Science, Palacký University Olomouc Applied Computer Science, full-time form Mgr. Martin Trnečka, Ph.D 1 CD/DVD Czech

3 Anotace Práce popisuje implementaci aplikace v jazyce C# pro jednoduché, rychlé vyhledávání a stahování titulků k filmům z různých serverů s titulky. Dále obsahuje manuál pro uživatele a technický popis implementace aplikace pro programátory, díky kterému může být aplikace jednoduše rozšiřována o další funkcionalitu. Synopsis The thesis describes the implementation of application in language C# for fast and simple searching and downloading subtitles for movies from different servers. The thesis also contains a user manual and a technical description of the application for programmers, which can be used to extend the application to other features. Klíčová slova: aplikace; titulky; film; C#; webové služby, servery s titulky Keywords: application; subtitles; movie; C#; web service; servers with subtitles

4 Děkuji Mgr. Martinu Trnečkovi, Ph.D. za vedení bakalářské práce, připomínky k aplikaci, které ji udělali lepší a za cenné rady při konzultacích. Místopřísežně prohlašuji, že jsem celou práci včetně příloh vypracoval samostatně a za použití pouze zdrojů citovaných v textu práce a uvedených v seznamu literatury. datum odevzdání práce podpis autora

5 Obsah 1 Úvod Motivace k vývoji aplikace Logo a název aplikace Obsah projektu Grafická verze Konzolová verze Již existující aplikace Sublight SubDownloader Subtle TitulkyCOM VLCSub Srovnání a závěr Webové služby Titulky.com Získávání dat Detail služby OpenSubtitles.org Detail služby Vlastní implementace služeb Web scraping Získávání obrázků Překlad do češtiny Aplikace Subtitulky Grafická verze Získání dat titulků ze serverů Třída OsdbAgent Třída SubtitleSearcher Třída TitulkyComWrapper Filtrace výsledků Vizualizace dat Třída SubtitleController Načítání obrázků Třída PosterWrapper Třída CSFDWrapper Omezení duplicitních požadavků na službu Třída PosterHelper Stažení titulků Třída SubtitleDownloader Přidání dalších zdrojů titulků

6 Postup přidání zdroje Konzolová verze Inicializace a hledání Stažení titulků Třída LevenshteinDistance Možnost Zkusit štěstí a spustit Možnost Stáhnout titulky pro složku Instalátor aplikace Použité technologie C# WPF XAML PHP Použité knihovny třetích stran OSDB.net csfd-api PHP-IMDB-Grabber MahApps.Metro Uživatelský manuál aplikace Grafická verze První spuštění aplikace Hlavní okno aplikace Funkce Účet Funkce Nastavení Vyhledávání Okno s výsledky Ovládací a informační oblast Výsledková oblast Okno náhled Režim film Režim text Kontextové menu Konzolová verze Stažení titulků pro film Stažení titulků pro složku Závěr 38 Conclusions 39 6

7 A Zprovoznění aplikace 40 A.1 Minimální systémové požadavky A.2 Instalace B Obsah přiloženého CD 41 Seznam literatury 42 7

8 Seznam obrázků 1 Logo aplikace Subtitulky Princip fungování webové služby Zachycená komunikace aplikace se službou Konzolová verze aplikace Hlavní okno aplikace Výsledky vyhledávání Seznam tabulek 1 Popis parametrů pro preferenci řazení výsledků Popis parametrů pro přihlášení Seznam zdrojových kódů 1 Požadavek na server o doporučení filmu Odpověď serveru s daty Binding dat do komponenty LixtBox Binding vlastností z modelu do šablony komponenty ListBox

9 1 Úvod Na filmy koukáme všichni. Dříve se celá rodina sešla večer a sledovala film v televizi. Doba pokročila a filmy sledujeme častěji na počítačích, než doma u televize. Je to pohodlnější, libovolný film stáhneme za pár minut, můžeme sledovat kdykoliv a kdekoliv filmy, které jsou nové a ještě nejsou nadabované. Pokud nejsme schopní angličtináři, tak porozumět originálnímu filmu je problém a proto většina lidí sáhne po titulcích které jsou dostupné mnohem dříve než dabing v mateřském jazyce. Pro nalezení titulků k filmům slouží spousta českých a nebo zahraničních webů, na kterých je k dostání řada verzí titulků. Tady nastává problém. Pokud nevíme přesně jakou verzi titulků stáhnout, tak se nám může stát, že hledáním titulků se správným časováním zabere dlouhé minuty. Aplikace Subtitulky umožní zkrátit čas vyhledávání nejlepší možné verze titulků na zlomek času, který by byl potřeba při hledání na internetové stránce. 1.1 Motivace k vývoji aplikace Už od puberty jsem velký fanoušek filmů a seriálů. Začínal jsem na české tvorbě a později jsem se přesunul na zahraniční, kde mi zpočátku stačil český dabing, ale postupem času jsem začal sledovat seriály, které ještě nebyly nadabované a musel jsem si pracně stahovat titulky z webů, kde jsem musel odklikávat spousty reklam, opisovat texty, nebo čekat určitý časový úsek a výsledek byl stejně nejistý, protože jsem nevěděl jaká verze bude pasovat. Začal jsem hledat programy, které by nahradily dlouhé hledání na webu a umožnily by stáhnutí správných titulků na pár kliknutí myši. Našel jsem pár programů, ale všechny měli nedostatky. Hlavní problém byl, že většina nabízela pouze zkušební verzi a pro správné fungování bylo nutné předplatné. Dále měly ošklivé GUI nebo byly moc složité a plné funkcí, které člověk u prostého stažení titulků nepotřebuje. Toto mě motivovalo k napsání aplikace, která bude mít všechnu důležitou funkcionalitu, bude intuitivní, bude mít přehledné GUI a všechny funkce budou zdarma. 1.2 Logo a název aplikace Název aplikace Subtitulky vznikl kombinací slova titulky a anglického slova subtitles, které v překladu znamená titulky. Spojením počátečních tří písmen slova subtitles a českého slova titulky získáme již zmíněný název Subtitulky. Aplikace je primárně cílena na české uživatele, takže název je volen tak, aby byl z většiny český, jednoslovný, snadno zapamatovatelný a aby se dal lehce asociovat s funkcí aplikace. Logo je jednoduché a úderné aby na první pohled bylo jasné k čemu aplikace slouží. Tři různě dlouhé čáry pod sebou symbolizují text titulků ve filmech. Uživatel si tak snadněji udělá asociaci aplikace k její funkčnosti. 9

10 1.3 Obsah projektu Obrázek 1: Logo aplikace Subtitulky Aplikace Subtitulky se skládá ze dvou částí. První je GUI verze, díky které i nezkušený uživatel zvládne najít a stáhnout správné titulky. Tato verze je dostačující pro základní operace s titulky. Druhá je konzolová verze, díky které můžou pokročilí uživatelé jednodušeji a rychleji stahovat titulky pro větší množství filmů. Obě verze fungují pouze v online 1 režimu. V offline 2 režimu aplikace nebude fungovat Grafická verze Grafická verze aplikace Subtitulky obsahuje základní i pokročilé funkce pro vyhledávání a stahování titulků. Může se vyhledávat pode názvu filmu nebo přímo podle video souboru a výsledky dále filtrovat. Dále se dá nastavit na jakých serverech se budou titulky vyhledávat a v jakém jazyce se bude hledat. Této verzi se budu v textu věnovat více. Hlavní funkce aplikace jsou: Vyhledání titulků podle souboru Vyhledání titulků podle názvu Filtrování výsledků vyhledávání Nastavení jazyka vyhledávaných titulků Přihlášení se do účtu na serveru titulky.com Nastavení z jakých serverů se budou titulky vyhledávat Možnost zobrazit si náhled titulků Možnost spustit film s titulky před finálním stažením titulků Stažení titulků a spuštění Doporučení podobných filmů 1 Režim, kdy zařízení je připojené k síti 2 Režim, kdy není zařízení připojené k síti 10

11 1.3.2 Konzolová verze Konzolová verze aplikace obsahuje funkce, které zkušenému uživateli umožní lehčí a rychlejší stahování titulků pro filmy v dané složce a podložkách. Neobsahuje žádná nastavení a data o nastavení si bere z hlavní aplikace. Tato verze nepodporuje vyhledávání filmu podle názvu, ale pouze podle souboru. Dále používá pro vyhledávání titulků pouze jeden zdroj titulků díky čemuž je nalezení a stažení rychlejší než kdyby se používalo více zdrojů. Hlavní funkce konzolové aplikace jsou: Stažení titulků pro celou složku a její podsložky Nalezení a stažení nejvhodnějších titulků k filmu 11

12 2 Již existující aplikace Jak jsem již psal výše, podobné aplikace nebo pluginy již existují. Z větší míry to jsou pluginy 3 do přehrávačů, kde je to spíše doplňková funkcionalita a nezkušení uživatelé ani nemusí vědět, že přehrávač tuto možnost umožňuje. Představím zde pár nejznámějších aplikací a popíši výhody, nevýhody, přívětivost uživatelského rozhraní a na konci provedu srovnání s aplikací Subtitulky Sublight Aplikace Sublight [1] se na svém webu pyšní titulem nejpoužívanější aplikace na světě pro stahování titulků. Prezentuje se jako jednoduchá aplikace která ušetří dost času při hledání titulků, ale zároveň v sobě ukrývá spousty funkcí navíc, které uživatel, který si přišel pouze pro titulky neocení. Nevýhodou aplikace je, že neumožňuje stažení titulků bez přihlášení v aplikaci. Hned po startu vyskočí modální okno 4, které nutí uživatele k přihlášení buď přes účet, který si můžete vytvořit u společnosti Sublight a nebo se můžete přihlásit pomocí svého Google+ účtu. Další velkou nevýhodou je, že pokud nemáte prémiový účet, který aplikace nabízí za cenu 0,33 EUR/měsíc, jste omezeni na základní funkce aplikace. Pokud si chcete stáhnout titulky a nemáte prémiový účet, musíte před stažením 10 sekund počkat, než se zahájí stahování. Dále aplikace nepodporuje náhled titulků před stažením jestli sedí časování a nepoužívá žádný český server s titulky. Výhodou této aplikace je, že už i v základním režimu nabízí spoustu zdrojů kde vyhledává titulky. Většina z nich je zahraničních, takže pro českého uživatele to zas tak velká výhoda není. Další skvělou funkci, kterou aplikace nabízí je automatické monitorování složky. Pokud se v ní objeví nový film, tak pro něj automaticky stáhne titulky bez nutnosti vyhledávat v aplikaci. Tato funkce je ale dostupná pouze v prémiové verzi SubDownloader Aplikace SubDownloader [2] se zaměřuje přímo na stahování titulků, bez dalších funkcí, které pro základní potřebu nejsou potřeba. Nevýhodou je, že po uplynutí zkušební verze aplikace neumožňuje další používání bez zakoupení prémiového účtu, takže je aplikace nepoužitelná. V popisu aplikace se sice píše, že po uplynutí zkušební verze dojde jen k omezení funkcí, ale zkoušel jsem to několikrát a pokaždé aplikace pouze informovala o konci zkušební doby a ukončila se. Další nevýhoda je ta, že filmy se dají vyhledávat pouze vybráním z úložiště a nebo zvolením složky ve které se filmy nachází. Aplikace nepodporuje textové zadání hledaného filmu ani integraci do kontextového menu. Uživatelské rozhraní taky není na první pohled přívětivé ani intuitivní a uživatel se musí zorientovat jak vlastně vyhledávat. 3 Plugin = rozšíření do aplikace. 4 Okno, které vyžaduje uživatelskou interakci pro pokračování. 12

13 2.0.3 Subtle Aplikace Subtle je jednoduchý program, který dělá přesně to co uživatel od takové aplikace. Nevyžaduje žádné vytvoření účtu, je bez prémiových funkcí a je zdarma. Podporuje vyhledávání podle filmu, textového zadání a nebo pomocí identifikátoru (ID) na serveru imdb.com. Soubor je možné vybrat pomocí systémového dialogu nebo jednoduše soubor přetáhnout na formulář. Dále podporuje integraci do kontextového menu. Nevýhodou je, že nepodporuje vyhledání a stažení titulků pro celou složku. Uživatelské rozhraní je sice jednoduché, ale není designově povedené, nemá ošetřené všechny výjimky a občas spadne TitulkyCOM TitulkyCOM [3] je aplikace od největšího českého serveru s titulky titulky.com. Aplikace vyžaduje přihlášení uživatele účtem, který používá na serveru titulky.com. Prémiové funkce v aplikaci nejsou, protože tuhle funkcionalitu zajišťuje přímo server, který má nastavený limit počtu stažení titulků za hodinu pro prémiové a obyčejné uživatele. Aplikace měla zjednodušit uživatelům vyhledávání bez nutnosti navštívit web, ale to se moc nepovedlo. Aplikace není intuitivní. Po startu zobrazí prázdnou tabulku, horní menu a žádné, na první pohled patrné, vyhledávací pole. Vyhledat film lze pomocí filmu a nebo názvu filmu. Výsledky vyhledávání spíše zmatou, než aby pomohly, protože se nenajdou jen přesné titulky co uživatel chtěl hledat, ale další spousty titulků, které v názvu obsahují byť jen jedno společné slovo z hledaného filmu, tudíž je aplikace skoro nepoužitelná VLCSub Jak jsem již zmínil výše, pro vyhledávání titulků neslouží jen přímo aplikace, ale i doplňky pro přehrávače. Umožnit přidat tuto funkcionalitu přímo do přehrávače je dobrý nápad, ale vzhledem k tomu, že to je pouze doplňková funkcionalita, tak o těchto funkcích moc lidí neví. Přehrávač VLC nabízí vyhledání titulků pomocí výchozího doplňku VLC- Sub [4]. Doplněk je jednoduchý a přehledný. Umí autodetekci jazyka ve kterém má vyhledávat a umožňuje vyhledávání podle filmu a nebo podle názvu. Doplněk se dá použít jen tehdy, pokud je ve VLC otevřený nějaký film. Po stažení titulky automaticky vloží do filmu. K doplňku se dá dostat přes horní menu aplikace Srovnání a závěr Všechny výše uvedené aplikace jsou podobné a snaží se o co nejjednodušší stažení titulků. Každá implementuje nějakou užitečnou funkcionalitu, ale žádná není dokonalá a neslouží jako rychlý univerzální nástroj. Ani jedna nepodporuje náhled titulků před stažením jestli sedí časování. 13

14 Aplikace Subtitulky v porovnání s ostatními aplikacemi obsahuje všechny důležité funkce pro rychlé a intuitivní vyhledávání titulků, ale žádné zbytečné funkce navíc, které uživatel nepotřebuje. Má oproti většině aplikací jednoduché ovládání a povedený design. Obsahuje integraci do kontextového menu, podporuje vyhledání a stažení titulků jak pro jeden film i pro celou složku. Dále umí zobrazit titulky před stažením a doporučovat další filmy na základě vyhledaného filmu. 14

15 3 Webové služby Aplikace Subtitulky využívá webové služby, které se starají o nelezení správných výsledků. Výsledky se následovně předají počítačovému klientu na zpracování. V aplikaci se používají dva různé servery pro titulky a pro každý server se používá jiná webová služba. Webová služba umožňuje programátorovi přistupovat pomocí specifické komunikace k funkcím, které neběží na klientském počítači, ale například na serveru. Může se jednat o jednoduché vyhledávání v databázi, přihlášení k uživatelskému účtu a nebo například o náročné výpočty, které je výhodnější dělat na serveru. Tuto funkcionalitu většinou poskytují webové aplikace, které poskytují nějaké data a chtějí k nim poskytnout jednoduchý veřejný přístup pro používání v jiných aplikacích. Webová služba může být přístupná pomocí například pomocí HTTP 5 protokolu a může být napsána v různých programovacích jazycích jako je například Java,.NET, PHP, Node.js. Má výhodu v tom, že funkce dané služby může využívat jakékoliv zařízení, které je připojené k internetu a zná pravidla komunikace, tudíž stejné funkce můžeme používat na počítačovém klientu, telefonu a nebo ve webové aplikaci (obrázek 2). Komunikace probíhá tak, že klient zašle požadavek, který služba zpracuje a dostane odpověď, ve které jsou například data, které si vyžádal. Ve aplikaci se používají tři webové služby. Jedna služba je pro hledání výsledků na serveru opensubtitles.org, druhá je pro hledání výsledků na serveru titulky.com a třetí je pro získávání dodatečných informací k titulkům. Služby vrací základní informace ohledně titulků a filmu, podrobnější informace nikoliv. Proto bylo nutné vytvořit si vlastní službu, která bude zjišťovat detailní informace. Obrázek 2: Princip fungování webové služby 5 HyperText Transfer Protocol = internetový protokol pro přenášení souborů. 15

16 3.1 Titulky.com Server titulky.com je největší a nejznámější zdroj titulků v České republice. Obsah tvoří komunita překladatelů, která se stará o to aby zde byly vždy aktuální titulky Získávání dat Aplikace Subtitulky je cílená primárně na české uživatele, tudíž server titulky.com bylo nezbytné zařadit mezi servery odkud se budou čerpat data. Většina serverů poskytuje nějakou službu přes kterou se můžou získávat data, ale na tomto serveru žádná taková informace není. Toto zjištění zkomplikovalo vývoj, protože data už nemohly být brány přímo a dala se buď použít metoda zvaná web scraping (viz kapitola 3.3.1), nebo najít jiný český zdroj. Použití web scrapingu nepatří mezi nejrychlejší metody při získávání většího množství dat, takže jediná možnost byla najít jiný český server s titulky. Při testování aplikace TitulkyCOM, jsem si uvědomil, že musí nějak komunikovat se serverem titulky.com a získávat data. Analýzou síťové komunikace pomocí aplikace WireShark [16], která umožňuje odposlouchávání síťového provozu, se dá zjistit s jakou službou aplikace TitulkyCOM komunikuje, tyto data dále analyzovat a dojít k detailním informacím o službě, kterou aplikace využívá (obrázek 3) Obrázek 3: Zachycená komunikace aplikace se službou Detail služby Služba na serveru titulky.com je napsaná v jazyce PHP (viz kapitola 5.3), který dříve nebyl pro vytváření služeb nejvhodnější kvůli jeho rychlosti. Nejnovější verze 7 je více optimalizovaná a výrazně rychlejší. Obsahuje dvě funkce, které můžeme volat. Tyto funkce jsou: xmlsearch a login. Funkce xmlserch Funkce slouží pro vyhledání titulků v databázi podle zadaných parametrů. Výsledky jsou vraceny ve formátu XML 6. Problém této funkce je, že výsledky nejsou filtrovány na straně serveru a v odpovědi je i spousta irelevantních výsledků, což 6 Extensible Markup Language = značkovací jazyk, který slouží k popisu dat. 16

17 se podepisuje na rychlosti odpovědi a hlavně na rychlosti zpracování dat, protože je nutná filtrace na straně klienta. Funkcexml search s parametry: xmlsearch.php?arelease=harry%20potter&o1=2&o2=1&o3=3&o4=2 &o5=1&v=0&j=cz&login=meteyy Detailně popsané parametry: ARelease - jméno filmu pro který chceme vyhledat titulky o0...o4 - priorita zobrazení výsledků. Parametry nebývají hodnoty 0-4 a jsou popsané v tabulce 1 V - velikost filmu v bitech J - preferovaný jazyk titulků (buď cz nebo sk) login - nepovinný parametr. Uživatelské jméno na serveru titulky.com o0 Významnost autora Podle počtu přidaných titulků o1 Počet stažení titulků - o2 Nejnovější titulky - o3 Jazyk: čeština - o4 Shoda velikosti filmu - Tabulka 1: Popis parametrů pro preferenci řazení výsledků Funkce login Tato funkce se stará a autorizaci uživatele na serveru titulky.com. Pro vyhledání titulků uživatel nemusí být přihlášen, ale pro stažení už ano. Funkce vrací pouze číselný kód (detailně popsáno v tabulce 2) a nebo prázdný řetězec což není nejlepší řešení autentizace. Data se posílají pomocí GET 7 požadavku a jsou přenášena v plain textu 8, což je velký bezpečnostní hazard, protože pokud by útočník odposlouchával komunikaci na síti, dostane se jednoduše k uživatelskému jménu a heslu. Fukce login s parametry: login.php?login=meteyy&password=abcd123 7 Data jsou posílána v URL adrese. 8 Plain text = text, který není zašifrovaný a je normálně čitelný. 17

18 Detailně popsány jednotlivé parametry: Login - uživatelské jméno na webu titulky.com Password - heslo uživatele Autorizace byla neúspěšná 0 Autorizace proběhla úspěšně 10 Autorizace proběhla úspěšně a uživatel má VIP účet Tabulka 2: Popis parametrů pro přihlášení 3.2 OpenSubtitles.org opensubtitles.org je celosvětově nejznámější webová stránka s titulky. Na webu se dají najít titulky skoro na cokoliv ve více než 50 jazycích. Pokud tady nějaké titulky nejsou, stačí o titulky zažádat a někdo z komunity titulky vytvoří a vloží do databáze Detail služby Server má svoji vlastní veřejnou webovou službu, kterou může využívat kdokoliv kdo požádá o registraci. Po zaregistrování a přidělení identifikačního jména, který slouží pro identifikaci a získání přístupového identifikátoru, díky kterému se můžou používat všechny funkce, které služba nabízí. Služba pro všechny funkce používá buď XML-RPC protokol a nebo se dá pro vyhledávání použít REST 9 architektura. Pro vyhledávání titulků přišel server opensubtitles.org s novým řešením. Titulky se můžou vyhledávat buď podle textového řetězce, jak to má většina služeb, a nebo přímo podle souboru s filmem. Pokud se zvolí vyhledávání podle souboru s filmem, tak se pomocí předem definované funkce vytvoří speciální hash filmu, který se používá pro párování výsledků. Titulky jsou do databáze vkládány s hashem filmu na který byly tvořeny a díky tomuto mechanismu uživatel nedostává všechny výsledky pro daný textový vstup ze kterého pak ještě musí filtrovat, ale pouze titulky které pasují přesně na film. V aplikaci se pro vyhledávání používá méně výkonné řešení komunikace se službou pomocí XML-RPC protokolu, protože vyhledávání pomocí REST architektury bylo zveřejněno když už byla aplikace hotová, ale jedno z možných vylepšení aplikace může být právě přepsání vyhledávací funkce. data). 9 Representional State Transfer = rozhraní pro jednotný a snadný přístup ke zdrojům (např. 18

19 Vyhledávání pomocí REST architektury je výkonnější. Klient provede požadavek na službu, který se uloží do cache paměti na CDN 10. Díky tomu je odpověď od serveru rychlejší a servery provozovatele nejsou tak zatěžovány. Požadavek protokolu XML-RPC je složité ukládat do cache paměti, takže výsledky nejsou tak rychlé a vytěžuje to server provozovatele. Kódy 1 a 2 znázorňují použití XML-RPC protokolu: 1 <methodcall> 2 <methodname>suggestmovie</methodname> 3 <params> 4 <param> 5 <value>harry Potter</value> 6 </param> 7 </params> 8 </methodcall> Zdrojový kód 1: Požadavek na server o doporučení filmu 1 <methodresponse> 2 <params> 3 <param> 4 <value><string>percy Jackson</string></value> 5 <value><string>mamma Mia</string></value> 6 <value><string>it</string></value> 7 </param> 8 </params> 9 </methodresponse> Zdrojový kód 2: Odpověď serveru s daty 3.3 Vlastní implementace služeb Jak již bylo zmíněno výše, služby poskytují pouze základní informace o titulcích. Pro získání podrobnější informací jako je například plakát pro film, detaily k filmu nebo český název se musí využít jiných zdrojů. Pro získání plakátů a dalších informací se využívá největší světový web o filmech imdb.com a největší československý web o filmech csfd.cz. Ani jeden web nemá vlastní webovou službu, takže je nutné použít metodu zvanou web scraping. 10 Content Delivery Network = několik geograficky distribuovaných serverů, které spolupracují a zajišťují uživatelům rychlejší přístup k datům. 19

20 3.3.1 Web scraping Web scraping je metoda získávání dat přímo z webových stránek pomocí protokolu HTTP. Funguje na principu toho, že se stáhne celý zdrojový kód stránky s daty a dále se soubor zpracovává. Extrahování dat se může provádět buď ručně, nebo se dá automatizovat. Pro získávání dat se využívá toho, že dokumenty využívají HTML 11 nebo jiné značkovací jazyky a data které chceme získat jsou většinou stejné kategorie a mají stejnou šablonu. Pokud je v dokumentu použité i CSS 12, dá se pomocí tříd nebo identifikátorů k datům dostat ještě snáz. Nevýhodou této metody je, že je závislá na stálé struktuře webu. Data které se získávají jsou obaleny určitými tagy, které obsahují třídy a identifikátory a při hledání dat v souboru se předpokládá, že když se takový tag najde, tak tam budou i hledaná data. Pokud se změní struktura webové stránky, tak se nemusí povést získat data, protože názvy atributů, se kterými se pracovalo jsou změněné a musí přepsat funkce pro získávání dat. Web scraping sám o sobě není nelegální, protože se k webu přistupuje stejně jako přistupuje běžný uživatel přes internetový prohlížeč, ale pohybuje se na hraně etiky. Některé weby jako je například Google tuto metodu zakazuje ve svých podmínkách použití Získávání obrázků IMDB Při vyhledávání titulků na opensubtitles.org se obrázek získává ze serveru imdb.com, protože data obsahují identifikátor filmu na serveru. Pro získání obrázku z této stránky se používá funkce getimdbposter.php?imdb=... kde imdb je id filmu na serveru. Díky tomuto identifikátoru se dá přímo přistupovat na stránku s filmem a zde získat URL adresu na které se nachází obrázek. CSFD Získání obrázku ze serveru csfd.cz je složitější. Při využití služby titulky.com se v odpovědi vyskytují jen informace o názvu filmu, hodnocení, počtu stažení a identifikátor na serveru titulky.com. Proto se první musí získat identifikátor a až poté zavolat funkci getcsfdposter.php?id=... Pro získání id se první zavolá funkce hledat.php?q=, kde q je název hledaného filmu v angličtině. Pokud byl film nalezen, vrátí se odpověď s identifikátorem a zavolá se funkce getcsfdposter.php?id=..., která vrátí URL adresu na obrázek. Kvůli volání funkcí, které provádí web scraping je získávání obrázku časově náročné, ale neexistuje jiná možnost jak obrázek získat. 11 Hypertext Markup Language = značkovací jazyk pro psaní webových stránek. 12 Cascading Style Sheets = popisovací jazyk, který popisuje vlastnosti objektů v HTML. 20

21 3.3.3 Překlad do češtiny Pro zobrazení nalezených titulků se používá seskupování do skupin podle názvu filmu ke kterému patří. Problém nastává pro české uživatele, protože výsledky z opensubtitles.org obsahují pouze anglický název a výsledky z titulky.com sice obsahují jak český tak anglický název, ale někde český název chybí, někde se liší velikost písmen a někde diakritika, což způsobí, že se titulky pro jeden film zařadí do více kategorií. V aplikaci se pro seskupování používá anglický název, ve kterém nemůže nastat rozdíl v diakritice a možnost zobrazení českého názvu filmu je v nastavení. Pro překlad názvů do češtiny se používá metoda czname.php?q=... kde parametr q bere název filmu v angličtině. Metoda po zavolání provede vyhledávání na serveru csfd.cz podle zadaného parametru, získá se český název filmu a ten je pak vrácen. Pokud film nebyl nalezen, vrátí se chybová hláška a dále se používá originální název. 4 Aplikace Subtitulky Aplikace Subtitulky se skládá z konzolové a grafické verze. V této části bude popsána implementace jednotlivých částí aplikace. 4.1 Grafická verze Důležité funkce, které budou probrané v této kapitole: Získání dat titulků ze serverů Vizualizace dat Načítání obrázků Stažení titulků Přidání dalších zdrojů titulků Získání dat titulků ze serverů Třída OsdbAgent Pro možnost vyhledávání titulků ze serveru opensubtitles.org je nutné se při každém dotazu prokázat platným tokenem 13. O získání tokenu se stará třída OsdbAgent, která pomocí asynchronní metody 14 login nebo pomocí synchronní metody 15 LoginSync provede ověření na serveru a pokud bylo úspěšné vytvoří instanci třídy AnonymousClient, která implementuje rozhraní 13 Token = identifikátor. 14 Asynchronní metoda = metoda, která je prováděna mimo hlavní vlákno 15 Synchronní metoda = metoda, která je prováděna v hlavním vlákně. 21

22 IAnonymousClient, která se stará o vytváření a posílání XML-RPC požadavků na službu serveru opensubtitles.org Třída SubtitleSearcher Tato třída je páteřní třída celé aplikace. Obsahuje metody, které se starají o spuštění vyhledávání titulků. Třída implementuje rozhraní ISubtitleSearcher, které obsahuje metody SearchByMovieName a SearchByFile. Každá metoda po zavolání vytvoří nové vlákno, které se stará o komunikaci se službou a vyhledávání probíhá paralelně. Pokud se zavolá metoda SearchByFile v těle této metody se zavolá metoda SearchByMovieName díky čemuž dojde k zpřesnění výsledků vyhledávání. Pokud je povolá možnost vyhledávání i na serveru titulky.com tak se ve funkci SearchByMovieName vytvoří instance třídy TitulkyComWrapper, která bude popsána níže Třída TitulkyComWrapper Vyhledávání na serveru titulky.com může probíhat bez přihlášení uživatele, tudíž stačí pouze třída, která se bude starat o komunikaci se serverem. Třída obsahuje veřejnou metodu Search, která spustí v novém vlákně vyhledávání na serveru titulky.com. Tato třída obsahuje pouze jednu metodu pro vyhledávání, protože služba umožňuje hledat film podle názvu i podle souboru najednou Filtrace výsledků Díky špatnému nastavení vyhledávání webové služby je většina výsledků, které jsou vráceny irelevantní k zadanému výrazu nebo filmu. Proto musí být implementována filtrace na straně klienta, která se aplikuje pouze v případě, že je vyhledáváno podle souboru s filmem. Vychází z předpokladu, že většina filmů má přesně danou strukturu názvu, která je popsána níže. Implementace filtru není dokonalá, ale zvládne odfiltrovat velkou část, které by nebyly relevantní. Název filmu: Ant-Man p.BluRay.x264-SPARKS.mkv Struktura názvu pro většinu filmů: Název filmu - Ant-Man Rok Rozlišení p Formát - BluRay.x264 22

23 4.1.2 Vizualizace dat Celé uživatelské rozhraní aplikace je vytvořeno pomocí jazyka XAML. Jazyk XAML je značkovací jazyk od vyvinutý společností Microsoft, který je podobný jazyku HTML a založený na jazyku XML. Pro vizualizaci dat se používá komponenta ListBox. Komponenta by pro požadovanou funkčnost nestačila, protože ve výchozím stavu zobrazuje pouze jeden řádek textu. Každá komponenta má předem danou šablonu pro zobrazování dat a šablona komponenty se dá jednoduše přepsat na vlastní šablonu. Datový kontext do komponenty můžeme napojit pomocí data bindingu (zdrojový kód 3). Data binding je mechanismus v XAML aplikacích, který zprostředkovává zobrazení a interakci s daty. Data binding umožňuje zobrazení dat v uživatelským rozhraním z datových objektů. Když jsou data už jednou inicializovány a zobrazeny binding umí reflektovat změnu dat a automaticky aktualizovat data která jsou zobrazena v GUI elementech. Pomocí bindingu se taky dají provádět změny v kolekci z uživatelského rozhraní. Pokud se nastaví vlastnost Mode na hodnotu TwoWay, tak změny hodnot provedené uživatelem jsou provedeny také v datové třídě. Kód 3 znázorňující použití bindingu dat do komponenty. 1 <ListBox x:name="listboxsubtitles" 2 HorizontalContentAlignment="Right" 3 VirtualizingStackPanel.IsVirtualizing="True" 4 Margin="0,0,0,0" ItemsSource="{Binding Subtitles,UpdateSourceTrigger =PropertyChanged,Mode=TwoWay}" 5 BorderBrush="{x:Null}" Background="Transparent"> Zdrojový kód 3: Binding dat do komponenty LixtBox LisBox obdržel vlastnost Subtitles a očekává kolekci. Pokud máme upravenou šablonu komponenty, můžeme pomocí bindingu jednotlivých vlastností z modelu nastavit jaká data se budou zobrazovat. Změny v kolekci se automaticky projeví v uživatelském rozhraní bez nutnosti programového obnovení jen tehdy pokud kolekce implementuje rozhraní INotifyCollectionChanged. 23

24 Kód 4 znázorňuje binding vlastností z modelu do šablony komponenty. 1 <StackPanel Orientation="Horizontal" Grid.Column="2"> 2 <TextBlock Text="{Binding Rating}" Margin="0,2,0,0" 3 TextWrapping="WrapWithOverflow" FontSize="18" 4 Foreground="White"> 5 </TextBlock> 6 <Image Source="{Binding PosterUri}" Width="20" Height="20" 7 Margin="5,-2,0,0" Stretch="UniformToFill"> 8 </Image> 9 </StackPanel> Zdrojový kód 4: Binding vlastností z modelu do šablony komponenty ListBox Třída SubtitleController Instance třídy SubtitleController se stará o výsledky vyhledávání. Výsledky vyhledávání z metod popsaných výše jsou ukládány do kolekce typu ObservableCollection<T> která se v jazyce C# od ostatních kolekcí liší tím, že implementuje rozhraní INotifyCollectionChanged, které automaticky oznamuje to, že byl v kolekci přidán nebo odebrán prvek, takže jakákoliv změna v kolekci je ihned viditelná v uživatelském rozhraní. Kvůli tomu, že ke kolekci přistupuje při vyhledávání a zpracovávání dat, musí být v metodě Add(Subtitle s), která se stará o přidávání prvků, použit monitor, aby při přidávání nedošlo k chybě souběhu tzv. race condition. Třída dále obsahuje metody: SortByDownload SortByName SortByBestMatching Tyto metody se starají o setřídění výsledků podle preferencí uživatele. Výchozí řazené výsledků je podle skóre titulků, které mají přidělené na serveru. Při zavolání metody se vytvoří nové vlákno, které ve třídě Sorting provede seřazení výsledků pomocí LINQ Načítání obrázků Získávání obrázků probíhá odděleně od vyhledávání titulků a spustí se až když jsou data z vyhledávání přidávány do datové třídy. Díky vlastnosti komponenty Image, která umí asynchronně načítat obrázky z url adresy stačí bindingem 16 LINQ = dotazovací jazyk integrovaný v.net Frameworku. 24

25 nastavit komponentě vlastnost Source na hodnotu vlastnosti PosterImgUri z modelu. Model implementuje rozhraní INotifyPropertyChanged, takže jakákoliv změna vlastnosti se projeví i když jsou data už zobrazena v GUI. Díky tomuto mohou být obrázky vyhledávány asynchronně Třída PosterWrapper Instance této třídy se stará o vyhledání obrázku pro titulky ze serveru opensubtitles.org. Obsahuje metodu GetPosterUrl(string imdbid), která provede asynchronní požadavek na webovou službu, kde získá url adresu obrázku kterou vrátí. Komunikace se službou vysvětlena viz Parametr imdbid je identifikátor filmu na serveru imdb.com Třída CSFDWrapper Tato třída slouží pro zjišťování podrobnějších informací ze serveru csfd.cz a stará se o asynchronní komunikaci s webovou službou. Pro získávání obrázku k titulkům ze serveru titulky.com slouží metoda FindPoster(string moviename) kde parametr moviename je název filmu v angličtině. Získávání obrázku je znatelně pomalejší, protože se musí provést dva požadavky na server. Pokud není obrázek z nějakého důvodu nalezen, vrátí se cesta k obrázku, který slouží jako výchozí pokud se obrázek nenajde. Detaily služby jsou popsány v kapitole Další metody třídy: FindCzechName(string moviename) Získá český název filmu z anglického přes webovou službu. Výsledek je uložen do vlastnosti ve třídě Subtitle, která implementuje rozhraní INotifyPropertyChanged což vede k překreslení a přeskupení zobrazených výsledků Omezení duplicitních požadavků na službu Metody pro hledání obrázků k filmu se provádí pro každý nalezený výsledek, tudíž pokud se pro jeden film najde více výsledků začne při hledání docházet k duplicitním požadavkům, které zpomalují vyhledávání pro ostatní výsledky. Aby k tomuto jevu nedocházelo a vyhledávání se zrychlilo je u obou výše popsaných funkcí implementována filtrace požadavků. Pro filtraci se využívá funkcionalita třídy PosterHelper, která je popsána níže. Před každým dotazem na službu se ověří, jestli už dané imdbid nebo moviename existuje ve slovníku. Pokud existuje, vrátí se přímo url adresa obrázku, jinak se provede požadavek na službu a výsledek se vloží do slovníku. 25

26 Třída PosterHelper Instance této statické třídy obsahuje dva slovníky. Jeden je pro obrázky k výsledkům z opensubtitles.org a druhý pro výsledky z titulky.com. Klíčem ve slovnících je imdbid nebo moviename a hodnota je url adresa obrázku Stažení titulků Třída SubtitleDownloader Tato třída se stará o stažení titulků u obou serverů. Každý server to má řešený jinak, proto je nutné mít dvě různé metody pro stažení. Titulky.com Stažení titulků ze serveru titulky.com obstarává metoda DownloadTitulkyCom(string user, string pass, string subtitleid, string path). Metoda zašle požadavek na službu, která nevrátí soubor s titulky, ale neformátovaný text s titulky, který je nutné přečíst a až pak uložit do souboru, který zvolil uživatel. OpenSubtitles.org Instance třídy obsahuje dvě metody popsány níže, které se starají o stažení a uložení titulků na disk. Služba serveru nevrací přímo soubor s titulky, ani text jako služba popsána výše, ale soubor zkomprimovaný pomocí gzip, který je ještě zakódovaný pomocí Base Díky kompresi a zakódovaní souboru se znatelně sníží zatížené serveru při komunikaci. Dekódovaní souboru se řeší na straně klienta, tudíž stažení souboru je rychlé. Výčet metod: Download(string downloadlink, string downloadpath, ref string path) Metoda používaná při náhledu titulků, která stáhne, dekóduje a dekoprimuje soubor. Parametry metody: downloadlink - URL odkaz na soubor s titulky downloadpath - cesta pro uložení souboru. V tomto případě je umístění souboru ve složce Subtitulky, jejíž umístění se nachází v User\ AppData\Roaming ref path - cesta k uloženému souboru. DownloadToLocation(string downloadlink, string downloadpath) Tato metoda stáhne titulky do uživatelem zvoleného adresáře. Jako výchozí jméno pro soubor se použije buď název souboru s filmem - pokud bylo 17 Formát, který převádí binární data na základní tisknutelné znaky. 26

27 vyhledáváno pomocí souboru, nebo název z vyhledávacího pole, pokud bylo hledáno podle textového řetězce Přidání dalších zdrojů titulků Aplikace je navržena tak, aby byla možnost přidání dalších zdrojů titulků s minimální úpravou v kódu. Existuje spousta dalších serverů, ze kterých se dají čerpat data. Pokud server, který budeme chtít přidat, bude poskytovat vlastní službu, tak bude přidání velice jednoduché. Pokud ne, bude nutné vytvořit vlastní službu, která se bude starat o získávání a tu pak integrovat do aplikace. Model pro výsledky vyhledávání je obecný a obsahuje důležité vlastnosti, které jsou pro všechny výsledky stejné. Níže je popsán obecný postup jak přidat další zdroje Postup přidání zdroje 1. Přidání nové třídy, která bude obsahovat metody pro komunikaci se službou a získávání dat, které přidá do datové třídy. 2. Změna třídy SubtitleSearcher Zde bude nutné do přidat do již existující metod SearchByFile a SearchByMovieName kód, který nám vytvoří instanci naší nové třídy a v novém vlákně spustí vyhledávání. 3. Pro získání obrázků se dají použít již výše zmíněné třídy a metody, protože všechny globální servery používají pro filmy identifikátor ze serveru imdb.com. Pro lokální servery s titulky mimo Českou republiku bude nutné přidat třídu, která se postará o získávání obrázků. 4. Změna třídy SubtitleDownloader Zde bude nutné přidat metodu, která se bude starat o stažení a uložení souboru s titulky, protože již existující metody jsou specifické pro každý server. 5. Změna třídy Settings V této třídě bude nutné přidat vlastnost, která bude určovat, zda se při vyhledávání má použít tento zdroj. Dále bude nutné upravit metody DoLoad a DoSave, které se starají u ukládání a načítání nastavení. 6. Poslední úpravou je přidání komponenty checkbox do bočního panelu, přes kterou se bude upravovat nastavení. 4.2 Konzolová verze Konzolová verze (obrázek 4) aplikace slouží pro rychlé vyhledání a stažení titulků pro daný film nebo celou složku bez zbytečné grafiky. Nejčastěji se konzolová 27

28 verze využívá když se vyhledávají titulky k filmu pomocí kontextového menu u souboru nebo složky. Jako zdroj titulků se zde používá pouze server opensubtitles.org, který podporuje vyhledávání podle hashe souboru. Protože se zde vždy vyhledává podle souboru s filmem jsou vráceny jen ty výsledky, které sedí na soubor s filmem Inicializace a hledání V aplikaci jsou dvě možnosti vyhledávání. Vždy se musí spustit s parametrem, který určuje jestli stahujeme titulky přímo pro soubor s filmem, nebo pro celou složku. Pokud se vyhledávání spustí pro film, funkce Main ve třídě Program vytvoří instanci třídy SubtitleSearcher (viz ) a spustí nové vyhledávací vlákno. Pokud se aplikace spustila s parametrem pro složku, první se získají všechny aplikací podporované video soubory, vytvoří se instance třídy SubtitleSearcher a poté se pro každý nalezený soubor spustí vlákno, které se stará o nalezení a stažení titulků. Pro vyhledávání je nutné provést ověření a získat přístupový token ke službě. Tuhle funkčnost implementuje funkce OsdbAgent (viz 4.1.1). Rozdílem oproti grafické verzi je, že pro ověření se používá metoda ConnectSync, která provede synchronní ověření Stažení titulků Kvůli chybějící možnosti interakce a zobrazení titulků před stažením, zde musí být kladen velký důraz na shodu stahovaného souboru s filmem, aby uživatel už napoprvé stáhl ty nejlépe sedící výsledky. Vyhledávání podle hashe někdy nemusí zaručit, že titulky budou sedět a proto probíhá řazení výsledků podle názvu video souboru a názvu titulků. Skoro vždy se titulky, které jsou vytvořené na určitý film, pojmenují stejně jako film podle určité struktury (popsána výše viz ). Pro toto porovnání se používá Levenštejnova vzdálenost [5], která spočítá vzdálenost textových řetězců Třída LevenshteinDistance Tato třída se používá pouze tehdy pokud se provádí vyhledávání z konzolové aplikace. Instance této třídy obsahuje pouze jednu metodu Compute, která spočítá Levenštejnovu vzdálenost mezi názvem video souboru na vstupu a názvem titulků. Metoda vrací číslo, které určuje vzdálenost. Čím nižší číslo je, tím jsou si řetězce podobnější Možnost Zkusit štěstí a spustit Tato možnost je vhodná pro rychlé stažení titulků. Ve třídě SubtitleSearher se pomocí funkce SortByBestMatching, kterou implementuje třída 28

29 SubtitleController provede setřídění výsledků podle vypočítané Levenštejnovu vzdálenosti. Poté se vygeneruje náhodné číslo i [0, n 1], kde n je velikost kolekce titulků, stáhnou se titulky na pozici i z kolekce a spustí se film Možnost Stáhnout titulky pro složku Tato možnost funguje stejně jako možnost popsána výše, až na poslední krok s náhodným číslem. Provede se zde pouze setřídění výsledků a poté se stáhnou titulky z první pozice v kolekci, kde jsou titulky s nejlepší shodou názvu se souborem. Obrázek 4: Konzolová verze aplikace 4.3 Instalátor aplikace Vlastní instalátor aplikace byl napsán kvůli registraci příkazů pro spuštění vyhledávání pomocí kontextového menu a asociaci souborů do systémových registrů. Instalátor při instalaci provede pouze rozbalení komprimovaného ZIP archivu do uživatelem zvoleného umístění. Instalátor také slouží jako nástroj k odinstalování aplikace. Pokud je zvolena tato volba, provede se načtení umístění instalace z registru a odstraní se soubory s aplikací. 29

30 5 Použité technologie 5.1 C # Programovací jazyk C# [13] je programovací jazyk vyvinutý společností Microsoft. Jedná se o vysokoúrovňový, silně typový programovací programovací jazyk, který podporuje objektově orientované programování. Jazyk C# je přenositelný. Zdrojový kód v jazyce se první přeloží do Common Intermediate Language, což je binární kód, který podporuje objektové programování a až poté je interpretovaný virtuálním strojem. Dále jazyk podporuje například automatickou správu paměti tzv. garbage collector a také implicitně typované lokální proměnné pomocí klíčového slova var kdy se datový typ odvodí až v době kompilace z pravé strany. 5.2 WPF Windows Presentation Foundation (WPF) [15] je technologie vyvinutá společností Microsoft pro vytváření bohatého grafického rozhraní aplikací. V.NET frameworku se nachází od verze 3.0. Je zde připravena velká zásoba různých komponent, které se dají různě modifikovat a jednoduše lze také vytvářet nové komponenty. WPF umožňuje pokročilé stylování komponent podobně jako v CSS a pro pozicování prvků se používá místo absolutní pozice (WF) relativní pozice, takže se aplikace zobrazí hezky jak na velkých, tak na malých displejích. Pro tvorbu uživatelského rozhraní se používá jazyk XAML, který je popsán níže. WPF je nástupcem technologie starší technologie Windows Forms (WF), která je zastaralá a nestačila pro moderní aplikace například ve vykreslování grafických objektů kde WPF používá Direct3D. 5.3 XAML Extensible Application Markup Language XAML [11][12] je deklarativní značkovací jazyk vyvinutý společností Microsoft pro návrh uživatelského rozhraní zejména pro technologie WPF, Silverlight a univerzální aplikace pro Windows (UWP). Je založený na jazyku XML. Jazyk složí pro oddělené grafické a logické části aplikace a zjednodušuje zápis, protože to co jde napsat v jazyce XAML jde také napsat složitěji přímo v kódu. Díky zjednodušení zápisu pomocí značek nemusí grafické rozhraní vyvíjet programátor, ale třeba přímo grafik. 5.4 PHP PHP [14]Je dynamický skriptovací programovací jazyk, který se nevykonává na straně klienta, ale na straně serveru a klientu jsou posílány pouze výsledky. Při práci s proměnnými se nemusí uvádět s jakým datovým typem budeme pracovat. Jazyk umožňuje dynamické generování webových stránek a lze ho kombinovat s různými databázovými systémy jako například MySQL, PostgreSQL nebo 30

31 Oracle. Jazyk je interpretovaný a podporuje objektově orientované programování. Pro posílání požadavků na server slouží metody GET (data jsou předávána v URL adrese) a POST (data jsou posílána v těle zprávy). 31

32 6 Použité knihovny třetích stran 6.1 OSDB.net OSDB.net [8] je knihovna napsaná v.net frameworku. Implementuje funkce, které komunikují s webovou službou opensubtitles.org. 6.2 csfd-api Csfd-api [7] je neoficiální knihovna, která pomocí web scrapingu získává data z webu csfd.cz. 6.3 PHP-IMDB-Grabber PHP-IMDB-Grabber [6] je neoficiální knihovna, která umožňuje získávat data ze serveru imdb.com. 6.4 MahApps.Metro MahApps.Metro [10] je knihovna napsaná v jazyce C#, která umožňuje vizualizovat WPF aplikace do Metro designu. 32

33 7 Uživatelský manuál aplikace Následující kapitola slouží jako manuál pro použití aplikace Subtitulky. 7.1 Grafická verze První spuštění aplikace Při prvním spuštění aplikace po instalaci se zobrazí uvítací okno, které slouží jako průvodce aplikací Subtitulky a ukáže uživateli funkce, které aplikace podporuje a jak je efektivně využívat. Okno lze samozřejmě přeskočit a dostat se hned na hlavní obrazovku aplikace. Po zavření průvodce se na úvodní obrazovce zobrazí boční panel s nastavením, aby si před začátkem používání mohl nastavit aplikaci podle sebe Hlavní okno aplikace Hlavní okno aplikace (obrázek 5) se skládá ze 2 částí. První část je záhlaví aplikace, které obsahuje krom tlačítek pro základní práci s oknem taky tlačítka Účet a Nastavení. Druhá část se skládá z dvou vyhledávacích polí, které umožňují buď napsat název filmu ke kterému chceme vyhledat titulky, nebo přímo vybrat film. Obrázek 5: Hlavní okno aplikace Funkce Účet Při zvolení možnost Účet se zobrazí po pravé straně panel na kterém se nachází možnost pro přihlášení do služby titulky.com. Na panelu se nachází dvě textová pole - první pro uživatelské jméno a druhé pro heslo, zaškrtávací políčko, které slouží pro zapamatování přihlášení a tlačítko na přihlášení. Při úspěšném přihlášení se zobrazí pouze tlačítko na odhlášení a jméno přihlášeného uživatele. 33

34 Funkce Nastavení Při zvolení možnosti Nastavení se zobrazí po pravé straně panel na kterém se nachází nastavení celé aplikace. Dostupná nastavení na tomto panelu jsou: Zdroje titulků - umožňuje nastavit na jakém serveru se budou titulky vyhledávat Překlad - umožňuje nastavit jestli se budou názvy filmů překládat do češtiny Jazyk titulků - umožňuje nastavit jazyk ve kterém budou titulky vyhledávány. Lze zvolit více jazyků z nabídky Vyhledávání Pro vyhledávání jsou určená dvě pole, které se nachází uprostřed okna aplikace. Pro vyhledávání podle textu slouží první pole do kterého se napíše hledaný výraz a klávesou enter nebo kliknutím na ikonu lupy se zahájí vyhledávání. Pro vyhledávání podle souboru s filmem slouží druhé pole. Film se může vybrat buď přetažením souboru do tohoto pole, nebo po kliknutí na tlačítko Vybrat soubor které otevře dialogové okno odkud lze vybrat video soubor. Po zvolení souboru se automatiky začnou vyhledávat titulky Okno s výsledky Po ukončení vyhledávání se zobrazí okno s výsledky (obrázek 6). Okno je rozdělené na dvě části. Vrchní část obsahuje ovládací a informační prvky. Spodní část okna obsahuje seznam výsledků vyhledávání Ovládací a informační oblast V této části se nachází kromě dvou vyhledávacích polí, jejichž funkčnost je stejná jako na již výše popisovaná funkčnost na úvodní obrazovce, další textové pole, které slouží na filtrování již nalezených výsledků. Tato funkcionalita umožní rychlejší nelezení hledaných titulků ve více výsledcích. Dále se zde nachází informační popisek s počtem celkových výsledků vyhledávání a popisek zobrazující text podle kterého bylo vyhledáváno a tlačítko Podobné filmy. Funkce Podobné filmy Při kliku na tlačítko Podobné filmy se v dolní části aplikace zobrazí panel, na kterém se nachází výsledky z vyhledávání, které se na základě vyhledávaného filmu snaží nabídnout podobné filmy nebo filmy podobného žánru. Na panelu jsou zobrazeny výsledky s názvem a obrázkem filmu. 34

35 Výsledková oblast Ve výsledkové části okna se nachází seznam, ve kterém jsou panely s jednotlivými výsledky. Výsledky jsou v seznamu seskupovány podle názvu filmu a lze je pro rychlejší orientaci, pokud je nalezeno více filmů, schovávat a nebo rozbalovat. Nad seznamem výsledků se nachází popisky, které popisují položky na panelu s výsledky. Při kliknutí na popisky, které tuto funkčnost podporují se provede vzestupné, nebo sestupné setřídění výsledků. Popisky, které podporují řazení Název - seřadí výsledky podle abecedy Stažení - seřadí výsledky podle počtu stažení Informace na panelu výsledků: Plakát filmu Jméno titulků Zdroj titulků - na jakém serveru byly titulky nalezeny Hodnocení titulků - hodnocení uživatelů, které ale občas není přesné Počet stažení titulků Jazyk titulků - vizualizován vlajkou státu Tlačítko Stáhnout - po kliknutí zobrazí dialog pro výběr umístění pro uložení souboru a uloží titulky do vybraného umístění Tlačítko Zobrazit - po kliknutí se zobrazí náhled titulků pro kontrolu v okně náhled Okno náhled Okno náhled má dva režimy zobrazení. Rozlišuje jestli jsou titulky nalezeny podle souboru s filmem nebo podle textového vyhledávání a podle toho se buď zvolí režim film nebo režim text Režim film Pokud je okno v tomto režimu, tak se po načtení okna spustí vyhledávaný film u kterého jsou zobrazeny titulky, které byly zvoleny k náhledu. Ve spodní části se nachází dva posuvníky. První slouží pro posunování filmu a druhý pro ovládání hlasitosti. Po dvojkliku do oblasti filmu se okno přepne do celoobrazovkového režimu a pokud je kurzor myši v klidu, tak po 4 sekundách zmizí ovládací prvky, 35

36 Obrázek 6: Výsledky vyhledávání které se zase zobrazí pokud se pohne kursorem. Celoobrazovkový lze zrušit klávesou escape, nebo dvojklikem. Tento přehrávač lze použít pro sledování celého filmu, ale jeho primárním účelem je pouze kontrola zda titulky sedí k filmu Režim text V tomto režimu se v okně zobrazí popisek s názvem titulků a ve zbytku okna se zobrazí pouze textový náhled titulků. Pokud se jedná o titulky z opensubtitles.com jsou zobrazeny celé. Pokud jsou titulky nalezené na serveru titulky.com je zobrazena pouze určitá část titulků Kontextové menu Aplikaci lze spustit i pomocí kontextového menu souboru nebo složky. V kontextové menu obsahuje dohromady tři volby. Dvě volby jsou u video souboru a jedna volba je pro složku. Volby jsou popsány níže. Zkusit štěstí a spustit - tato možnost spustí konzolovou aplikaci, která vyhledá titulky k filmu, náhodně vybere jedny titulky z výsledků, stáhne je a poté spustí film. Titulky nemusí být vždy ty správné, ale je to nejrychlejší metoda. Vyhledat titulky - tato možnost spustí grafickou verzi aplikace, vyhledá titulky k filmu a zobrazí nalezené titulky v okně s výsledky. Stáhnout titulky ke všem filmům - tato možnost spustí konzolovou aplikaci, která najde všechny filmy v dané složce a jejich podložkách. Poté pro každý 36