docs
Plan een demo

Beginnen

Aan de slag

Wat Kyosk is, wat je nodig hebt en hoe een eerste scherm online komt.

Kyosk laat digitale schermen draaien op een Raspberry Pi en houdt ze op afstand bij. Je beheert de inhoud, de updates en de status van alle schermen vanuit één plek. Deze pagina loopt in grote lijnen door hoe een eerste scherm online komt.

#Hoe het in elkaar zit

Elk scherm bestaat uit een Raspberry Pi met twee kleine programma's in Rust. Er draait geen browser en geen Node op de Pi.

  • De poller draait elke minuut. Hij haalt de instellingen en slides op, maakt afbeeldingen en QR-codes klaar, voert opdrachten uit en stuurt een levensteken terug.
  • De weergave tekent het beeld zelf, met of zonder grafische omgeving (X11 of DRM/KMS), en wisselt zacht tussen slides.

Het scherm praat met een API met een eigen token per scherm. Het panel is de plek waar jij klanten, schermen, slides en updates beheert. Het panel is niet publiek bereikbaar.

#Wat je nodig hebt

  • Een Raspberry Pi 3B+, 4 of 5, een SD-kaart en een scherm met HDMI.
  • Een internetverbinding op de locatie. Zonder verbinding speelt het scherm de laatst opgehaalde inhoud door.
  • Een klant en een scherm in het panel, en het configuratiebestand installer.env dat het panel voor dat scherm maakt.
  • Toegang tot de installatie-bestanden.

#Een scherm online brengen

  1. Maak in het panel de klant en het scherm aan, en download installer.env voor dat scherm. Het bestand bevat geheimen: nooit committen en nooit mailen.
  2. Flash de SD-kaart met Raspberry Pi Imager. Zet een hostnaam, een gebruiker en SSH aan.
  3. Kopieer installer.env en het installatiescript naar de Pi.
  4. Draai het installatiescript op de Pi.
  5. Controleer binnen enkele minuten of het scherm in het panel als online verschijnt.
  6. Verwijder installer.env van je laptop. De installer ruimt het bestand op de Pi zelf op.
Op je laptop en op de Pi
scp installer.env install-from-github.sh <gebruiker>@<pi>.local:/tmp/
ssh <gebruiker>@<pi>.local
cd /tmp && sudo bash install-from-github.sh

Verschijnt het scherm niet, ga dan naar Probleemoplossing.

#Hoe verder