ID.nl logo
Workshop IrfanView
© Reshift Digital
Huis

Workshop IrfanView

IrfanView is een bijzonder prettig programma voor hobbyfotografen om foto's te bekijken en eenvoudige bewerkingen uit te voeren. Nagenoeg alle afbeeldingsformaten worden ondersteund, zodat u ook exotische bestanden zonder problemen opent. Dankzij de gebruiksvriendelijke interface is er geen geavanceerde kennis van grafische software vereist. Met behulp van de stappen uit deze workshop kunt u direct aan de slag!

01. Installatie

Allereerst brengt u een bezoekje aan de website IrfanView om de software te downloaden. Onder het menuonderdeel Download hebt u de mogelijkheid om het installatiebestand van 1,32 MB vanaf meerdere bestandslocaties binnen te halen. Kies een locatie uit en doorloop de installatiewizard. U bepaalt onder andere of u een snelkoppeling op het bureaublad wilt plaatsen en of u bepaalde bestanden met IrfanView wilt associëren. Dat is handig wanneer u bepaalde afbeeldingsformaten automatisch met deze fotoviewer wilt openen, zodra u erop dubbelklikt.

©PXimport

02. Nederlands taalpakket

Bij het opstarten van IrfanView, zult u merken dat het programma Engelstalig is. Gelukkig is er een Nederlands taalpakket beschikbaar. Surf naar IrfanView en klik aan de linkerkant van de webpagina op IrfanView languages. Download de Installer-versie en start daarna het exe-bestand. Klik op Install om het Nederlandse taalpakket te installeren. Navigeer in het programma naar Options / Change language en selecteer NEDERLANDS.DLL. Bevestig met OK, alle menu's worden nu direct vertaald. Sommige onderdelen van de software blijven overigens nog wel Engelstalig.

©PXimport

03. Foto's bekijken

In het hoofdvenster van IrfanView bekijkt u gemakkelijk foto's of andere afbeeldingen. U sleept het bestand simpelweg naar het programma, en het wordt meteen weergegeven. Via de pijltjesknoppen zijn de overige foto's in de map bereikbaar. In- en uitzoomen gaat via de knoppen met het vergrootglas. Als u meerdere foto's tegelijk wilt bekijken, dan gaat u naar Start / Alle programma's / IrfanView / IrfanView - Thumbnails. Zoek met behulp van de mappenstructuur de juiste bestanden op in het hulpprogramma. Zodra u dubbelklikt op een afbeelding, opent de fotoviewer van IrfanView.

©PXimport

04. Diavoorstelling

Wilt u een complete map met foto's bekijken, dan klikt u in het hoofdprogramma van IrfanView op de knop Diavoorstelling. Er verschijnt een nieuw venster, waarin u de weergave bepaalt. Zoek aan de rechterkant alle foto's op die u wilt bekijken. Nuttig is dat u bestanden uit verschillende mappen kunt selecteren. Beslis hoeveel seconden er tussen de dia's moeten zitten. Het is leuk om een willekeurige volgorde te selecteren en een mp3-bestand als achtergrondmuziek af te spelen. Ook voegt u indien gewenst teksten toe. Klik op de knop Speel diavoorstelling om deze te starten.

©PXimport

05. Tekenpallet

Wanneer u een pijltje, penseelstreek, of een simpele vorm wilt toevoegen aan de afbeelding, dan regelt u dat met het Tekenpallet. U opent dit onderdeel via Bewerken / Tekenpallet tonen. Er verschijnt een verplaatsbaar dialoogvenster in beeld, waarmee u simpele elementen aan de foto toevoegt. De dikte van de lijnen selecteert u in het tekstveld onder Grootte. Verder hebt u de mogelijkheid om vlakken op te vullen, waarbij u uiteraard zelf de voor- en achtergrondkleur bepaalt. Tevens kunt u een gum gebruiken om een ongewenst gedeelte van de afbeelding weg te halen.

©PXimport

06. Weergaveopties

U beslist zelf op welke wijze u de afbeeldingen in IrfanView wilt weergeven. Ga in het menu naar Weergave / Weergave opties. Handig is de mogelijkheid om de foto's aan te passen aan de grootte van het venster. Op die manier hoeft u geen schuifknoppen te gebruiken om de foto in beeld te brengen. Verder kunt u er ook voor kiezen om de werkelijke grootte van de afbeelding te tonen. In het menuonderdeel Weergave beschikt u ook over opties om bepaalde werkbalken te verbergen of een volledig scherm te activeren.

©PXimport

Skins

Vindt u de standaardinterface van IrfanView er nogal oubollig uitzien? Geen probleem, want u vervangt moeiteloos de knoppenbalk. U gaat eerst naar IrfanView en klikt op Toolbar skins. Vervolgens maakt u een keuze door op een ontwerp te dubbelklikken, waarna u het zip-bestand uitpakt naar de map C:\Program Files\IrfanView\Toolbars. U activeert de nieuwe knoppenbalk door te navigeren naar Eigenschappen / Werkbalk. Ten slotte klikt u op de juiste naam en bevestigt u met OK

©PXimport

07. Uitsnede maken

Bij foto's waarop alleen het onderwerp belangrijk is, maakt u eenvoudig een uitsnede. Op die manier wordt u bijvoorbeeld niet afgeleid door een hinderlijke achtergrond en bovendien is het een efficiënte manier om een afbeelding kleiner te maken. Eerst maakt u met de cursor een selectie door een vierkant te plaatsen rond het betreffende onderwerp. Vervolgens gaat u naar Bewerken / Selectie uitsnijden. De foto wordt direct aangepast. Navigeer naar Bestand / Opslaan als om de bewerking te bewaren. Let op dat u hierbij de juiste locatie en een geschikt bestandsformaat kiest.

©PXimport

08. Panorama afbeelding

Bij het fotograferen vanaf een uitkijktoren is het onmogelijk om het volledige uitzicht op een foto vast te leggen. Gelukkig biedt IrfanView daarvoor een nuttige oplossing, u kunt afbeeldingen aan elkaar plakken. U opent het juiste menu via Afbeelding / Maak panorama afbeelding. Klik op Afbeeldingen toevoegen en zoek de bestanden op. Middels de knoppen Omhoog en Omlaag plaatst u ze in de goede volgorde. Klik op Maak panorama om het resultaat te bekijken en sla het eventueel op. Het is ook mogelijk om de afbeeldingen verticaal onder elkaar te plaatsen.

©PXimport

09. Grootte wijzigen

Het wijzigen van de grootte van een afbeelding kan nodig zijn wanneer het bestand aan bepaalde afmetingen moet voldoen voor een website of een fotoboek. Ga naar Afbeelding / Grootte wijzigen. Bij de optie Nieuwe grootte wijzigt u handmatig de afmetingen voor de breedte en hoogte. U gebruikt hierbij de eenheden pixels, centimeters of inches. Tevens kunt het percentage van de verhoudingen wijzigen. Verder ziet u aan de rechterkant enkele standaardafmetingen staan die u kunt kiezen. Sluit het dialoogvenster met OK en sla de bewerking op.

©PXimport

10. Rode ogen corrigeren

Als u weleens portretfoto's met flitslicht maakt, dan herkent u vast de rode ogen. Deze ontstaan doordat de pupillen niet snel genoeg reageren op het omgevingslicht, waardoor er rode bloedvaten van het netvlies te zien zijn. De meeste fotobewerkingsprogramma's hebben een functie om het op een realistische manier te corrigeren. Gebruik de zoom-knop met het vergrootglas om de ogen goed in beeld te brengen en maak een zorgvuldige selectie met de cursor. Navigeer in het menu daarna naar Afbeelding / Rode ogen reductie.

©PXimport

11. Horizon recht maken

De meeste mensen fotograferen een beetje schuin, omdat het lastig is om een camera zonder statief helemaal recht te houden. Foto's met een scheve horizonlijn zijn bepaald geen streling voor het oog. Gelukkig is het met IrfanView mogelijk om de afbeelding te draaien, waardoor u de horizon rechtmaakt. Open het Tekenpallet via Bewerken / Tekenpallet tonen en klik op het Rotatiegereedschap. Trek vervolgens een lijn met de cursor langs het gedeelte waarlangs de afbeelding zich horizontaal moet uitlijnen. Zodra u de muisknop loslaat, bekijkt u direct het resultaat.

©PXimport

12. Klonen

Het is vervelend als een vlekje of een ongewenst onderwerp de foto verpest. Wanneer het hinderlijke element zich op een neutrale achtergrond bevindt, poetst u het met behulp van de functie Klonen gemakkelijk weg door een identiek gedeelte van de foto te verplaatsen. Ga naar Bewerken / Tekenpallet tonen en selecteer het Kloongereedschap. Klik eerst met de rechtermuisknop op de plek waar de pixels vandaan moeten komen en klik vervolgens met de linkermuisknop op het hinderlijke gedeelte. De grootte van het kloongebied bepaalt u in het Tekenpallet.

©PXimport

13. Teksten toevoegen

Om iets te verduidelijken plaatst u gemakkelijk een tekst binnen een afbeelding. Maak met de cursor een selectie op de plek waar u een tekst wilt invoegen. Ga daarna naar Bewerken / Tekst toevoegen aan selectie. Typ de gewenste woorden en klik op de knop Kies Lettertype. Selecteer een mooi lettertype en pas de lettergrootte naar eigen inzicht aan. Ook kunt u een andere kleur selecteren en de tekst cursief, vet of onderstreept weergeven. Verder lijnt u de woorden links, rechts of in het midden uit. Bevestig met OK om de tekst definitief te plaatsen.

©PXimport

14. Randen

Voor een leuk effect voorziet u de kiekjes van een aantrekkelijke rand of lijst. Zoek een geschikte foto op en navigeer naar Afbeelding / Rand/Lijst toevoegen. De verschillende opties worden vervolgens in een lijstje weergegeven. Bij Frame colors selecteert u één of meerdere kleuren. U bepaalt de dikte door bij de optie Frame size de waarde voor het aantal pixels te wijzigen. In het Preview-venster ziet u direct wat voor effect de rand heeft. Bevestig met de knop OK om de rand aan de foto toe te voegen. Vergeet overigens het bestand niet op te slaan als u de bewerking wilt behouden.

©PXimport

15. Kleuren corrigeren

Bent u niet tevreden met de kleuren van uw foto? Gelukkig doet u daar eenvoudig iets aan! Open het juiste menu via Bewerken / Kleuren aanpassen. U ziet twee afbeeldingen naast elkaar, zodat u gemakkelijk de nieuwe en de oorspronkelijke foto met elkaar vergelijkt. Gebruik de schuifknoppen bij Contrast, Gamma correctie en Verzadiging om de weergave aan te passen. Verder stelt u naar eigen inzicht een andere kleurbalans in door te spelen met de waarden van de primaire kleuren rood, groen en blauw. Ten slotte hebt u ook de mogelijkheid om de Helderheid te wijzigen. Sluit het dialoogvenster met OK.

©PXimport

Transparantie

Helaas kan IrfanView niet omgaan met transparante afbeeldingen. Transparante vlakken worden in het programma namelijk zwart weergegeven en ook als u het bestand opslaat, blijft deze kleur onveranderd. Bij fotobewerkers die wel overweg kunnen met 'doorzichtige' plaatjes, ziet u in de meeste gevallen een witte kleur of blokjes. Als u dergelijke afbeeldingen wilt bewerken, kunt u daarom beter het gratis programma GIMP gebruiken.

©PXimport

Opslaan voor het web

Als u alle extensies voor IrfanView uit stap 21 hebt geïnstalleerd, dan slaat u afbeeldingen gemakkelijk aangepast op zodat ze geschikt zijn voor internet. Dat is nuttig indien u wilt dat afbeeldingen op uw website snel worden geladen. U opent het juiste onderdeel via Bestand / Opslaan voor het Web. Bij plaatjes met een hoge resolutie, geeft de software eerst de gelegenheid om de afmetingen te verkleinen. Vervolgens maakt u in een nieuw dialoogvenster de keuze tussen jpg, gif of png en stelt u de kwaliteit in. U ziet direct wat voor effect de wijzigingen hebben, waarbij u meteen controleert hoe groot het bestand wordt. U slaat met Save de bewerkte afbeelding op.

16. Effecten toepassen

Afbeeldingen kunt u een bijzonder effect geven, zoals regendruppels, olieverf of sepiakleur. Zoek een foto op en maak eventueel een selectie. Navigeer in het menu naar Afbeelding / Effecten / Effectenkiezer. U ziet de oorspronkelijke en de nieuwe foto staan. Aan de linkerkant bevindt zich een lijstje met alle effecten die u desgewenst toepast. Zo stelt u met de optie Blur 2 met behulp van schuifknoppen een vervaging in, om bijvoorbeeld een persoon onherkenbaar te maken. Ook Radial Blur en Zoom Blur kunt u hiervoor gebruiken. Maak een keuze en sluit af met OK.

©PXimport

17. Foto's converteren

U kunt IrfanView gebruiken om foto's om te zetten naar een ander bestandsformaat. Ga naar Bestand / Groepsconversie/Hernoemen, zoek de afbeeldingen op en sleep ze naar het onderste deelvenster. U kunt hiervoor ook de knoppen Toevoegen of Alles toevoegen gebruiken. Bepaal in het uitrolmenu bij Uitvoerformaat het juiste grafische formaat en selecteer onder Doelmap de gewenste locatie. U klikt vervolgens op Start, waarna het proces begint. Overigens gebruikt u het dialoogvenster Groepsconversie tevens om meerdere bestanden een andere naam te geven.

©PXimport

18. Tegelijk bewerken

Zodra u dezelfde bewerkingen op meerdere foto's tegelijk wilt toepassen, kunt u veel tijd besparen. Ga naar Bestand / Groepsconversie/Hernoemen. Voeg de foto's toe en plaats een vinkje voor Gebruik geavanceerde opties. Klik op de knop Geavanceerd, zodat er een nieuw scherm verschijnt met talloze functies. U hebt bijvoorbeeld de mogelijkheid om alle afbeeldingen tegelijk te verkleinen of uitsneden te maken. Daarnaast past u het contrast aan en verandert u de kleurbalans. Maak een keuze en klik op OK. Met Start begint het omzettingsproces.

©PXimport

19. Externe bewerkers

Mocht IrfanView een geavanceerde bewerking niet uit kunnen voeren, dan doet u vanuit het programma rechtstreeks een beroep op andere fotobewerkingssoftware. Klik in het menu op de knop Eigenschappen en ga naar de optie Overige. Kies onder Externe bewerkingsprogramma's instellen voor Bladeren en zoek het exe-bestand van de betreffende software op, bijvoorbeeld Photoshop Elements of GIMP 2. U voegt maximaal drie programma's toe. Sluit het menu met OK. Via Bestand / Open met bewerker start u de foto direct met het andere pakket op.

©PXimport

20. Bureauachtergrond

Hebt u een foto naar tevredenheid bewerkt, dan wilt u deze wellicht op uw bureaublad gebruiken. Ga naar Opties / Als bureaublad achtergrond instellen, waar u de keuze hebt uit vier opties. Gecentreerd weergeeft de foto in het midden, waardoor mogelijk een gedeelte buiten het beeldscherm valt. De optie Naast elkaar gebruikt u als er meerdere monitors op de computer zijn aangesloten. Met behulp van Spreiden past het formaat van de afbeelding zich aan aan de grootte van het beeldscherm. Als u niet wilt dat de weergave wordt uitgerekt, kiest u voor Spreiden (proportioneel).

©PXimport

21. Plugins

U voegt simpel extra functies toe door middel van uitbreidingen. Surf naar IrfanView en klik aan de linkerkant op PlugIns. U maakt het voor uzelf gemakkelijk door middels één exe-bestand alle beschikbare extensies te installeren. Klik op de link Software.com - download IrfanView plugins en vervolgens onderaan de webpagina op Download Irfanview Plugins Now. Zorg ervoor dat IrfanView is afgesloten, alvorens u de installatiewizard doorloopt. Na installatie beschikt u onder meer over mogelijkheden om foto's te e-mailen en video's te openen.

©PXimport

▼ Volgende artikel
Pushnotificaties vanaf je thuisserver: zo werkt ntfy
© ID.nl
Huis

Pushnotificaties vanaf je thuisserver: zo werkt ntfy

Als je services op je eigen thuisserver draait, wil je daar ook eenvoudig meldingen van kunnen ontvangen. Ntfy stelt je in staat om eenvoudig pushnotificaties naar je telefoon of computer te sturen. Bovendien kun je ntfy op je eigen thuisserver draaien, zodat je alles in eigen handen hebt. In dit artikel gaan we ermee aan de slag.

Dit gaan we doen

In dit artikel zetten we een ntfy-server op die je zelf beheert. We regelen eerst de randvoorwaarden: hoe je server van buitenaf bereikbaar wordt (bijvoorbeeld via vpn of portforwarding) en hoe je https netjes afhandelt met een reverse proxy en een certificaat van Let's Encrypt. Daarna bouwen we de basis: configuratiebestand, opslagmappen en een draaiende container met Docker.

Vervolgens maken we gebruikers en rechten aan, zodat niet iedereen zomaar kan publiceren of meelezen. Je test met de webinterface en met de mobiele app, zodat je zeker weet dat meldingen ook echt binnenkomen. Tot slot koppel je ntfy aan je eigen tools: eerst met een simpele curl-oproep vanuit een shellscript, daarna met extra's zoals titel, prioriteit en tags. Als je wilt, breid je dat uit naar meldingen met bijlagen, acties (doorklikken naar een url) en integratie vanuit Python. 

Lees ook: Je oude Windows-pc als thuisserver: zo zet je Jellyfin en Syncthing op

Netwerkmonitoringsoftware, een programma dat je Docker-containers bijwerkt, een smarthomecontroller, back-upsoftware, ze hebben allemaal één ding gemeen: ze moeten je meldingen kunnen sturen als er iets gebeurt. Dat kan op verschillende manieren: via e-mail, instant messaging of pushnotificaties naar je telefoon. Dat laatste verloopt doorgaans via een gecentraliseerde dienst zoals Firebase Cloud Messaging (voorheen Google Cloud Messaging) of Apple Push Notification service.

Pushnotificaties zijn handig omdat ze bijna onmiddellijk aankomen en omdat zowel Android als iOS toestaan om in te stellen hoe je ervan op de hoogte wordt gebracht. Wil je pushnotificaties kunnen ontvangen zonder een server onder controle van een partij zoals Google of Apple, dan moet je ook hiervoor je eigen service installeren. Een opensource-project dat dit implementeert, is ntfy.

Werking van ntfy

Je ntfy-server ontvangt meldingen van je programma's via http over een REST-API en zet deze om in pushnotificaties voor de bijbehorende Android- of iOS-app of voor een webpagina op je computer. De API is in de documentatie van het project beschreven, zodat je ook je eigen software met ntfy kunt laten praten. Het project heeft ook een command-line-interface, zodat je bijvoorbeeld shellscripts op je Linux-server eenvoudig pushnotificaties kunt laten verzenden.

Ntfy gebruikt het bekende publish/subscribe-patroon. Een zender publiceert notificaties op een specifiek onderwerp door data te sturen naar een url via een http POST- of PUT-aanvraag. Het onderwerp wordt gedefinieerd door een segment van de url dat volgt op de domeinnaam. Een ontvanger kan zich dan abonneren op dit onderwerp. Elke keer dat de zender daarna een notificatie op dit onderwerp publiceert, stuurt ntfy de data naar alle ontvangers die zich op dit onderwerp hebben geabonneerd. Door ntfy op je eigen server te installeren, heb je de volledige controle over deze notificaties.

Met ntfy kun je services pushnotificaties laten verzenden naar je telefoon of computer.

Serververeisten

De mobiele app van ntfy moet met je server kunnen communiceren om te vragen of er notificaties zijn. Als je ntfy op een server in je lokale netwerk installeert, moet die dus van buitenaf bereikbaar zijn. Dat kun je met portforwarding in je modem regelen of door je telefoon buitenshuis automatisch met een VPN-server op je lokale netwerk te laten verbinden. Heeft je internetaansluiting thuis geen vast ip-adres, dan moet je ook een DynDNS-updater te draaien.

Een andere optie is om ntfy op een VPS (Virtual Private Server) te installeren. Hierop draai je dan ook een reverse proxy voor https-toegang, die een TLS-certificaat van Let's Encrypt opvraagt. Je hebt dan een domein nodig, waarvoor je een DNS A-record naar het ip-adres van je server laat verwijzen. In de rest van dit artikel gaan we uit van een installatie van ntfy op een lokale server met Debian 13 ("trixie") met behulp van Docker Compose.

Basisconfiguratie

Creëer eerst enkele directory's voor ntfy:

$ mkdir -p containers/ntfy/{cache,etc,lib}

Creëer dan het bestand containers/ntfy/etc/server.yml met de volgende configuratie voor ntfy:

base-url: "https://ntfy.example.com"

cache-file: "/var/cache/ntfy/cache.db"

attachment-cache-dir: "/var/cache/ntfy/attachments"

auth-file: "/var/lib/ntfy/user.db"

auth-default-access: "deny-all"

Vervang het domein achter base-url door het domein waarop je ntfy-server draait. Als je gebruikmaakt van een reverse proxy, dan moet dit de url zijn die door de proxy naar ntfy wordt doorgestuurd. Bovendien moet je dan ook een regel behind-proxy: true toevoegen. In de documentatie van ntfy staan voorbeeldconfiguraties voor nginx, Apache2 en Caddy.

Met auth-default-access: "deny-all" tot slot heeft standaard niemand toegang tot onderwerpen. Elke toegang moet dus expliciet worden toegestaan.

Account bij ntfy.sh

De ontwikkelaar van ntfy draait een publiek beschikbare ntfy-server op ntfy.sh. De webinterface daarvan is bereikbaar op https://ntfy.sh/app. Die kun je gratis gebruiken, bijvoorbeeld om ntfy uit te proberen, maar dat komt met beperkingen. Zo kun je geen onderwerpen reserveren en is er een maximum van 250 notificaties per dag en 2 MB per bijlage. Verder is er geen enkele vorm van authenticatie. De enige manier van beveiliging ligt dus in het geheimhouden van je onderwerpen. Die beperkingen heb je niet als je ntfy zelf installeert. Maar als je liever niet zelf een installatie onderhoudt, kun je een betaald plan nemen. Daarmee ondersteun je ook de ontwikkeling van het opensource-project. Dat begint met een Supporter-plan van 5 dollar per maand (circa 5 euro), waarmee je drie onderwerpen kunt reserveren en 2.500 notificaties mag sturen met maximum 25 MB per bijlage.

Betaal voor gebruik van de publieke ntfy-server en ondersteuning van het opensource-project.

Docker Compose

Definieer nu de container in het bestand docker-compose.yaml:

services:

  ntfy:

    image: binwiederhier/ntfy

    container_name: ntfy

    command: serve

    restart: always

    environment:

      - TZ=Europe/Amsterdam

    volumes:

      - ./containers/ntfy/cache:/var/cache/ntfy

      - ./containers/ntfy/etc:/etc/ntfy

      - ./containers/ntfy/lib:/var/lib/ntfy

    ports:

      - 80:80

Ga je voor de aanpak met een reverse proxy, dan definieer je in ditzelfde bestand ook een container voor die reverse proxy.

Start daarna de container met:

$ docker-compose up -d

Als alles goed gaat, is de webinterface van ntfy daarna bereikbaar op het ingestelde domein of ip-adres. Bovenaan links zie je een melding Notifications are disabled. Klik op Grant now om notificaties in je webbrowser toe te staan, en bevestig dit daarna in het dialoogvenster dat je webbrowser toont.

Sta notificaties in je webbrowser toe.

Lees ook: Docker op je NAS: zo draai je Plex, Home Assistant en meer

Notificaties testen

Omdat je ntfy zo geconfigureerd hebt dat alle toegang standaard wordt geblokkeerd, kun je nog niets doen in de webinterface. Je dient dus eerst gebruikers aan te maken en die de toelating te geven om op specifieke onderwerpen te publiceren of zich te abonneren. Open daarvoor een shell in de container van ntfy met de opdracht docker exec -ti ntfy /bin/sh. Als je daarna ntfy user list intypt, krijg je te zien dat anonieme, niet geauthenticeerde gebruikers geen enkele permissies hebben. Met de opdracht ntfy user add --role=admin admin voeg je dan een admin-gebruiker met de naam admin toe. Gebruikers met de rol admin kunnen op alle onderwerpen publiceren en zich erop abonneren. Geef de gebruiker een wachtwoord en bevestig.

Klik nu in de webinterface van ntfy links op Settings en dan onder Manage users op Add user. Vul de url van je ntfy-server in, de gebruikersnaam admin en het wachtwoord dat je zojuist hebt ingesteld. Klik dan links op Subscribe to topic. Kies een naam of klik op Generate name om ntfy een willekeurige naam te laten kiezen en abonneer je dan op het onderwerp met Subscribe. Klik dan op Publish notification en vul hetzelfde onderwerp in. Voer ook een titel en een bericht voor je notificatie in en klik op Send. Als alles goed gaat, verschijnt je testbericht nu in een 'conversatie' met de naam van het onderwerp, en wijst je webbrowser je op een notificatie.

Publiceer notificaties in je webbrowser.

Gebruikersrechten

De webapplicatie is leuk voor een test, maar een mobiele app is vaak handiger. De app van Ntfy voor Android en iOS stelt je in staat om op je telefoon je te abonneren op onderwerpen (publiceren is niet mogelijk) en daarvoor notificaties te ontvangen. Als je de Android-app via F-Droid installeert, is dat zonder ondersteuning voor Firebase; de versie op Google Play gebruikt wél de servers van Google. Je maakt voor je app bij voorkeur een gebruiker aan die alle onderwerpen alleen kan lezen. Dat doe je weer in de shell van de container van ntfy met ntfy user add android om de gebruiker android aan te maken (voer een wachtwoord in) en dan ntfy access android "*" read-only voor de leesrechten.

Open daarna de Android-app en tik op de drie stippen rechtsboven. Kies Settings en stel dan Default server in op het domein van je ntfy-server. Tik daarna op Manage users en Add new user en vul de url van je ntfy-server in, de gebruikersnaam android en het bijbehorende wachtwoord. Tik dan op Add user. Keer dan terug naar het hoofdscherm van de app en klik op het plusicoontje rechtsonder. Voer het onderwerp in dat je tijdens de test in stap 5 hebt gebruikt en tik op Subscribe om je erop te abonneren. Vanaf nu zal de app voor elk ontvangen bericht op dit onderwerp een notificatie tonen. Je krijgt zelfs de al verzonden berichten te zien. Overigens toont de app twee waarschuwingen. Voor betrouwbare notificaties volg je de suggesties om batterijoptimalisaties uit te schakelen en naar WebSockets over te schakelen in plaats van een http-stream.

De Android-app ontvangt een notificatie voor elk bericht dat op een geabonneerd onderwerp wordt verstuurd.

Shellscripts

Nu je hebt getest dat je ntfy-server werkt, is het tijd om je eigen services notificaties te laten uitsturen. Hoe je dat precies configureert, hangt van de service af. Maar je zult altijd eerst een gebruiker met schrijfpermissies voor een specifiek onderwerp moeten aanmaken. Voor een back-upproces dat je op de hoogte moet houden van de status van je back-ups, maak je bijvoorbeeld een gebruiker aan met de opdracht ntfy user add backup in de container van ntfy. Geef die dan schrijfrechten op het onderwerp backup met ntfy access backup backup write-only.

Het publiceren van een bericht op een specifiek onderwerp behelst niet meer dan het sturen van een http POST-aanvraag naar de webserver. Dat kan bijvoorbeeld in een shellscript op je Linux-server met de opdracht curl:

curl -u backup:password -d "Backup successful" ntfy.example.com/backup

Als je in de ntfy-app op je telefoon je op dit onderwerp abonneert, ontvang je deze notificatie nadat het back-upscript is uitgevoerd. Op deze manier is het heel eenvoudig om je eigen shellscripts notificaties te laten verzenden.

Berichten met extra's

Ntfy ondersteunt talloze extra functies om je berichten te laten opvallen of om hun gedrag aan te passen. Je gebruikt deze allemaal door een http-header aan je aanvraag toe te voegen. Zo kun je aan de notificaties van je back-upscript een titel, prioriteit en tags toevoegen. De tags worden als pictogrammen getoond door de mobiele app. Een voorbeeld:

curl -u backup:password -H "Title: Backup failure" -H "Priority: urgent" -H "Tags: warning,skull" -d "Backup unsuccessful" ntfy.example.com/backup

Als de Android-app een bericht met standaardprioriteit ontvangt, doet ze je telefoon kort vibreren en speelt ze een kort geluidje af. Door de prioriteit op urgent te zetten, wordt het standaardnotificatiegeluidje vergezeld van een langer getril van je telefoon, waardoor je onmiddellijk merkt dat dit dringend je aandacht vereist.

Een ntfy-bericht met een titel, prioriteit en pictogrammen.

Plaatjes en lay-out

Ntfy kan ook plaatjes sturen, bijvoorbeeld een foto van een ip-camera die beweging detecteert, maar niet in combinatie met een tekstbericht. Om een bestand naar ntfy te uploaden met curl in een http PUT-aanvraag gebruik je de optie -T en de bestandsnaam. Met de header Filename voeg je de bestandsnaam toe die de ntfy-app je moet tonen. Dat ziet er dan als volgt uit:

curl -u admin:password -T foto.jpg -H "Filename: beweging.jpg" -H "Title: Beweging voordeur" -H "Tags: boom" ntfy.example.com/beweging

Als je een tekstbericht als Markdown opmaakt, kun je wel plaatjes in een tekst opnemen, maar dan moet je naar het bestand linken. Alleen ntfy's webinterface ondersteunt dit; de mobiele app toont gewoon de Markdown-brontekst. Een Markdown-bericht stuur je door de header Markdown: yes of Content-Type: text/markdown aan je http POST-aanvraag toe te voegen. Ntfy ondersteunt overigens alleen beperkte Markdown-functies, zoals vette en schuine tekst, lijsten, links en afbeeldingen.

Je services kunnen ook plaatjes naar ntfy sturen.

Acties

Je ontvangt de notificaties van ntfy in de app in een 'conversatie' per onderwerp. Wanneer je op een notificatie tikt, kopieert dit standaard gewoon de tekst van het bericht naar het klembord. Als je de header Click: URL toevoegt, opent de app die url wanneer je op de notificatie tikt. Zo kun je in een notificatie van je back-upscript bijvoorbeeld een link naar de webinterface van je back-upserver opnemen om het gemelde probleem snel te onderzoeken.

Je kunt ook tot drie 'actieknoppen' definiëren, die dan onderaan een notificatie verschijnen. Door op een van die knoppen te tikken, open je een website of app, activeer je een Android broadcast intent waarop andere apps dan weer kunnen reageren, of zend je een http POST-, PUT- of GET-aanvraag. De manier om dit alles te definiëren is wat omslachtig, maar wordt volledig in de documentatie van ntfy uitgelegd.

Klik op een van de knoppen van het bericht in ntfy om een actie uit te voeren.

Python-code

Curl is natuurlijk niet de enige tool waarmee je notificaties naar je ntfy-server kunt sturen. Sommige tools bieden rechtstreeks ondersteuning voor notificaties via ntfy. Dan hoef je alleen maar het domein van je server, het onderwerp, de gebruikersnaam en het bijbehorende wachtwoord in te vullen. Maar ook in je eigen Python-scripts kun je eenvoudig ondersteuning voor ntfy inbouwen. Dat gaat via het pakket Requests, waarmee je http POST-aanvragen naar de server stuurt. Een eenvoudig voorbeeld ziet er als volgt uit:

import requests

requests.post("http://ntfy.example.com/backup",

    data="Backup unsuccessful",

    headers={

        "Authorization": "Basic Z2VicnVpa2Vyc25hYW06d2FjaHR3b29yZA==",

        "Title": "Backup failure",

        "Priority": "urgent",

        "Tags": "warning,skull"

    })

Met de header Authorization stel je http Basic-authenticatie in. De tekenreeks die na Basic komt, is een Base64-codering van de gebruikersnaam en het wachtwoord met een dubbele punt ertussen. Je creëert die codering op je Linux-systeem met de opdracht echo "Basic $(echo -n 'gebruikersnaam:wachtwoord' | base64)".

Sssssssssschattig

Speciaal voor de kleinste Python-fans

En verder

Ntfy biedt een betrouwbare manier om notificaties van allerlei services te centraliseren, terwijl je zelf de volledige controle behoudt. Het programma blinkt uit in flexibiliteit om het overal in te integreren. Als een service bijvoorbeeld geen http POST-aanvragen ondersteunt, kun je ook http GET-aanvragen doen. En als een service je niet de mogelijkheid geeft om de headers aan te passen, laat ntfy je toe om de berichten inclusief headers in JSON-formaat door te sturen. En als een service webhooks ondersteunt maar daarvoor zijn eigen JSON-formaat gebruikt, kan ntfy die met berichtsjablonen omzetten naar leesbare berichten.

Ook via e-mail is ntfy te integreren. Je kunt bijvoorbeeld berichten die op je ntfy-server aankomen automatisch laten doorsturen naar een SMTP-server om ze ook als e-mail te ontvangen. Maar ook de andere richting is voorzien: ntfy kan dan zelf een ingebouwde SMTP-server draaien, handig voor services die alleen maar notificaties via e-mail ondersteunen. Elk onderwerp op de ntfy-server heeft dan een bijbehorend e-mailadres op je domein. De service hoeft dan alleen maar een e-mail naar dat adres te sturen om berichten op dat onderwerp te publiceren op je ntfy-server. Deze en andere geavanceerde functies zijn uitgebreid gedocumenteerd op de website van ntfy.

De documentatie van ntfy is uitgebreid en praktisch. 

▼ Volgende artikel
Nieuwe FromSoftware-game The Duskbloods komt echt alleen naar Switch 2
Huis

Nieuwe FromSoftware-game The Duskbloods komt echt alleen naar Switch 2

The Duskbloods, de nieuwe game van Elden Ring- en Dark Souls-ontwikkelaar FromSoftware, zal echt alleen op Nintendo Switch 2 uitkomen.

Dat heeft de ontwikkelaar benadrukt bij het bekendmaken van zijn kwartaalcijfers (via VGC). Daarbij werd ook nog eens benadrukt dat The Duskbloods nog altijd gepland staat om ergens dit jaar uit te komen, net zoals de Switch 2-versie van Elden Ring.

Over de exclusieve Switch 2-release van The Duskbloods: "Het wordt verkocht via een samenwerking met Nintendo, met verkoopverantwoordelijkheden verdeeld per regio. De game komt alleen voor Nintendo Switch 2 beschikbaar." Daarmee is dus duidelijk gemaakt dat Nintendo een nauwe samenwerking met FromSoftware is aangegaan voor de game en dat het spel niet zomaar op andere platforms uit zal komen.

Over The Duskbloods

The Duskbloods werd begin vorig jaar aangekondigd in een speciale Nintendo Direct waarin de eerste Switch 2-games werden getoond, maar sindsdien zijn er geen nieuwe beelden van het spel uitgebracht. Zoals gezegd is de game ontwikkeld door FromSoftware, het Japanse bedrijf dat naam voor zichzelf heeft gemaakt met enorm uitdagende spellen, waaronder de Dark Souls-serie en Bloodborne. Met de openwereldgame Elden Ring scoorde de ontwikkelaar enkele jaren geleden nog een megahit.

Watch on YouTube

The Duskbloods wordt een PvPvE-game, waarbij spelers het dus tegen elkaar en tegen computergestuurde vijanden opnemen. Maximaal acht spelers doen aan potjes mee. Na het kiezen van een personage in een hub-gebied wordt men naar een gebied getransporteerd waar er met andere spelers en vijanden gevochten wordt, al kan men soms ook samenwerken om vijanden te verslaan.

Spelers besturen een 'Bloodsworn', wezens die dankzij een speciaal bloed dat in hun lichaam zit meer krachten tot hun beschikking hebben dan reguliere mensen. Ondertussen is het einde van de mensheid nabij, en bestaat de wereld uit verschillende tijdperken, wat voor een mengelmoes van stijlen zorgt.