ID.nl logo
12 tips voor digitale bibliotheek Calibre
© Reshift Digital
Huis

12 tips voor digitale bibliotheek Calibre

E-books zijn nog steeds razend populair en je kunt de digitale boeken op veel verschillende manieren verkrijgen. Dit maakt het wel moeilijk om je collectie van boeken netjes op orde te houden. Met Calibre houd je eenvoudig een bibliotheek bij.

Tip 01: E-books lezen

Van steeds meer al bestaande titels verschijnt ook een digitale versie, en van nieuwe titels is in zo’n tachtig procent van de gevallen ook meteen een e-book-versie beschikbaar. Bovendien zijn er steeds meer websites, zoals De Slegte en Tom Kabinet, waar tweedehands e-books worden aangeboden. Tegelijkertijd wordt het steeds makkelijker om e-books te lezen. Er is een enorm aanbod speciale e-readers en omdat de schermen van tablets en smartphones flink zijn verbeterd, zijn er ook steeds meer mensen die hun boeken op deze apparaten lezen.

Waar het nogal eens misgaat, is als mensen boeken kopen of downloaden bij verschillende aanbieders en deze op verschillende apparaten willen lezen. Hoewel epub het meest gangbare formaat is, worden ook mobi en azw (Kindle) gebruikt. Daarnaast zijn er met name veel oudere boeken die zijn opgeslagen in het pdf-formaat. Niet alle e-readers en apps voor smartphone of tablet kunnen met al deze formaten overweg. Gelukkig biedt Calibre uitkomst.

©PXimport

Epub2 versus epub3

Met een marktaandeel van zo’n 90% is epub het populairste formaat voor e-books. Minder bekend is dat we het dan doorgaans hebben over epub2, terwijl epub3 inmiddels flink in op-komst is. Dit nieuwere formaat biedt mogelijkheden om een e-book interactief te maken en zorgt ervoor dat ook audio en video in boeken kan worden opgenomen. Daarnaast heeft de lezer veel meer invloed op de manier waarop een boek kan worden gelezen. Houd er rekening mee dat epub3 door wat oudere e-readers vaak niet wordt ondersteund. In dat geval heeft Calibre gelukkig de mogelijkheid om een e-book te converteren naar het ou-dere epub2, al kan het dan wel voorkomen dat je bepaalde functionaliteit zult moeten missen.

Tip 02: Calibre

Calibre is al sinds jaar en dag hét programma om je e-books mee te beheren. Dit gratis hulpje ondersteunt alle (on)bekende formaten en maakt het mogelijk om je boekencollectie – of een deel ervan – eventueel te converteren zodat je ze op elk gewenst apparaat kunt lezen. Calibre is, in tegenstelling tot vrijwel alle andere e-bookprogramma’s of -apps, onafhankelijk en ook niet gelieerd aan een bepaalde online boekenwinkel. In plaats van gedwongen winkelnering, kun je rustig checken bij welke winkel een e-book het voordeligst is en dat bestand na aanschaf indien nodig met Calibre converteren naar een voor jouw e-reader geschikt formaat. En het boek vervolgens nog overzetten naar je apparaat. De nieuwste versie van Calibre kun je hier downloaden, waarna je je collectie epubs, pdf’s, mobi’s, iBooks of andere bestanden in een handomdraai kunt toevoegen.

©PXimport

Tip 03: ISBNdb koppelen

Wanneer je één of meerdere boeken in Calibre selecteert en op Ctrl+D drukt, heb je de mogelijkheid om de ontbrekende metadata (titel, auteur, commentaar, uitgever, omslag enzovoort) automatisch van internet op te halen. Een belangrijke bron hiervoor is www.isbndb.com

Voordat Calibre hier ook bij kan, moet je een ISBNdb-account aanmaken. Helaas is dit slechts zeven dagen gratis te proberen, daarna betaal je minimaal (circa) een tientje per maand. Best prijzig dus, maar heb je dat er voor over, dan ga je als volgt te werk:

Ga naar de site, kies in het menu voor Account en volg de stappen. Bevestig je inschrijving door op de link te klikken die je via mail ontvangt. Kies nu op ISBNdb.com bij je account voor Developer Area / Remote Access API / Manage Access Keys en druk op Generate new key. Kopieer vervolgens de gegenereerde sleutel van acht karakters naar het klembord.

Kies in Calibre voor Voorkeuren / Metadata downloaden en klik linksonder bij Bron op ISBNdb. Wanneer je hier nog niets hebt geconfigureerd, staat er een rood kruis voor. Klik vervolgens op de knop Geselecteerde bron configureren. Plak nu achter isbnDB sleutel de sleutel en klik op Opslaan. Wanneer je nu de metadata van een boek opzoekt, wordt voortaan ook de database van ISBNdb geraadpleegd. 

©PXimport

Via ISBNdb voeg je (tegen betaling) automatisch metadata toe aan je boeken

-

Tip 04: Omzetten naar Word

Het is ook mogelijk om boeken in Calibre om te zetten naar docx, zodat je ze kunt bewerken in bijvoorbeeld Microsoft Word of een andere tekstverwerker. Klik hiervoor met de rechtermuisknop op een boek en kies in het menu voor Boeken converteren / Individueel converteren. Kies nu rechtsboven achter Uitvoerformaat voor DOCX. Klik vervolgens op OK om het boek om te zetten. Bij het converteren wordt het oorspronkelijke formaat behouden en een kopie gemaakt in nieuwe formaat. Je kunt dit vervolgens openen door in de bibliotheek, wanneer je een boek hebt aangeklikt, aan de rechterkant (onderdeel Details) achter Formaten te klikken op DOCX.

©PXimport

Tip 05: Virtuele bibliotheken

Naarmate je verzameling boeken groeit, kan het prettig zijn om je collectie in genres te gaan onderbrengen, bijvoorbeeld ‘romans’, ‘Mijn favoriete auteurs’, ‘Engelstalig’, ‘ongelezen’ enzovoort. Dat kan al grotendeels door je boeken tags mee te geven, maar Calibre beschikt ook over de mogelijkheid om zogeheten virtuele bibliotheken aan te maken. Hier wordt dan – aan de hand van bijvoorbeeld zoekterm, auteur en/of tag – slechts een specifiek deel van je verzameling als subcollectie getoond. Het is een handige manier om je bibliotheek overzichtelijk te houden zonder dat je je boeken op verschillende locaties hoeft te bewaren.

Klik linksboven in Calibre op Virtuele bibliotheek en kies Virtuele bibliotheek maken. Geef je virtuele bibliotheek eerst een passende naam. Voer vervolgens een zoekopdracht in of kies een opgeslagen zoek­opdracht. Je kunt ook onderaan klikken op Auteurs, Labels, Uitgevers enzovoort en zo een bibliotheek samenstellen. Klik vervolgens op OK om je bibliotheek op te slaan. Extra tip: druk nogmaals op Virtuele bibliotheek en kies voor Toon virtuele bibliotheekals tabs om voortaan met een muisklik snel tussen je subcollecties te kunnen wisselen.

©PXimport

Tip 06: Ontdubbelen

Bent jij iemand die fanatiek (gratis) boeken van diverse plekken downloadt, dan is de kans groot dat je vroeg of laat dubbele titels in je verzameling hebt. Zeker wanneer je duizenden e-books in je collectie hebt, valt dit niet snel op. Gelukkig is een handige plug-in voor Calibre met de naam Find Duplicates die goed van pas komt om je collectie netjes te houden. Om deze te installeren, ga je naar Voorkeuren en kies je onder Geavanceerd voor Plug-ins. Klik nu op Nieuwe plug-ins verkrijgen, kies in de lijst die verschijnt voor Find Duplicates en druk daarna op Installeren. Je dient Calibre te herstarten en zult daarna een nieuwe knop genaamd Find Duplicates in de werkbalk aantreffen. Klik hierop, voer eventuele parameters in en na enkele seconden verschijnt een overzicht van alle dubbele of zeer op elkaar lijkende boeken.

©PXimport

Tip 07: Uiterlijk aanpassen

Hoewel Calibre veel meer in huis heeft dan alle andere e-bookprogramma’s, is niet iedereen even gecharmeerd van het uiterlijk. Standaard is Calibre nogal zakelijk en een eerste stap om hier wat aan te doen is door rechtsonder op de knoppen te klikken waarmee je de Omslagbrowser en/of het Omslaggrid inschakelt. Deze weergave kun je via de knop Voorkeuren / Uitstraling gevoel (onder Interface) helemaal naar je hand zetten.

Ook interessant is hier het tabblad Hoofdvenster, waar je onder Pictogrammen thema ervoor kunt zorgen dat Calibre andere pictogrammen laat zien waarvan ook de grootte is aan te passen. Ook kun je voor een ander lettertype kiezen en kleuren veranderen.

©PXimport

Tip 08: Meer metadata

Bij tip 3 las je hoe je ISBNdb kunt raadplegen voor ontbrekende metadata van je boeken. Er zijn nog twee belangrijke bronnen, die niet standaard worden geraadpleegd: www.bol.com en www.amazon.nl. Deze zijn echter via plug-ins alsnog aan Calibre toe te voegen. Ga hiervoor naar het onderdeel Nieuwe plug-ins verkrijgen (zie tip 6) en installeer de plug-ins BOL_NL en Amazon.comMultiple Countries. Herstart Calibre. Druk nu op Ctrl+D en kies vervolgens voor Download configureren. Schakel BOL_NL en Amazon.com Multiple Countries in door er een vinkje voor te zetten. Klik bij deze laatste nog even op de knop Geselecteerde bron configureren en zorg er onderaan voor dat de Amazon-website van Nederland is geselecteerd.

Extra tip: interessant bij Bronnen voor Metadata is de kolom Prioriteit omslag. Afhankelijk van het getal dat hier staat (hoe lager, des te meer voorkeur) zal Calibre op die plek een omslag zoeken en downloaden wanneer deze ontbreekt.

Beveiligde boeken

Er zijn zoals besproken meerdere bestandsformaten voor e-books en niet al deze bestanden kun je wijzigen. Sommige bestanden zijn namelijk beveiligd en kun je daarom niet omzetten. Het gaat hierbij om boeken van Amazon (.AZW-bestanden) en .epub- of pdf-bestanden met een DRM-beveiliging. Vaak wordt DRM (digital rights managment) gebruikt als kopieerbeveiliging waarmee je boeken op een beperkt aantal readers kunt gebruiken. Zo kun je boeken delen met bijvoorbeeld je gezin. .AZW-bestanden kun je alleen uitlezen op een Kindle e-reader van Amazon (naast je smartphone of tablet), dus als je een andere e-reader hebt dan kun je dergelijke boeken niet lezen.  Het lastige aan DRM is dat het de betalende gebruiker straft doordat hij zijn aankoop niet vrij kan gebruiken en ook het maken van een back-up vaak onmogelijk wordt. Wil je baas zijn over je eigen gekochte e-books, dan kun je de DRM verwijderen. Uitleggen hoe dat moet, is echter (net als het verwijderen van DRM zelf) in Nederland verboden. Evengoed is op internet veel informatie te vinden.

©PXimport

Tip 09: Bieb verhuizen

Wil je je Calibre-collectie naar een andere locatie verhuizen, bijvoorbeeld omdat je daar meer opslagruimte hebt? Dat gaat gelukkig heel eenvoudig. Kies in de werkbalk voor Calibrebibliotheek en kies onder in het venster voor Verplaats de momenteel gebruikte bibliotheek naar de nieuwe locatie. Gebruik nu de knop achter Nieuwe locatie om de andere plek te selecteren en kies OK.

©PXimport

Je verplaatst je Calibre-boekenkast eenvoudig naar een andere locatie

-

Tip 10: Calibre Server

De meeste mensen verbinden hun e-reader, tablet of smartphone via een usb-kabel met de computer waarop Calibre staat, om e-books via de functie Naar apparaat sturen over te zetten. Een andere manier om dit (draadloos) te doen is door de ingebouwde Calibre-server in te schakelen. Dit doe je via de knop Verbinden/delen / Inhoudsserver starten. Je kunt dan, door het ip-adres van die computer op een ander apparaat in de browser in te typen en hier :8080 achter te zetten, overal in je netwerk bij je boeken. Calibre ondersteunt ook Open Publication Distribution System (opds), wat het delen nog makkelijker maakt. Installeer op je Android- of iOS-apparaat een app als Marvin, FBReader of een andere e-book-app die opds kent, en je kunt je collectie boeken heel eenvoudig op afstand doorzoeken en overzetten. Je kunt de server configureren via Voorkeuren / Delen via (Inter)net. Calibre Server gebruikt standaard geen https, waardoor de uitwisseling van gegevens niet veilig is. Gebruik deze server dan ook alleen binnen je eigen netwerk, tenzij je weet hoe je zelf een beveiligingslaag kunt aanbrengen.

©PXimport

Zijn e-books goedkoper? 

Hoewel je wellicht denkt dat e-book veel goedkoper moeten zijn dan gedrukte boeken, is dat niet zo. Het drukken en verspreiden van fysieke boeken vormt een kleiner gedeelte van de totale kosten als je wellicht zou denken. Nieuwe e-books zijn daardoor meestal net zo duur als hun fysieke tegenhangers. Op oudere e-books kun je vaak wel goede aanbiedingen vinden. Daarnaast hebben zowel Amazon als Kobo een abonnement waarin je onbeperkt boeken kunt lezen. Voor veellezers interessant, al krijg je met een dergelijk abonnement geen toegang tot het hele aanbod e-books. Het gaat om een selectie uit het totale aanbod.

Tip 11: Nieuwslezer

Het is in Calibre mogelijk om via rss allerlei nieuws uit externe bronnen te betrekken en er op gezette tijden automatisch een e-book of e-magazine van te maken. Standaard zijn er meer dan 1600 nieuwsbronnen in binnen- en buitenland waaruit je een selectie kunt maken: een handige manier om ervoor te zorgen dat de hoogtepunten dagelijks in Calibre – of je mobiele apparaat – in e-book-formaat worden getoond. Druk boven in de werkbalk op de knop Nieuws downloaden om een overzicht te krijgen van alle nieuwsbronnen, gerubriceerd op land. Maak je keuze en geef aan met welke frequentie het nieuws moet worden opgehaald. Nieuws dat is binnengehaald, vind je vervolgens links onder het label Nieuws. Calibre maakt gebruik van standaard rss-feeds voor het binnenhalen van nieuws. Wil je een andere nieuwsbron toevoegen, klik dan op het pijltje naast de knop Nieuws downloaden en kies voor Een aangepaste nieuwsbron toevoegen.

©PXimport

Een handige manier om ervoor te zorgen dat je al het nieuws dagelijks als e-book krijgt

-

Tip 12: Calibre Companion

De makkelijkste manier om via Calibre je e-books op je Android of iOS-apparaten over te zetten, is via de relatief nieuwe Calibre Companion-app die voor deze twee platformen beschikbaar is. Installeer de app op je smartphone/tablet, selecteer vervolgens in Calibre de boeken die je wilt delen en kies voor Verbinden/delen / Draadloze apparaat-verbinding maken. Je kunt natuurlijk ook contact maken vai Calibre Server (tip 10) en zo e-books naar je mobiele apparaat downloaden. Calibre Companion is vooral bedoeld om je digitale bibliotheek goed te organiseren. Om boeken daadwerkelijk te kunnen lezen, heb je nog een aparte e-reader-app nodig.

De geschiedenis van Calibre

De oervader van Calibre – Linprs500 – werd geboren in 2006, het jaar waarin ook het eerste commerciële e-ink-apparaat op de markt verscheen: de PRS-500. Deze reader van Sony werkte niet met Linux en gebruikte bovendien het afwijkend lrf-bestandsformaat voor de boeken. Kovid Goyal ontwikkelde daarom het hulpje Linprs500 waarmee de PRS-500 ook met Linux-pc’s kon communiceren én het mogelijk werd om andere e-boekformaten om te zetten naar lrf en andersom. In 2008 kreeg Linprs500 een grafische schil en omdat het inmiddels ook andere e-bookreaders ondersteunde, werd het omgedoopt tot Calibre. Aardig detail is dat je deze naam volgens de maker hoort uit te spreken als ‘Cali-ber’ en dus niet als ‘Ca-libre’. In de jaren daarop is Calibre uitgegroeid tot hét hulpmiddel voor het beheren en bewerken van e-bookbibliotheken en is het beschikbaar gekomen in tientallen verschillende talen. Waar tegenwoordig veel e-readers de gebruiker min of meer dwingen om e-boeken bij een bepaalde winkel aan te schaffen en weinig flexibiliteit bieden, streeft Calibre ernaar om je zelf te laten bepalen waar je je boeken koopt en op welke apparaten je ze leest. En daar mag best voor gedoneerd worden.

▼ Volgende artikel
Bouw je eigen dashboard met Homepage: al je webapplicaties overzichtelijk op één plek
Huis

Bouw je eigen dashboard met Homepage: al je webapplicaties overzichtelijk op één plek

Heb je meer dan een handvol webapplicaties op een Linux-server draaien? Dan is een dashboard met links naar deze applicaties een uitkomst. Het project Homepage biedt precies dat, inclusief widgets die allerlei statistieken van je services weergeven. In dit artikel installeren we Homepage en laten we je zien hoe je het integreert met je bestaande services.

Dit gaan we doen

In deze masterclass richten we een persoonlijk dashboard in met Homepage. Je leert hoe je de tool installeert in Docker, services groepeert en uitbreidt met widgets voor statistieken zoals cpu- en geheugengebruik, uptime of weersinformatie. We laten zien hoe je containers automatisch herkent, monitoring toevoegt en ook bladwijzers of alternatieve dashboards gebruikt. Zo krijg je één centrale plek waar je al je webapplicaties en services snel terugvindt en beheert.

Lees ook: Windows gebruiken naast of binnen Linux? Zo krijg je het soepel aan de praat met Docker


⬇️ Code downloaden

In dit artikel staat voorbeelden met YAML-code. Omdat YAML erg gevoelig is voor foute spaties en inspringingen, kun je die code beter downloaden en daarna bekijken of kopiëren. Zie het bestand homecode.txt, beschikbaar via deze link.


Homepage helpt je om diverse webapplicaties in één dashboard te organiseren. Dit is handig als je services in Docker-containers draait of eenvoudig toegang wilt tot de beheerpagina’s van apparaten zoals je modem, router en NAS.

Hoewel dit klinkt als een veredelde bookmark-manager, doet Homepage meer dan alleen links op een pagina verzamelen. Het project ondersteunt widgets voor meer dan honderd services en kan zo bijvoorbeeld het cpu- en geheugenverbruik van je hypervisor of het aantal ongelezen artikels in je RSS-lezer tonen. Je hoeft daardoor vaak zelfs niet op de links te klikken om even snel de status van je services te bekijken.

Docker Compose

We gaan ervan uit dat je een Linux-server hebt waarop je services met behulp van Docker Compose in Docker-containers draait. Homepage draai je dan gewoon in een Docker-container naast je bestaande services, al zijn er ook andere installatie-opties. In ons voorbeeld draaien we Docker op Debian 12. Maak om te beginnen een map waarin de container van Homepage zijn data en configuratie kan opslaan, met deze opdracht:

$ mkdir -p containers/homepage

Zet vervolgens in je bestand docker-compose.yml (het bestand waarin je al je containers definieert) een service voor Homepage:

services:

  homepage:

    image: ghcr.io/gethomepage/homepage:latest

    container_name: homepage

    ports:

      - 3000:3000

    volumes:

      - /home/koan/containers/homepage:/app/config

    environment:

      HOMEPAGE_ALLOWED_HOSTS: debian.home:3000

    restart: unless-stopped

Homepage kun je op diverse manieren installeren.

Homepage opstarten

Wijzig in het gedefinieerde volume de directory vóór de dubbele punt naar het volledige pad van de directory die je voor de container hebt aangemaakt. Stel de waarde van de omgevingsvariabele HOMEPAGE_ALLOWED_HOSTS gelijk aan het domein of het ip-adres van de host, gescheiden door een dubbele punt van het poortnummer. Als je met een reverse proxy werkt, zet je hier het domein waarop de applicatie via die proxy bereikbaar is.

Start de container met:

$ docker-compose up -d

Zodra het image gedownload is en de container draait, open je Homepage in je browser op de url die je in HOMEPAGE_ALLOWED_HOSTS hebt gedefinieerd. Je ziet dan een voorbeeldpagina met van boven naar onder een header, groepen met services en groepen met bladwijzers.

Het standaarddashboard van Homepage vlak na de installatie.

Informatiewidgets

In de header vind je enkele informatiewidgets. Hoewel deze niet de kern van de functionaliteit van Homepage uitmaken, bieden ze nuttige aanvullende informatie. Standaard zie je het cpu-verbruik, het beschikbare geheugen en de vrije schijfruimte van de host. Er is ook een tekstveld om te zoeken via DuckDuckGo. De definitie van deze twee widgets vind je in het bestand widgets.yaml in de directory van de Homepage-container.

In de online documentatie van de informatiewidgets lees je hoe je hun gedrag aanpast. Zo kunnen we de widget Resources ook de uptime van het systeem laten tonen (uptime: true) en met de optie expanded: true meer informatie over de cpu, het geheugen en de schijfruimte laten weergeven. De widget ziet er dan als volgt uit in widgets.yaml:

- resources:

    label: System

    expanded: true

    cpu: true

    memory: true

    uptime: true

    disk: /

Weersomstandigheden

Homepage biedt twee widgets om het weer in de header te tonen: één via Open-Meteo en één via OpenWeatherMap. De eerste vereist geen registratie, dus daarvoor hoef je alleen maar de gps-coördinaten van je locatie in te voeren. In widgets.yaml ziet dat er als volgt uit:

- openmeteo:

    label: Attenrode

    latitude: 50.8773405

    longitude: 4.9213237

    timezone: Europe/Brussels

    units: metric

    cache: 5

    format:

      maximumFractionDigits: 1

Met cache: 5 laten we de widget de weergegevens vijf minuten lang cachen om de servers van Open-Meteo te ontlasten. Verder biedt Homepage nog andere informatiewidgets aan, bijvoorbeeld voor beurskoersen of de datum en tijd.

In de header van Homepage plaats je allerlei informatiewidgets.

Services toevoegen

De kernfunctionaliteit van Homepage ligt uiteraard in het groeperen van services in één dashboard. De standaardconfiguratie voegt drie groepen toe met elk één service. De YAML-code hiervoor vind je in het bestand services.yaml. Vervang die door je eigen groepen. Je kunt bijvoorbeeld een groep Network aanmaken met links naar de beheerinterfaces van je modem/router en accesspoints:

- Network:

  - Proximus:

      href: http://192.168.1.1

      description: Modem

      icon: mdi-web

  - OpenWrt:

      href: http://gl-mt3000.home

      description: Accesspoint

      icon: openwrt

De eigenschap icon kan een absolute url zijn of een naam uit de lijst op de website Dashboard Icons. Begin de naam van een pictogram met mdi- voor een keuze uit Material Design Icons , met si- voor een keuze uit Simple, of met sh- voor een keuze uit Self-Hosted Dashboard Icons.

Ook groepen kunnen een pictogram krijgen. Dat definieer je dan in het bestand settings.yaml:

layout:

  Network:

    icon: mdi-lan-connect

  Infrastructure:

    icon: mdi-server-network

  Services:

    icon: mdi-apps

Services en groepen kun je pictogrammen geven, bijvoorbeeld van de website Self-Hosted Dashboard Icons.

Servicewidgets

Tot nu toe lijkt ons dashboard wat op een veredeld lijstje met bladwijzers. Maar Homepage ondersteunt ook servicewidgets voor meer dan honderd services. Controleer in de lijst of je services ondersteund zijn. Draai je bijvoorbeeld OPNsense op je router, dan krijg je met de volgende widget de processorbelasting, het gebruikte geheugen, en de upload- en downloadhoeveelheden van je WAN-interface te zien:

- OPNsense:

      href: https://opnsense.home

      description: Router

      icon: opnsense

      widget:

        type: opnsense

        url: https://opnsense.home

        username: KEY

        password: SECRET

Voor username en password vul je de API-sleutel en het ‘secret’ in die je in de webinterface van OPNsense aanmaakt via System / Access / Users. De documentatie van Homepage voor de OPNsense-widget legt dit gedetailleerd uit. Wil je slechts een deel van de statistieken zien, dan kan dat door de widget uit te breiden met een regel als:

fields: ["wanDownload", "wanUpload"]

Homepage ondersteunt widgets voor meer dan honderd services.

Meerdere widgets

Je kunt een service ook van meerdere widgets voorzien. Dat is bijvoorbeeld handig bij monitoringtools zoals Uptime Kuma. Voeg aan de OPNsense-service dan de OPNsense-widget toe voor servicespecifieke statistieken en de widget van Uptime Kuma voor beschikbaarheidsstatistieken. In plaats van één object widget bevat de service dan een object widgets met een lijst die beide widgets bevat:

  - OPNsense:

      href: https://opnsense.home

      description: Router

      icon: opnsense

      widgets:

        - type: opnsense

          url: https://opnsense.home

          username: KEY

          password: SECRET

        - type: uptimekuma

          url: https://uptime-kuma.rubus.home

          slug: router

          fields: ["uptime", "incident"]

De widget van Uptime Kuma gebruikt data van een statuspagina. Die moet je dus eerst in Uptime Kuma aanmaken, en de naam van de statuspagina vul je bij slug in de widget in. Als de statuspagina bijvoorbeeld toegankelijk is via https://uptime-kuma.rubus.home/status/router, dan is de slug router.

Homepage kan een statuspagina van Uptime Kuma in een service integreren.

Beschikbaarheid monitoren

Ook zonder speciale monitoringtools kun je met Homepage eenvoudig te zien krijgen of al je services momenteel online zijn. Dat kan met de eigenschap ping of siteMonitor in de service. Voeg bijvoorbeeld aan de service voor OPNsense ping: opnsense.home toe. Homepage stuurt dan regelmatig een ICMP-echopakket (ping) naar de host en toont de beschikbaarheid in de rechterbovenhoek van het kader van de service.

Met siteMonitor: https://opnsense.home daarentegen voert Homepage een HTTP HEAD-verzoek uit naar de url om te controleren of de webpagina beschikbaar is. Zo weet je niet alleen dat de host online is, maar ook dat de webserver tenminste draait en de pagina aanbiedt. Let op dat je hier de volledige url met https:// of http:// dient te gebruiken. De stijl van de getoonde status kun je overigens in settings.yaml aanpassen met bijvoorbeeld statusStyle: dot of statusStyle: basic.

Enkele services met pictogrammen, widgets en statusinformatie.

Docker-containers integreren

Als je services in Docker-containers draait, kan Homepage via de API van de Docker-engine statistieken over die containers opvragen en zelfs automatisch services herkennen. Configureer hiervoor een Docker-instance voor Homepage in docker.yaml. Als je Homepage met de Docker-socket laat verbinden, kan dat met de volgende configuratie:

local-docker:

  socket: /var/run/docker.sock

In je Docker Compose-bestand moet je deze socket als volume in de Homepage-container aankoppelen:

    volumes:

      - /home/koan/containers/homepage:/app/config

      - /var/run/docker.sock:/var/run/docker.sock

Docker Socket Proxy

Een veiliger alternatief om Homepage toegang tot Docker te geven, is via Docker Socket Proxy. Je laat die laatste dan rechtstreeks met de Docker-socket verbinden en de andere containers via een HTTP API beperkte bevoegdheden geven. Voeg daarvoor in je Docker Compose-bestand de volgende service voor Docker Socket Proxy toe:

  docker-socket-proxy:

    image: ghcr.io/tecnativa/docker-socket-proxy:0.3.0

    container_name: docker-socket-proxy

    volumes:

      - /var/run/docker.sock:/var/run/docker.sock:ro

    environment:

      CONTAINERS: 1

    restart: unless-stopped

Standaard geeft Docker Socket Proxy sterk ingeperkte API-toegang tot de Docker-engine, en sowieso alleen-lezen. Met de omgevingsvariabele CONTAINERS: 1 geven we toegang tot informatie over containers, precies wat Homepage nodig heeft.

Wijzig nu in het bestand docker.yaml de definitie van local-docker naar:

local-docker:

  host: docker-socket-proxy

  port: 2375

Omdat de container van Docker Socket Proxy zich in hetzelfde netwerk als Homepage bevindt, is die onder de naam docker-socket-proxy bereikbaar, wat we hier als host invullen.

Maak dan de containers opnieuw aan met de opdrachten:

docker-compose down

docker-compose up -d

Containers monitoren

Containers die in hetzelfde Docker Compose-bestand als Homepage zijn gedefinieerd, kun je nu door die laatste laten monitoren. Je moet dan bij de service in services.yaml de Docker-server en de naam van de container opgeven, bijvoorbeeld:

- Services:

  - FreshRSS:

      href: http://debian.home:8081

      description: Feed aggregator

      icon: freshrss

      server: local-docker

      container: freshrss

De waarde van server is hier de naam van de Docker-instance in docker.yaml, namelijk local-docker. De waarde van container is hier de naam van de container, gedefinieerd in container_name in het Docker Compose-bestand.

Na het herladen van de webpagina van Homepage krijgt de FreshRSS-service de status RUNNING in de rechterbovenhoek of EXITED wanneer de container gestopt is. Klik op de status voor gedetailleerdere statistieken zoals de processorbelasting, het geheugengebruik en netwerkverkeer.

Services automatisch detecteren

Elke keer dat je nu een service toevoegt, moet je de container aan je Docker Compose-bestand toevoegen en een definitie van de service aan het bestand services.yaml van Homepage. Maar Homepage ondersteunt ook het automatisch detecteren van services voor containers met behulp van labels. Met deze aanpak hoef je services.yaml niet meer bij te werken en hoef je slechts één bestand te veranderen. Voor FreshRSS kan dat bijvoorbeeld als volgt:

  freshrss:

    image: docker.io/freshrss/freshrss:1.26.1-alpine

    container_name: freshrss

    ports:

      - 8081:80

    volumes:

      - /home/koan/containers/freshrss/data:/var/www/FreshRSS/data

      - /home/koan/containers/freshrss/extensions:/var/www/FreshRSS/extensions

    environment:

      CRON_MIN: "1,31"

      TZ: Europe/Brussels

    restart: unless-stopped

    labels:

      - homepage.group=Services

      - homepage.name=FreshRSS

      - homepage.href=http://debian.home:8081

      - homepage.description=Feed aggregator

      - homepage.icon=freshrss

In de labels van deze container geef je dus aan dat je in de groep Services een service met de naam FreshRSS toevoegen, met de gegeven link, beschrijving en pictogram. De opties server en container uit de vorige paragraaf zijn met deze aanpak overbodig, omdat Homepage deze automatisch via de API van de geconfigureerde Docker-instance verkrijgt. Na opnieuw het uitvoeren de volgende twee commando’s ontdekt Homepage automatisch de service en voegt deze aan de juiste groep toe:

docker-compose down

docker-compose up -d

Widgets

Op dezelfde manier kun je widgets toevoegen via labels. In het voorbeeld uit de vorige stap voeg je dan de volgende labels toe:

      - homepage.widget.type=freshrss

      - homepage.widget.url=http://freshrss

      - homepage.widget.username=USER

      - homepage.widget.password=PASSWORD

Wil je meerdere widgets aan een container toevoegen, geef dan elk widget een index:

      - homepage.widgets[0].type=freshrss

      - homepage.widgets[0].url=http://freshrss

      - homepage.widgets[0].username=USER

      - homepage.widgets[0].password=PASSWORD

      - homepage.widgets[1].type=uptimekuma

      - homepage.widgets[1].url=https://uptime-kuma.rubus.home

      - homepage.widgets[1].slug=freshrss

Wanneer je nu de container van FreshRSS opnieuw aanmaakt en opstart, detecteert Homepage de widgets en toont ze bij de service.

Alternatieven voor Homepage

Hoewel Homepage een krachtige tool is, zijn er talrijke alternatieven om een dashboard voor al je services te maken, elk met hun eigen benadering. Houd je niet van YAML-configuraties, dan biedt Homarr een gebruiksvriendelijk alternatief om met slepen en neerzetten allerlei services toe te voegen.

Ook populair is Heimdall. Het is minder naar eigen smaak aan te passen dan Homepage of Homarr, maar daardoor eenvoudig om mee aan de slag te gaan.

Bevalt de aanpak met YAML-bestanden je wel, maar ligt Homepage je niet helemaal, kijk dan eens naar Dashy.

Bookmarks

Tot slot kan Homepage ook gewone bladwijzers aan je dashboard toevoegen. Je kunt ze net op dezelfde manier als services groeperen, maar het zijn slechts links zonder extra functionaliteiten zoals widgets en monitoring. Bladwijzers definieer je in het bestand bookmarks.yaml van Homepage, dat er standaard als volgt uitziet:

- Developer:

  - GitHub:

    - abbr: GH

      href: https://github.com

- Social:

  - Reddit:

    - abbr: RE

      href: https://reddit.com

- Entertainment:

  - YouTube:

    - abbr: YT

      href: https://youtube.com

Vervang deze groepen met bladwijzers door jouw eigen keuzes. Dit is bijvoorbeeld handig om alle links naar portaalsites of accounts bij belangrijke diensten op één pagina te verzamelen. Homepage toont dan per groep een lijst met bladwijzers met hun afkorting (de waarde van abbr), naam en het domein van de link.

Wil je in plaats van een afkorting een pictogram bij een bladwijzer tonen, gebruik dan icon in plaats van abbr en geef daar net zoals bij services de naam van een pictogram op. En vul description bij een bladwijzer in om een beschrijving in de plaats van het domein te zien. Ook de groepen van bladwijzers kun je een pictogram geven. Net zoals voor de groepen van services definieer je die pictogrammen in settings.yaml.

Een volledig dashboard van Homepage met header, services en bladwijzers.

En verder

Homepage biedt nog veel meer mogelijkheden dan we hier kunnen behandelen. Vooral in het bestand settings.yaml zijn er nog allerlei aanpassingen mogelijk. Zo kun je een achtergrondafbeelding instellen en daarop allerlei filters toepassen. Ook het thema en het kleurenpalet, die je beide via pictogrammen onderaan de pagina kunt aanpassen, zijn vast in te stellen.

Ook de lay-out van het dashboard is configureerbaar. Zo neemt standaard elke groep een kolom in, waarbij de services onder elkaar komen te staan. Maar met style: row bij een groep laat je de services in die groep naast elkaar in een rij weergeven. Ook het aantal kolommen, de stijl van de header en nog meer zijn in te stellen.

Homepage is tot in de kleinste details aan te passen.

Speciaal voor de jongste Linux-fans

(dit vinden ze zeker leuk!)
▼ Volgende artikel
Waar voor je geld: 5 mini-pc's als desktop- of laptopvervanger
© ID.nl
Huis

Waar voor je geld: 5 mini-pc's als desktop- of laptopvervanger

In de rubriek Waar voor je geld gaan we op zoek naar producten voor een mooie prijs die je leven makkelijk(er) maken. Werk je vaak thuis, maar is je werkplek niet al te groot? Dan kun je overwegen om een klein formaat pc aan te schaffen. Een mini-pc voldoet aan die behoefte, het enige dat nodig is, is een aparte monitor.

Een mini-pc kan een goede oplossing zijn voor thuiswerkplekken die niet al te groot zijn, of waar je simpelweg gewoon een opgeruimder bureau wil hebben. Mini-pc's zijn compact, maar snel en veelzijdig genoeg om er je gewone werk op te doen of om op te gamen. Wij vonden vijf krachtige mini-pc's voor je.

Acer Revo Box RB102-01W Mini

De Acer Revo Box RB102-01W Mini is een compacte computer die zijn rekenkracht ontleent aan een Intel Core Ultra 5 125U processor. Deze processor is ontworpen om een balans te bieden tussen prestaties en energie-efficiëntie. Voor het uitvoeren van je dagelijkse taken en het wisselen tussen verschillende applicaties beschikt het systeem over 8 GB aan DDR5 werkgeheugen. De opslag van je bestanden, software en het besturingssysteem wordt verzorgd door een 512 GB SSD, wat bijdraagt aan snelle opstart- en laadtijden. Qua connectiviteit kun je gebruikmaken van een reeks poorten. Zo zijn er meerdere USB-aansluitingen beschikbaar voor je randapparatuur. Voor het aansluiten van beeldschermen is de mini-pc uitgerust met zowel een HDMI- als een DisplayPort-uitgang. Om verbinding te maken met een netwerk, is er een 2.5 Gigabit Ethernetpoort aanwezig. Het systeem wordt geleverd met Windows 11 voorgeïnstalleerd.

Specificaties

Formaat: 13,1 x 13,1 x 4,3 cm
Processor:
Intel Core Ultra 5 125U
Werkgeheugen:
8 GB DDR5
Harde schijf:
512 GB SSD
Netwerk:
Wifi 6E, Bluetooth, 2.5 Gigabit LAN

MSI Cubi 5 12M-002EU

De MSI Cubi 5 12M-002EU is een rappe mini-pc van slechts 12,4 × 12,4 × 5,4 centimeter. Via de bijgesloten VESA-beugel monteer je de behuizing optioneel achterop een pc-monitor. Ondanks het nogal kleine formaat betreft het een volwaardige pc waarop je één of twee schermen kunt aansluiten. Gebruik hiervoor de HDMI- en/of DisplayPort-aansluiting aan de achterzijde. Verder zien we hier twee netwerk- en usb-poorten. Via drie usb-ingangen aan de voorzijde sluit je makkelijk randapparaten aan. Voor draadloze communicatie heeft de binnenzijde een bluetooth- en wifi-adapter.

In het kleine 'doosje' zit een ssd van 512 GB. Hierop is Windows 11 Pro voorgeïnstalleerd. Om die reden leent de Cubi 5 12M-002EU zich goed voor zakelijke gebruikers, want deze Windows-editie beschikt over extra veiligheidsfuncties. De Intel Core i5-1235U-processor voldoet voor dagelijkse pc-taken prima. Deze processor heeft tien rekenkernen waarvan de snelste twee zijn afgeregeld op een maximale klokfrequentie van 4,4 GHz. Tot slot is er een geheugenmodule van 8 GB RAM ingebouwd. Blijkt dat op den duur onvoldoende, dan kun je eventueel upgraden naar maximaal 64 GB RAM. Deze mini-pc is als alternatief ook met meer rekenpower verkrijgbaar.

Specificaties

Formaat: 12,4 x 12,4 x 5,4 cm
Processor:
Intel Core i5-1235U
Werkgeheugen:
8 GB DDR4
Harde schijf:
512 GB SSD
Netwerk:
Wifi 6E, Bluetooth 5.3, 1x Gigabit LAN, 1x 2.5 Gigabit LAN

Lenovo ThinkCentre M70q Gen 5 Mini PC 

De Lenovo ThinkCentre M70q Gen 5 is een compacte computer die zijn prestaties haalt uit een Intel Core i5-14400T processor. Voor het uitvoeren van je taken en het draaien van software is het systeem voorzien van 16 GB aan DDR5 werkgeheugen. Dit type geheugen heeft een hogere snelheid dan zijn voorganger, DDR4. Als het gaat om de opslag van je bestanden en programma's, dan maak je gebruik van een 512 GB SSD. De aanwezigheid van een SSD is van invloed op de opstarttijd van de computer en de laadsnelheid van je applicaties. Verbindingen met het internet en je lokale netwerk leg je via de ingebouwde Wi-Fi 6 (802.11ax) module of de aanwezige ethernetpoort. Voor het koppelen van randapparatuur zoals een monitor, muis of extern opslagapparaat, beschikt de mini-pc over een variatie aan poorten, waaronder HDMI, DisplayPort en meerdere USB-aansluitingen. Het besturingssysteem dat vooraf geïnstalleerd is, is Windows 11 Pro.

Specificaties

Formaat: 17,9 x 18,3 x 3,7 cm
Processor:
Intel Core i5-14400T
Werkgeheugen:
16 GB DDR5
Harde schijf:
512 GB SSD
Netwerk:
Wifi 6E, Bluetooth 5.3, Gigabit LAN

DELL OptiPlex 3000 Thin Client - N6005

De DELL OptiPlex 3000 in deze Thin Client-uitvoering is een systeem dat is ontworpen voor specifieke computertaken. Het apparaat draait op een Intel Pentium Silver N6005 processor, een chip die de basis vormt voor de functionaliteit. Voor het werkgeheugen is er 16 GB RAM aanwezig, wat van invloed is op de prestaties bij het gebruiken van meerdere programma's. De opslag bestaat uit een SSD met een capaciteit van 256 GB, waarop het besturingssysteem en je applicaties worden geïnstalleerd. Dit model is uitgerust met Dell ThinOS, een specifiek besturingssysteem dat is gericht op het werken met virtuele desktopomgevingen. Voor het aansluiten van je apparatuur beschikt de computer over diverse poorten. Je vindt er onder andere USB 3.2-poorten, een netwerkaansluiting en twee DisplayPort-uitgangen voor het koppelen van beeldschermen. De compacte behuizing maakt het mogelijk om het systeem op verschillende manieren te plaatsen

Specificaties

Formaat: 18,2 x 17,8 x 3,6 cm
Processor:
Intel Pentium Silver N6005
Werkgeheugen:
16 GB DDR4
Harde schijf:
256 GB SSD
Netwerk:
Gigabit LAN

Blackview MP100 Mini PC

Binnen de compacte behuizing van de Blackview MP100 vind je een AMD Ryzen 7 5825U processor, een chip met 8 kernen die de taken van het systeem verwerkt met een maximale turbofrequentie van 4.5 GHz. Voor het gelijktijdig gebruiken van verschillende programma's is het systeem, afhankelijk van de uitvoering, voorzien van 16 GB of 32 GB DDR4 werkgeheugen. Mocht je in de toekomst meer geheugen nodig hebben, dan is dit uit te breiden tot een maximum van 64 GB. De opslag van je bestanden en software wordt verzorgd door een M.2 SSD, met een capaciteit van 512 GB of 1 TB. Qua verbindingen heb je de beschikking over Wi-Fi 6 en Bluetooth 5.2 voor draadloze connectiviteit. Fysieke aansluitingen zijn er ook volop: het apparaat heeft onder andere USB 3.2-poorten, twee Type-C poorten, een HDMI-aansluiting en een DisplayPort. Hiermee kun je tot drie 4K-beeldschermen tegelijk aansturen. Het vooraf geïnstalleerde besturingssysteem op dit model is Windows 11 Pro.

Specificaties

Formaat: 12,8 x 12,8 x 5,2 cm
Processor: AMD Ryzen 7 5825U
Werkgeheugen:
16 GB of 32 GB DDR4
Harde schijf:
512 GB of 1 TB SSD
Netwerk:
Wifi 6, Bluetooth 5.2, Gigabit LAN