Een OPDS-server instellen op iPhone en iPad (gids 2026)

Kort antwoord: Om een OPDS-server op iPhone of iPad in te stellen: installeer een leesapp die OPDS ondersteunt, open het gedeelte Bibliotheek of Catalogi, voeg een nieuwe catalogus toe, plak de volledige OPDS-URL van de server (bijvoorbeeld http://192.168.1.10:8080/opds voor een Calibre Content Server, niet het kale IP-adres), geef hem een naam en vul alleen een gebruikersnaam en wachtwoord in als de server erom vraagt. Bewaar het, en de app toont elk boek op die server, klaar om te downloaden en offline te lezen. De meest voorkomende fout is het weglaten van het pad /opds of van het poortnummer.

OPDS klinkt als iets waarvoor je een achtergrond in thuisservers nodig hebt, en het blijkt ongeveer twee minuten te kosten zodra je de twee dingen kent waar iedereen over struikelt: het exacte pad dat een server verwacht, en hoe elke server met logins omgaat.

Een opmerking van mij: ik ben Petr Jahoda en ik maak justRead. Ik heb elke OPDS-verbinding die hier beschreven staat zelf opgezet, op echte servers en een echte iPhone, in plaats van een specificatie te parafraseren. De valkuilen hieronder zijn de valkuilen waar ik daadwerkelijk tegenaan liep.

Wat OPDS eigenlijk is

OPDS, het Open Publication Distribution System, is een eenvoudige standaard waarmee een leesapp boeken van een server kan doorbladeren en downloaden. De helderste manier om het voor te stellen: OPDS is RSS voor boeken. Een RSS-lezer wijst naar één feedadres en toont je elk nieuw artikel van die bron. Een OPDS-lezer wijst naar één catalogus-URL en toont je elk boek dat een server aanbiedt, met omslagen, auteurs, beschrijvingen en downloadlinks. Je tikt op een boek, het wordt naar je apparaat gedownload, en je leest het offline.

Omdat het een open standaard is en niet de app van één bedrijf, kan dezelfde lezer via hetzelfde mechanisme verbinden met totaal verschillende bronnen: een publiek-domeinbibliotheek als Project Gutenberg, een mediaserver thuis en je eigen Calibre-collectie spreken allemaal dezelfde taal. Niets zit vast aan een winkel of een account.

Er zijn twee versies die je tegenkomt:

• OPDS 1.2 is de versie die vandaag vrijwel alles spreekt. Het is gebouwd op Atom, het XML-feedformaat, dus een catalogus is in wezen een XML-document dat boeken en subsecties opsomt. Krijg je in 2026 een OPDS-URL aangereikt, dan is het vrijwel zeker 1.2.
• OPDS 2.0 is een nieuwere, op JSON gebaseerde herschrijving van hetzelfde idee. Het is schoner voor ontwikkelaars en begint te verschijnen (Komga bedient bijvoorbeeld beide), maar de adoptie staat nog aan het begin. Je hoeft niet te kiezen: een goede lezer onderhandelt de versie voor je, en 1.2 is wat je in de praktijk gebruikt.

Wat je nodig hebt voordat je begint

Verbinden met een OPDS-catalogus vraagt maar twee stukjes informatie, en vaak alleen het eerste:

1. De catalogus-URL. Dit is het OPDS-eindpunt, en het eindigt meestal op /opds of een vergelijkbaar pad. Voor een openbare catalogus publiceert het project hem op zijn website. Voor je eigen server is het het adres van de server plus het OPDS-pad dat die specifieke software gebruikt. Hier gaan de meeste opstellingen mis, en daar is verderop een hele sectie over.
2. Een gebruikersnaam en wachtwoord, alleen als de server dat vereist. Openbare catalogi zijn doorgaans open. Privéservers, zoals je eigen Calibre of Komga, kunnen een login vragen. Zo ja, dan vul je die één keer in en onthoudt de app hem.

Dat is de hele lijst. Geen account bij derden, geen synchronisatiedienst ertussen, geen bestanden overzetten via een kabel.

Stap 1: Installeer een OPDS-lezer

iOS en iPadOS bladeren zelf niet door OPDS-catalogi, dus je hebt een leesapp nodig die de standaard ondersteunt. justRead is een EPUB- en PDF-lezer voor iPhone en iPad met OPDS ingebouwd: hij komt met Project Gutenberg en het Internet Archive als ingebouwde catalogi, laat je je eigen servers toevoegen, en regelt zoeken aan serverzijde, paginering en bladeren per categorie zodat zelfs enorme catalogi bruikbaar blijven. Welke app je ook kiest, de functie waar je naar zoekt is een OPDS- of Catalogi-gedeelte in de bibliotheek of instellingen. Het overzicht van de OPDS-lezer beschrijft wat de app ondersteunt.

Eén eerlijke beperking om vooraf te noemen: justRead leest EPUB- en PDF-bestanden. OPDS-catalogi die alleen andere formaten aanbieden (stripbestanden, MOBI enzovoort) laten zich nog wel doorbladeren, maar je kunt alleen de EPUB- en PDF-edities downloaden.

Stap 2: Voeg je eerste catalogus toe, stap voor stap

De snelste manier om OPDS aan het werk te zien is een gratis openbare catalogus, en in justRead is de allersnelste er een waarvoor je helemaal niets hoeft te typen.

De route zonder typen (ingebouwd). justRead komt met Project Gutenberg en het Internet Archive als ingebouwde catalogi. Open de Bibliotheek, ga naar het catalogigedeelte, en ze staan er al. Tik op Project Gutenberg en je bladert direct door meer dan 70.000 publiek-domeinboeken, zonder een URL te plakken. Gebruik dit één keer om te bevestigen dat de hele stroom werkt voordat je iets eigens toevoegt.

De handmatige route (elke catalogus). Een catalogus op URL toevoegen gaat in de meeste lezers hetzelfde, en in justRead specifiek zo:

1. Open de Bibliotheek.
2. Kies OPDS-catalogus toevoegen.
3. Plak de catalogus-URL in het adresveld. Plak hem, typ hem niet over, zodat je geen typefout in het pad of de poort kunt introduceren.
4. Geef hem een naam die je later herkent, zoals "Calibre thuis" of "Gutenberg".
5. Vereist de server een login, vul dan gebruikersnaam en wachtwoord in. Laat ze leeg als dat niet zo is.
6. Bewaren.

De catalogus verschijnt nu in je lijst. Tik erop om te bladeren. Grotere catalogi openen in secties waar je doorheen kunt zakken, zodat je per categorie kunt bladeren (op onderwerp, auteur, populairst, recent toegevoegd) in plaats van door één gigantische lijst te scrollen. Gebruik zoeken aan serverzijde om de server direct om een titel of auteur te vragen in plaats van eerst alles te downloaden. Tik op een boek om het te downloaden; het belandt in je bibliotheek en is van jou om offline te lezen.

Die stroom van zes stappen is de hele vaardigheid. Al het overige in deze gids gaat over het goed krijgen van één specifieke waarde: de URL in stap 3.

De /opds-valkuil, uitgediept

Als je één ding meeneemt, neem dan dit mee: de OPDS-URL is bijna nooit alleen het adres van de server. Het kale IP of de kale hostnaam wijst naar de menselijke webpagina van de server, niet naar de machineleesbare OPDS-feed. Wijs een lezer naar http://192.168.1.10:8080 en je krijgt een fout of een lege catalogus; wijs hem naar http://192.168.1.10:8080/opds en je bibliotheek verschijnt. Twee details richten de schade aan, het pad en de poort, en elke server gaat er anders mee om.

• Calibre Content Server biedt OPDS standaard aan op /opds op poort 8080: http://<ip>:8080/opds. Mis je de :8080, dan sterft de verbinding voordat ze begint. Mis je de /opds, dan kom je bij de weblezer uit in plaats van bij de feed.
• Komga biedt zijn OPDS 1.2-feed aan op een dieper pad: http://<host>:25600/opds/v1.2/catalog. De poort is standaard 25600 en de catalogus ligt meerdere segmenten diep, niet op een kale /opds.
• Kavita doet het weer anders: in plaats van een gebruikersnaam en wachtwoord bakt het een API-sleutel rechtstreeks in de URL: http://<host>:5000/api/opds/<jouw-api-sleutel>. Er is geen apart wachtwoord om te typen, want de sleutel in de URL is de credential. Kopieer de volledige, kant-en-klare URL uit de instellingen van Kavita en laat de loginvelden leeg.

Het patroon is: krijg de poort goed, krijg het pad goed, en controleer of de credential in de URL zit of in de loginvelden. Als een verbinding faalt, is het in negen van de tien gevallen een van die drie.

Stap 3: Verbind een Calibre Content Server

De populairste privécatalogus is je eigen Calibre-bibliotheek. Calibre, de gratis desktop-ebookbeheerder, kan je hele collectie in een paar klikken via OPDS publiceren:

1. Open op je computer Calibre en klik op Verbinden/delen in de werkbalk.
2. Kies Content Server starten.
3. Zoek het lokale IP-adres van je computer op (iets als 192.168.1.10). Het OPDS-eindpunt is dan http://192.168.1.10:8080/opds, waarbij 8080 de standaardpoort van Calibre is.

Voeg die URL op je iPhone of iPad toe als nieuwe OPDS-catalogus met de zes stappen hierboven. Twee dingen maken het hier met justRead makkelijker: het kan een Calibre Content Server op hetzelfde Wi-Fi automatisch vinden, zodat je het IP misschien helemaal niet hoeft op te zoeken en te typen, en het ondersteunt HTTP Digest-authenticatie, het loginschema dat Calibre gebruikt wanneer je "Gebruikersnaam en wachtwoord vereisen" aanzet.

Een paar realiteiten van de Content Server die het weten waard zijn: Calibre moet open blijven staan en draaien op de computer, beide apparaten moeten op hetzelfde netwerk zitten tenzij je toegang op afstand instelt, en verandert het IP-adres van de computer (wat thuisrouters uit zichzelf doen), dan verandert de catalogus-URL mee. Een vast IP reserveren in je router, of de .local-hostnaam van de computer gebruiken, voorkomt het "gisteren werkte het en vandaag niet"-probleem.

Wil je dat leesvoortgang en beoordelingen teruggesynchroniseerd worden naar je computer in plaats van alleen eenrichtingsbladeren, dan voegt de Calibre-bibliotheeksynchronisatie tweerichtingssynchronisatie hierbovenop toe. Voor de bredere vraag wat een met Calibre verbonden iOS-lezer werkelijk is, zie Calibre-alternatief voor iOS.

URL-patronen voor zelfgehoste servers

Draai je een thuisserver, dan geldt dezelfde stroom van zes stappen, met het eigen OPDS-eindpunt van elk project:

Opmerkingen bij de tabel: de getoonde poorten zijn de gebruikelijke standaardwaarden van elk project, maar ze kunnen bij installatie allemaal gewijzigd zijn, dus bevestig de jouwe in de instellingen van de server als een verbinding faalt. De standaard van calibre-web is vaak 8083 maar hangt volledig af van hoe je hebt uitgerold (een reverse proxy kan de poort laten vallen ten gunste van een gewone hostnaam). COPS heeft zijn ingang tussen versies verschoven, dus als feed.php niet oplost, kijk dan in je COPS-beheerpagina naar de exacte OPDS-link in plaats van te gokken. Komga biedt ook een OPDS 2.0-feed op /opds/v2, maar het 1.2-catalogus-pad hierboven is het compatibele om mee te beginnen.

justRead ondersteunt eigen OPDS-servers waaronder Calibre OPDS, calibre-web, Kavita, Komga en COPS, met filtering en paginering per server zodat grote catalogi beheersbaar blijven.

Een startlijst met openbare OPDS-catalogi

Je hebt geen eigen server nodig om OPDS te gebruiken. Hieronder staan openbare catalogi die op de publicatiedag opnieuw getest zijn. Alleen URL's die daadwerkelijk een levende OPDS-feed teruggaven staan erin, en over de gene die afgeschermd is ben ik expliciet, in plaats van je naar een link te sturen die stilletjes faalt.

• Project Gutenberg (geverifieerd, geen login): https://www.gutenberg.org/ebooks.opds/. Meer dan 70.000 publiek-domeinboeken, volledig open en legaal te downloaden. Dit is de eerste catalogus bij uitstek. In justRead is hij ingebouwd, dus je hoeft deze URL niet eens te plakken.
• Unglue.it (geverifieerd, geen login): https://unglue.it/api/opds/. Een catalogus met Creative Commons-ebooks die de site voor iedereen gratis heeft gemaakt. Kleiner en eclectischer dan Gutenberg, en volledig open.
• Standard Ebooks (echte feed, maar afgeschermd): het project maakt prachtig gezette publiek-domeinboeken en publiceert inderdaad een OPDS-feed, maar die is niet open voor het publiek: hij is voorbehouden aan leden van de Patrons Circle, aan bijdragers en aan sponsors. Ben je geen lid, behandel Standard Ebooks dan als een bron om vanaf de website te downloaden in plaats van als een OPDS-URL om in te pluggen.

Verschillende catalogi die op oudere lijsten opduiken (Feedbooks, dat in 2024 sloot, en een paar andere) zijn dood of blokkeren nu geautomatiseerde toegang, dus die heb ik weggelaten. Voor een bredere, doorlopend geverifieerde ronde, inclusief de dode feeds die je moet vermijden, zie de beste gratis OPDS-catalogi voor 2026. Die post beantwoordt de vraag "waar wijs ik het heen"; deze beantwoordt "hoe wijs ik het".

HTTP, HTTPS, certificaten en logins

Lokale thuisservers draaien meestal over gewoon HTTP op je eigen netwerk, en dat is prima omdat het verkeer je huis nooit verlaat. Je typt http:// (niet https://) voor een Calibre Content Server op je Wi-Fi, en dat hoort zo.

Zodra je een catalogus van buiten je huis wilt bereiken, gaat HTTPS ertoe doen, en iOS is daar streng in:

• iOS weigert niet-vertrouwde certificaten. Gebruikt je server een zelfondertekend certificaat, dan weigert iOS de verbinding in plaats van in een lezer een "toch doorgaan"-knop te tonen. De betrouwbare oplossing is een echt certificaat: zet de server achter een domeinnaam en geef een gratis certificaat uit (bijvoorbeeld met Let's Encrypt), doorgaans via een reverse proxy. Dan vertrouwt iOS hem als elke gewone website.
• Basic versus Digest-authenticatie. OPDS-servers beveiligen zichzelf met een van twee HTTP-loginschema's. Basic auth stuurt je gebruikersnaam en wachtwoord bij elk verzoek mee (veilig over HTTPS, blootgesteld over gewoon HTTP), terwijl Digest auth een uitdaging-antwoordschema is dat het ruwe wachtwoord nooit verstuurt. De Content Server van Calibre gebruikt Digest, wat justRead ondersteunt. Gebruik voor elke server exact de gebruikersnaam en het wachtwoord die je aan serverzijde hebt ingesteld; één verkeerd teken leest voor de app als "toegang geweigerd", niet als "verkeerd wachtwoord", en daarom vermommen typefouten in de login zich als verbindingsfouten.

Er verschijnt niets? Een volledige controlelijst

Wil een catalogus niet laden, werk deze lijst dan op volgorde af. Elk punt is een echte oorzaak:

1. Verkeerd pad. Je gebruikte het kale adres in plaats van het volledige OPDS-pad. Voeg /opds toe (Calibre), /opds/v1.2/catalog (Komga), of wat je server ook documenteert. Dit is oorzaak nummer één.
2. Ontbrekende poort. Je liet de :8080 (Calibre), :25600 (Komga), :5000 (Kavita) of :8083 (calibre-web) weg. Zonder de poort gaat het verzoek nergens heen.
3. Zelfde netwerk? Voor een thuisserver moeten telefoon en server op hetzelfde Wi-Fi zitten. Telefoons vallen graag terug op mobiel; zit je op 5G en is de server een LAN-only 192.168.x.x-adres, dan is hij simpelweg onbereikbaar.
4. LAN-only IP van buitenaf. Een 192.168.x.x- of 10.x.x.x-adres werkt alleen binnen je huis. Het lost nooit op vanuit een café. Op afstand bereiken vraagt een VPN naar huis, of een echt domein met reverse proxy.
5. Firewall blokkeert de poort. De meest voorkomende Calibre-fout: de server draait, de URL klopt, maar de firewall van de computer blokkeert stilletjes inkomende verbindingen op 8080.
6. Server draait niet echt. Calibre moet open blijven met de Content Server gestart. Laad dezelfde URL in een desktopbrowser op hetzelfde netwerk: kan de browser er ook niet bij, dan ligt het probleem bij de server, niet bij de app.
7. Typefout in de login. Een verkeerde gebruikersnaam of wachtwoord leest als een mislukte verbinding. Voer de gegevens zorgvuldig opnieuw in, let op automatische hoofdletters bij de eerste letter en op een spatie die met plakken meekwam.
8. HTTPS-certificaat geweigerd. Een server op afstand met een zelfondertekend certificaat wordt door iOS geweigerd.
9. Het adres is veranderd. Gisteren werkte het en vandaag niet, omdat de router de computer een nieuw IP gaf. Reserveer een vast IP, of gebruik de .local-hostnaam.

De snelste enkele diagnose is de browsertest van stap 6: open de exacte OPDS-URL in Safari of een desktopbrowser op hetzelfde netwerk. Zie je ruwe XML, dan zijn server en URL in orde en zit het probleem in de app of de inloggegevens. Faalt de browser ook, dan zit het probleem bij de server, de poort of het netwerk, en heb je de zoektocht zojuist gehalveerd.

Waar OPDS in je leesopstelling past

OPDS is de brug tussen een bibliotheek die ergens anders woont en een telefoon waarop je wilt lezen. Voor de vraag wat je op een iPad realistisch met Calibre kunt, zie Calibre op iPad. Ben je helemaal nieuw in EPUB's lezen op iOS, begin dan met EPUB lezen op iPhone en iPad.