Success
Rychlá odpověď: Pro nastavení OPDS serveru na iPhonu nebo iPadu nainstalujte čtečku, která OPDS podporuje, otevřete v ní sekci Knihovna nebo Katalogy, přidejte nový katalog, vložte úplnou OPDS adresu serveru (například http://192.168.1.10:8080/opds pro Calibre Content Server, nikoli holou IP adresu), pojmenujte jej a uživatelské jméno s heslem vyplňte jen tehdy, pokud si je server vyžádá. Uložte to a aplikace vypíše každou knihu na tom serveru, připravenou ke stažení a čtení offline. Nejčastější chybou je vynechání cesty /opds nebo čísla portu.
OPDS zní jako něco, k čemu potřebujete zkušenosti s domácími servery, a přitom vám to zabere asi dvě minuty, jakmile víte o dvou věcech, na kterých každý klopýtne: o přesné cestě, kterou server očekává, a o tom, jak jednotlivé servery řeší přihlašování.
Poznámka ode mě: jmenuji se Petr Jahoda a dělám justRead. Každé OPDS připojení popsané zde jsem nastavoval sám, na skutečných serverech a skutečném iPhonu, místo abych parafrázoval specifikaci. Nástrahy níže jsou ty, na které jsem opravdu narazil.
Co OPDS vlastně je
OPDS, tedy Open Publication Distribution System, je jednoduchý standard, který čtečce umožňuje procházet a stahovat knihy ze serveru. Nejjasnější představa: OPDS je RSS pro knihy. RSS čtečka míří na jednu adresu kanálu a ukáže vám každý nový článek z toho zdroje. OPDS čtečka míří na jednu adresu katalogu a ukáže vám každou knihu, kterou server nabízí, s obálkami, autory, popisy a odkazy ke stažení. Klepnete na knihu, stáhne se do zařízení a čtete ji offline.
Protože jde o otevřený standard, a ne o aplikaci jedné firmy, může se tatáž čtečka přes stejný mechanismus připojit k naprosto odlišným zdrojům: knihovna volných děl jako Project Gutenberg, domácí mediální server i vaše vlastní sbírka v Calibre mluví stejným jazykem. Nic není svázané s obchodem ani s účtem.
Narazíte na dvě verze:
- OPDS 1.2 je verze, kterou dnes mluví prakticky všechno. Staví na Atomu, formátu XML kanálů, takže katalog je v podstatě XML dokument se seznamem knih a podsekcí. Když vám někdo v roce 2026 podá OPDS adresu, jde téměř jistě o 1.2.
- OPDS 2.0 je novější přepis téhož nápadu postavený na JSON. Pro vývojáře je čistší a začíná se objevovat (Komga například nabízí obojí), ale rozšíření je teprve na začátku. Vybírat nemusíte: dobrá čtečka si verzi vyjedná za vás a v praxi použijete 1.2.
Co potřebujete, než začnete
Připojení k jakémukoli OPDS katalogu vyžaduje jen dva údaje, a často jen ten první:
- Adresu katalogu. To je OPDS koncový bod a obvykle končí na
/opdsnebo podobné cestě. U veřejného katalogu ji projekt zveřejňuje na svém webu. U vlastního serveru je to adresa serveru plus OPDS cesta, kterou používá konkrétní software. Právě tady většina nastavení selhává a níže je tomu věnovaná celá sekce. - Uživatelské jméno a heslo, jen pokud je server vyžaduje. Veřejné katalogy bývají otevřené. Soukromé servery, například vaše Calibre nebo Komga, přihlášení vyžadovat mohou. V tom případě je zadáte jednou a aplikace si je zapamatuje.
To je celý seznam. Žádný účet u třetí strany, žádná synchronizační služba mezi tím, žádné přenášení souborů kabelem.
Krok 1: Nainstalujte OPDS čtečku
iOS ani iPadOS OPDS katalogy samy neprocházejí, takže potřebujete aplikaci, která standard podporuje. justRead je čtečka EPUB a PDF pro iPhone a iPad s vestavěným OPDS: přichází s Project Gutenberg a Internet Archive jako vestavěnými katalogy, umožňuje přidat vlastní servery a zvládá vyhledávání na straně serveru, stránkování i procházení podle kategorií, takže i obrovské katalogy zůstanou použitelné. Ať zvolíte kteroukoli aplikaci, hledáte v ní sekci OPDS nebo Katalogy v knihovně či nastavení. Přehled OPDS čtečky popisuje, co aplikace podporuje.
Jedno poctivé omezení hned na začátek: justRead čte soubory EPUB a PDF. Katalogy, které nabízejí pouze jiné formáty (komiksové archivy, MOBI a podobně), se sice budou procházet, ale stáhnout půjdou jen vydání v EPUB a PDF.
Krok 2: Přidejte první katalog, krok za krokem
Nejrychlejší způsob, jak OPDS uvidíte v akci, je bezplatný veřejný katalog, a v justRead je vůbec nejrychlejší ten, který nevyžaduje vůbec žádné psaní.
Cesta bez psaní (vestavěné). justRead přichází s Project Gutenberg a Internet Archive jako vestavěnými katalogy. Otevřete Knihovnu, přejděte do části s katalogy, a už tam jsou. Klepněte na Project Gutenberg a okamžitě procházíte přes 70 000 volných děl, bez jediné adresy k vložení. Použijte to jednou jen k ověření, že celý postup funguje, než začnete přidávat něco vlastního.
Ruční cesta (jakýkoli katalog). Přidání katalogu podle adresy probíhá ve většině čteček stejně, a v justRead konkrétně takto:
- Otevřete Knihovnu.
- Zvolte přidat OPDS katalog.
- Vložte adresu katalogu do pole pro adresu. Vložte ji, nepřepisujte ji ručně, ať do cesty nebo portu nezanesete překlep.
- Pojmenujte jej tak, abyste jej později poznali, třeba „Calibre doma“ nebo „Gutenberg“.
- Pokud server vyžaduje přihlášení, zadejte uživatelské jméno a heslo. Pokud ne, nechte pole prázdná.
- Uložte.
Katalog se objeví ve vašem seznamu. Klepnutím jej procházíte. Větší katalogy se otevírají do sekcí, kterými se dá procházet do hloubky, takže můžete procházet podle kategorií (podle tématu, autora, popularity, nedávno přidaných) místo scrollování jedním obřím seznamem. Vyhledávání na straně serveru se ptá serveru přímo na titul nebo autora, místo aby se nejdřív stahovalo všechno. Klepnutím na knihu ji stáhnete, přistane ve vaší knihovně a je vaše ke čtení offline.
Tento šestikrokový postup je celá dovednost. Všechno ostatní v tomto průvodci se točí kolem toho, aby jedna konkrétní hodnota byla správně: adresa v kroku 3.
Nástraha cesty /opds do hloubky
Pokud si odsud odnesete jedinou věc, ať je to tato: OPDS adresa téměř nikdy není jen adresa serveru. Holá IP nebo název počítače míří na lidskou webovou stránku serveru, ne na jeho strojově čitelný OPDS kanál. Namiřte čtečku na http://192.168.1.10:8080 a dostanete chybu nebo prázdný katalog; namiřte ji na http://192.168.1.10:8080/opds a objeví se vaše knihovna. Škodu působí dva detaily, cesta a port, a každý server je řeší jinak.
- Calibre Content Server nabízí OPDS ve výchozím stavu na
/opdsa portu8080:http://<ip>:8080/opds. Vynecháte-li:8080, spojení zemře dřív, než začne. Vynecháte-li/opds, přistanete u webové čtečky místo u kanálu. - Komga nabízí svůj OPDS 1.2 kanál na hlubší cestě:
http://<host>:25600/opds/v1.2/catalog. Port je ve výchozím stavu 25600 a katalog leží několik segmentů hluboko, ne na holém/opds. - Kavita to dělá zase jinak: místo uživatelského jména a hesla zapéká API klíč přímo do adresy:
http://<host>:5000/api/opds/<váš-api-klíč>. Žádné zvláštní heslo se nezadává, protože tím přihlašovacím údajem je klíč v adrese. Zkopírujte celou předpřipravenou adresu z nastavení Kavity a přihlašovací pole nechte prázdná.
Vzorec zní: mít správný port, mít správnou cestu a ověřit, jestli přihlašovací údaj žije v adrese, nebo v přihlašovacích polích. Když spojení selže, je to v devíti případech z deseti jedna z těch tří věcí.
Krok 3: Připojte Calibre Content Server
Nejoblíbenějším soukromým katalogem je vaše vlastní knihovna Calibre. Calibre, bezplatný správce elektronických knih pro počítač, umí celou vaši sbírku publikovat přes OPDS na pár kliknutí:
- Na počítači otevřete Calibre a klikněte v panelu nástrojů na Připojit/sdílet.
- Zvolte Spustit Content Server.
- Zjistěte místní IP adresu počítače (něco jako
192.168.1.10). OPDS koncový bod pak jehttp://192.168.1.10:8080/opds, kde8080je výchozí port Calibre.
Na iPhonu nebo iPadu tuto adresu přidejte jako nový OPDS katalog šesti kroky výše. Dvě věci to s justRead usnadňují: umí najít Calibre Content Server ve stejné Wi-Fi automaticky, takže IP možná nebudete muset vůbec hledat a psát, a podporuje HTTP Digest autentizaci, což je přihlašovací schéma, které Calibre používá, když zapnete volbu vyžadovat uživatelské jméno a heslo.
Několik skutečností o Content Serveru, které stojí za to znát: Calibre musí na počítači zůstat otevřené a běžet, obě zařízení musí být na stejné síti, pokud nenastavíte vzdálený přístup, a změní-li se IP adresa počítače (což domácí routery dělají samy od sebe), změní se s ní i adresa katalogu. Rezervace pevné IP v routeru nebo použití názvu počítače s příponou .local problém „včera to fungovalo, dnes ne“ odstraní.
Pokud chcete, aby se postup čtení a hodnocení synchronizovaly zpět do počítače, a ne jen jednosměrné procházení, přidává synchronizace knihovny Calibre obousměrnou synchronizaci nad rámec tohoto. Přehled způsobů, jak dostat knihovnu do telefonu, najdete v průvodci jak synchronizovat Calibre s iPhonem a iPadem.
Vzorce adres pro vlastní servery
Pokud provozujete domácí server, platí stejný šestikrokový postup, jen s vlastním OPDS koncovým bodem každého projektu:
| Server | Nejvhodnější pro | Vzorec OPDS koncového bodu |
|---|---|---|
| Calibre Content Server | Vaši stávající knihovnu Calibre na počítači | http://<ip>:8080/opds |
| calibre-web | Knihovnu Calibre s webovým rozhraním, bez otevřené aplikace na počítači | http://<host>:8083/opds |
| Komga | Komiksy a mangu, také EPUB | http://<host>:25600/opds/v1.2/catalog |
| Kavita | Komiksy, mangu a elektronické knihy | http://<host>:5000/api/opds/<váš-api-klíč> |
| COPS | Lehký PHP katalog nad databází Calibre | http://<host>/cops/feed.php |
Poznámky k tabulce: uvedené porty jsou obvyklé výchozí hodnoty jednotlivých projektů, ale kterýkoli z nich lze při instalaci změnit, takže při selhání spojení ověřte ten svůj v nastavení serveru. Výchozí port calibre-web bývá 8083, ale zcela závisí na tom, jak jste jej nasadili (reverzní proxy může port úplně nahradit obyčejným názvem). COPS mezi verzemi měnil vstupní bod, takže pokud se feed.php neozve, podívejte se na přesný OPDS odkaz do administrace COPS místo hádání. Komga nabízí i OPDS 2.0 kanál na /opds/v2, ale kompatibilní start je cesta ke katalogu 1.2 uvedená výše.
justRead podporuje vlastní OPDS servery včetně Calibre OPDS, calibre-web, Kavita, Komga a COPS, s filtrováním a stránkováním pro každý server zvlášť, aby velké katalogy zůstaly zvládnutelné.
Startovní seznam veřejných OPDS katalogů
Vlastní server k používání OPDS nepotřebujete. Níže jsou veřejné katalogy, které byly znovu otestovány v den vydání. Uvedené jsou jen adresy, které skutečně vrátily živý OPDS kanál, a u toho jednoho, který je omezený, je to řečeno naplno, místo abychom vás posílali na odkaz, jenž tiše selže.
- Project Gutenberg (ověřeno, bez přihlášení):
https://www.gutenberg.org/ebooks.opds/. Přes 70 000 volných děl, plně otevřeno a legální ke stažení. Zlatý standard prvního katalogu. V justRead je vestavěný, takže tuto adresu ani vkládat nemusíte. - Unglue.it (ověřeno, bez přihlášení):
https://unglue.it/api/opds/. Katalog knih pod licencí Creative Commons, které web zpřístupnil zdarma všem. Menší a rozmanitější než Gutenberg a zcela otevřený. - Standard Ebooks (skutečný kanál, ale omezený): projekt vydává krásně vysázená volná díla a OPDS kanál skutečně publikuje, ale není otevřený veřejnosti: je vyhrazený členům Patrons Circle, přispěvatelům a sponzorům. Pokud členem nejste, berte Standard Ebooks jako zdroj ke stahování z webu, nikoli jako OPDS adresu k zapojení.
Několik katalogů, které se objevují na starších seznamech (Feedbooks, jenž skončil v roce 2024, a pár dalších), je mrtvých nebo dnes blokuje automatizovaný přístup, takže jsem je vynechal. Širší, průběžně ověřovaný přehled včetně mrtvých kanálů, kterým se vyhnout, najdete v článku nejlepší bezplatné OPDS katalogy pro rok 2026. Ten článek odpovídá na otázku „kam mířit“; tento na otázku „jak mířit“.
HTTP, HTTPS, certifikáty a přihlašování
Místní domácí servery obvykle běží přes obyčejné HTTP ve vaší vlastní síti, a to je v pořádku, protože provoz nikdy neopustí váš dům. Pro Calibre Content Server na vaší Wi-Fi napíšete http:// (nikoli https://), a tak to má být.
Ve chvíli, kdy chcete katalog dosáhnout zvenčí, začíná na HTTPS záležet a iOS je v tom přísný:
- iOS odmítá nedůvěryhodné certifikáty. Používá-li váš server vlastnoručně podepsaný certifikát, iOS spojení odmítne, místo aby ve čtečce nabídl tlačítko „přesto pokračovat“. Spolehlivým řešením je skutečný certifikát: postavte server za doménové jméno a vystavte bezplatný certifikát (například přes Let's Encrypt), obvykle skrze reverzní proxy. Pak mu iOS věří jako každému běžnému webu.
- Basic versus Digest autentizace. OPDS servery se chrání jedním ze dvou HTTP přihlašovacích schémat. Basic posílá jméno a heslo s každým požadavkem (bezpečné přes HTTPS, odhalené přes prosté HTTP), zatímco Digest je schéma výzva-odpověď, které syrové heslo nikdy neposílá. Content Server Calibre používá Digest, který justRead podporuje. U kteréhokoli serveru použijte přesně to jméno a heslo, které jste nastavili na straně serveru; jediný chybný znak se aplikaci jeví jako „přístup odepřen“, nikoli jako „špatné heslo“, a proto se překlepy v přihlášení tváří jako chyby spojení.
Nic se neobjevilo? Úplný kontrolní seznam
Když se katalog nechce načíst, projděte tento seznam popořadě. Každá položka je skutečná příčina:
- Špatná cesta. Použili jste holou adresu místo úplné OPDS cesty. Přidejte
/opds(Calibre),/opds/v1.2/catalog(Komga) nebo to, co dokumentuje váš server. Toto je příčina číslo jedna. - Chybějící port. Vynechali jste
:8080(Calibre),:25600(Komga),:5000(Kavita) nebo:8083(calibre-web). Bez portu požadavek nikam nedojde. - Stejná síť? U domácího serveru musí být telefon i server na stejné Wi-Fi. Telefony rády přeskočí na mobilní data; jste-li na 5G a server má adresu
192.168.x.xplatnou jen v LAN, je prostě nedosažitelný. - LAN adresa zvenčí. Adresa
192.168.x.xnebo10.x.x.xfunguje jen uvnitř vašeho domova. Z kavárny se nikdy nepřeloží. Vzdálený přístup vyžaduje VPN domů nebo řádnou doménu s reverzní proxy. - Firewall blokuje port. Nejčastější selhání u Calibre: server běží, adresa je správná, ale firewall počítače tiše blokuje příchozí spojení na portu 8080.
- Server ve skutečnosti neběží. Calibre musí zůstat otevřené se spuštěným Content Serverem. Načtěte tutéž adresu v prohlížeči na počítači ve stejné síti: pokud se tam prohlížeč nedostane také, problém je v serveru, ne v aplikaci.
- Překlep v přihlášení. Špatné jméno nebo heslo se jeví jako neúspěšné spojení. Zadejte údaje znovu pečlivě a hlídejte automatické velké písmeno na začátku i mezeru přilepenou při vkládání.
- Odmítnutý HTTPS certifikát. Vzdálený server s vlastnoručně podepsaným certifikátem iOS odmítne.
- Změnila se adresa. Včera to fungovalo a dnes ne, protože router přidělil počítači novou IP. Rezervujte pevnou IP nebo použijte název s
.local.
Nejrychlejší jednotlivá diagnostika je test prohlížečem z bodu 6: otevřete přesnou OPDS adresu v Safari nebo v prohlížeči na počítači ve stejné síti. Vidíte-li syrové XML, server i adresa jsou v pořádku a problém je v aplikaci nebo v přihlašovacích údajích. Selže-li i prohlížeč, problém je v serveru, portu nebo síti, a právě jste hledání zúžili na polovinu.
Kam OPDS ve vašem čtení zapadá
OPDS je most mezi knihovnou, která bydlí jinde, a telefonem, na kterém chcete číst. Jste-li ve čtení EPUB na iOS úplně noví, začněte průvodcem jak číst EPUB na iPhonu a iPadu.
← Back to Guides