# gibeon.io, volledige documentatie
> Alle NL-helpcenterdocumenten van het gibeon.io digital signage platform, gegenereerd op build-time.
> Paginaversies van elke doc: https://www.gibeon.io/docs/
# Aan de slag
Leer de basis van gibeon.io en breng je eerste scherm tot leven.
## In deze sectie
- [Je eerste scherm activeren](./eerste-scherm-activeren)
- [Account aanmaken en team uitnodigen](./account-team)
---
# Account aanmaken en team uitnodigen
Een gibeon.io-account hangt altijd onder een organisatie. Bij registratie maak je je eigen organisatie aan, daarna kun je collega's uitnodigen en rollen toewijzen.
## Een account aanmaken
1. Ga naar [gibeon.io](https://gibeon.io) en klik op **Aanmelden**.
2. Kies hoe je wilt registreren:
- **Google** of **Microsoft**: één klik via OAuth, geen wachtwoord nodig
- **E-mailadres + wachtwoord**
- **Magic link**: je ontvangt een eenmalige link in je inbox
3. Voltooi de beveiligingscontrole.
4. Geef je nieuwe organisatie een naam. Dit is meestal je bedrijfsnaam. Je past hem later aan via **Instellingen → Bedrijf**.
Na bevestiging land je rechtstreeks in het dashboard van je nieuwe tenant.
## Teamleden uitnodigen
1. Ga naar **Instellingen → Team**.
2. Klik op **Gebruiker uitnodigen**.
3. Vul het e-mailadres in en kies een rol.
4. Klik op **Uitnodiging versturen**. De ontvanger krijgt een e-mail met een acceptatielink.
## Rollen
| Rol | Wat kan deze rol |
|-----|------------------|
| **Eigenaar** | Alles, plus de organisatie verwijderen en facturatie beheren |
| **Beheerder** | Alle content + schermen + integraties + team |
| **Lid** | Content en schermen beheren, geen facturatie of teamleden |
Een organisatie heeft altijd minstens één eigenaar. Je kunt de eigenaar wijzigen door eerst een tweede eigenaar toe te voegen.
## Wat als het niet werkt
Vraag de ontvanger om de spam-folder te checken. Komt hij daar ook niet binnen, annuleer de pending invitation in **Instellingen → Team** en stuur een nieuwe.
Als iemand zich registreerde met een ander e-mailadres dan het uitgenodigde, krijg je twee accounts. Verwijder het overbodige account via **Instellingen → Team → ⋯ → Verwijderen**.
Klik in **Instellingen → Team** op de rol naast een gebruiker en kies een nieuwe. Wijzigingen zijn meteen actief.
Je eerste scherm activeren
---
# Je eerste scherm activeren
Een scherm wordt actief zodra je het via een activatiecode aan je tenant koppelt. Je speler toont de code, jij voert hem in op [app.gibeon.io](https://app.gibeon.io) en kiest welke content moet draaien.
## Wat heb je nodig
- Een speler aangesloten op het scherm (gibeon.io Speler, Android-toestel of een browser)
- Internetverbinding op de speler
- Toegang tot de gibeon.io CMS met de rol **lid** of hoger
## Stappen
1. **Sluit de speler aan** op het scherm via HDMI en zet hem aan. Bij eerste boot doorloopt hij de wifi-setup.
2. **Wacht tot de activatiecode verschijnt**. De speler toont een code van vier tekens (letters en cijfers). Voorbeeld: `K7P2`.
3. **Open de CMS** op [app.gibeon.io](https://app.gibeon.io) en ga naar **Schermen → Scherm activeren**.
4. **Vul de code in** en geef het scherm een herkenbare naam, bijvoorbeeld `Etalage Hoofdstraat` of `Inkomhal kantoor`.
5. **Kies content** (optioneel). Selecteer een bestaande playlist, sequentie of schema. Heb je nog niets klaarstaan? Sla deze stap over en koppel later.
6. **Klik op Verbinden**. De gekozen content wordt automatisch gepubliceerd en het scherm springt binnen enkele seconden over op die content. Heb je geen content gekoppeld, dan toont de speler een wachtbeeld.
## Wat als het niet werkt
Codes verlopen na enkele minuten. Herlaad de speler (boot opnieuw of trek de stekker er even uit). Er verschijnt dan automatisch een nieuwe code. Probeer die opnieuw in de CMS.
Elke speler genereert zijn eigen code. Zie je op twee schermen dezelfde code, dan tonen ze allebei nog het wachtscherm met een gecachte code. Reboot één van de twee.
Het scherm is geactiveerd maar er is nog geen content gekoppeld. Ga in de CMS naar het scherm en klik **Content kiezen**, of bekijk het artikel over playlists hieronder.
De speler heeft geen internetverbinding. Controleer wifi of bekabeling op het toestel. Bij een Smart TV met Google TV kan het ook zijn dat de gibeon.io-app nog niet vanuit de [Play Store](https://play.google.com/store/apps/details?id=io.gibeon.player) geïnstalleerd is.
Een eerste playlist maken
---
# API en MCP
gibeon.io is volledig vanuit code aanstuurbaar zodra je een access token hebt. De REST API zit op `www.gibeon.io/v1`. Voor AI-tools die MCP spreken (Claude Desktop, Claude Code, Cursor) staat dezelfde set acties klaar op `www.gibeon.io/mcp`. Geen lokale install nodig.
## Wat kan je ermee
Met één access token werk je rechtstreeks op je tenant:
- Schermen oplijsten, hernoemen, andere content toewijzen, een publish triggeren
- Playlists aanmaken, items toevoegen of verwijderen, volgorde wijzigen
- Sequenties en planningen beheren
- Assets uploaden en opvragen
De volledige interactieve reference staat op [www.gibeon.io/dev/reference](https://www.gibeon.io/dev/reference). De raw OpenAPI 3.1-spec is bereikbaar op [`www.gibeon.io/v1/openapi.yaml`](https://www.gibeon.io/v1/openapi.yaml). Geschikt voor code-generatie of import in Postman, Bruno, Insomnia.
## Een access token ophalen
Auth verloopt via OAuth 2.1, Authorization Code + PKCE, uitgegeven door Supabase. Er zijn geen statische sleutels meer om te kopiëren.
1. Je client registreert zich via Dynamic Client Registration (RFC 7591) bij de authorization server
2. De client doorloopt de Authorization Code + PKCE-flow
3. Je keurt de toegang goed op het gibeon.io consent-scherm en kiest de tenant waarop de agent mag werken (scope `gibeon:api`)
4. Je client krijgt een kortlevend access token plus een refresh token
De volledige flow met elk endpoint staat op [www.gibeon.io/auth.md](https://www.gibeon.io/auth.md). Bewaar voor headless of cron-gebruik het refresh token en wissel het in voor nieuwe access tokens zonder opnieuw te moeten goedkeuren (één keer ingesteld door een mens).
Toegang trek je in vanuit de CMS onder **Instellingen → Verbonden apps**, of via het revocation-endpoint van de authorization server. Intrekken werkt onmiddellijk.
## REST gebruiken
Stuur het access token mee in de `Authorization` header als Bearer token.
```bash
# Lijst van je schermen
curl https://www.gibeon.io/v1/players \
-H "Authorization: Bearer "
# Een scherm op een andere playlist zetten en publishen
curl -X PATCH https://www.gibeon.io/v1/players/ \
-H "Authorization: Bearer " \
-H "Content-Type: application/json" \
-d '{ "playlist_id": "" }'
curl -X POST https://www.gibeon.io/v1/players//publish \
-H "Authorization: Bearer "
```
Werkt vanuit elke taal die HTTPS spreekt: bash, Node, Python, Go, n8n, Zapier, Make.
## MCP gebruiken: hosted (aanbevolen)
Plak deze config in de MCP-instellingen van je AI-tool. De client autoriseert zichzelf via OAuth bij de eerste verbinding: hij krijgt een 401 met een `WWW-Authenticate`-pointer, haalt de protected-resource-metadata op, registreert zichzelf (DCR) en doorloopt de OAuth-flow. Jij keurt het consent-scherm één keer goed. Er staat dus geen token in de config.
```json
{
"mcpServers": {
"gibeon": {
"url": "https://www.gibeon.io/mcp"
}
}
}
```
Configuratie-locatie per tool:
- **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) of de equivalent op Windows/Linux
- **Claude Code**: `.mcp.json` in je project, of de globale config via `claude mcp`
- **Cursor**: `~/.cursor/mcp.json`
Na een herstart van de tool verschijnen er 13 gibeon.io-tools (list_players, update_player, publish_players, create_playlist, add_playlist_item, reorder_playlist_items, ...). De AI kan ze rechtstreeks aanroepen.
## MCP gebruiken: npm-pakket (deprecated)
Er bestond een self-hosted stdio-variant ([`@gibeon/mcp-server`](https://www.npmjs.com/package/@gibeon/mcp-server)), maar die is afgebouwd (deprecated): ze gebruikte de verwijderde `gib_live_`-sleutels. Gebruik de hosted MCP hierboven, die de autorisatie zelf afhandelt bij de eerste verbinding.
## Limieten en goed gedrag
- **60 requests per minuut per token.** Boven de limiet retourneert de API 429 met een `Retry-After` header in seconden.
- **Tokens zijn tenant-scoped.** Een token kan nooit buiten de goedgekeurde tenant kijken, ook niet als superadmin-account.
- **Publishes zijn gratis** in termen van rate-limit en kosten. Je mag na elke wijziging een publish triggeren. Players halen het pas binnen op hun volgende heartbeat, dat is altijd binnen 10 seconden.
- **Assets uploaden gaat in twee stappen**: eerst `POST /v1/assets` met metadata (krijg een upload-URL terug), dan `PUT` de bytes naar die URL. Max 100 MB per upload.
## Veelvoorkomende fouten
Controleer dat de header `Authorization: Bearer ` is. Geen `Bearer:` met een dubbele punt, geen quotes rond het token. Een verlopen token geeft dezelfde 401: wissel je refresh token in voor een nieuw access token. Ingetrokken toegang geeft ook 401.
Herstart de MCP-host volledig (niet alleen het venster maar het hele proces). Bij de eerste verbinding opent de client het consent-scherm: keur de toegang goed en kies je tenant. Bij Claude Desktop staat een log in `~/Library/Logs/Claude/` waar je connection-errors ziet.
Roep `POST /v1/players//publish` aan (of het MCP-tool `publish_players`). Zonder publish blijft het scherm op de vorige content draaien. Dat is bewust, om half-doorgevoerde aanpassingen te vermijden.
Stop een delay tussen je calls of spreid het werk over meer tijd. De 60/min telt per token, niet per tenant.
---
# Concepten
Korte ankerpagina's per begrip. Vanuit hier door naar de hands-on instructies onder **Inhoud beheren** of **Schermen en spelers**.
---
# Playlists vs schema's vs sequenties
Drie concepten doen schijnbaar hetzelfde (content op een scherm zetten), maar elk met een eigen taak. Hier de snelle vergelijking.
## In één tabel
| Wat je wil | Gebruik |
|-----------|---------|
| Eén lijst content die loopt | **Playlist** |
| Verschillende content op verschillende tijden of dagen | **Schema** |
| Lange rotatie van meerdere playlists, geen tijdslot | **Sequentie** |
## In één zin per concept
- Een **playlist** is een rij content-items die afspeelt en herstart.
- Een **schema** bepaalt welke playlist op welk tijdvak speelt.
- Een **sequentie** speelt meerdere playlists na elkaar af, oneindig.
## Wanneer combineer je ze
Vaak. Een typische signage-setup:
1. Je maakt **playlists** voor elk thema (`Lunch`, `Avond`, `Kerstpromo`).
2. Je voegt die playlists toe aan een **sequentie** voor lange rotaties zonder tijdslot.
3. Voor specifieke dagdelen of dagen gebruik je een **schema** dat een specifieke playlist of sequentie boven het normale schema laat draaien.
## Prioriteit bij overlappingen
Een schema heeft voorrang op een sequentie of een losse playlist die direct aan het scherm is gekoppeld. Plant het schema niets voor het huidige tijdvak, dan valt de speler terug op de fallback (vaak: de gekoppelde playlist of sequentie).
Hoe je schema's en sequenties opzet
---
# Wat is een playlist
Een playlist is een geordende lijst van content-items die op een scherm na elkaar afspelen en daarna opnieuw beginnen. Het is de meest gebruikte bouwsteen om content op een scherm te krijgen.
## Wat hoort in een playlist
- **Templates** met data uit een integratie (bijvoorbeeld een pand uit Whise)
- **Afbeeldingen**, **video's** of **image-slideshows** uit de mediabibliotheek
- **Webpagina's** die ingebed worden via URL
Per item stel je een **duur in seconden** in. Bij videos volgt gibeon.io standaard de werkelijke videolengte.
## Voorbeeld
Een receptie-playlist:
1. Welkomstboodschap (10 sec)
2. Promo van de week (15 sec)
3. Instagram-feed (20 sec)
4. Openingsuren (10 sec)
Totaal 55 seconden, daarna opnieuw vanaf item 1.
## Eén playlist, meerdere schermen
Een playlist hoeft niet aan één scherm te kleven. Eén playlist kan op tien schermen tegelijk draaien. Wijzig je iets in de playlist, dan krijgen alle gekoppelde schermen die wijziging automatisch.
Een playlist maken
---
# Wat is een schema
Een schema bepaalt **wanneer** welke playlist op je scherm verschijnt. Op een tijdlijn schik je blokken. Elk blok wijst een tijdvak aan een specifieke playlist toe.
## Wanneer gebruik je een schema
Een schema is de juiste keuze wanneer je content per tijdslot wilt verschillen:
- Een ontbijtmenu 's ochtends, een lunchmenu 's middags
- Promo's tijdens de openingsuren, sluitingsboodschap nadien
- Speciale kerst-content vanaf 1 december
- Nieuwe panden in de etalage 's avonds, klassieke selectie overdag
## Wat als er niets gepland is
Buiten geplande tijdvakken volgt de speler je **fallback-instelling**. Vaak is dat "speel de gekoppelde playlist": een vangnet voor ongeplande momenten zodat je scherm nooit zwart blijft.
## Verschil met een sequentie
Een schema werkt met de klok. Een sequentie werkt met volgorde: meerdere playlists na elkaar zonder tijdslot. Wil je een lange rotatie zonder tijdgevoeligheid, kies een sequentie.
Een schema maken
---
# Wat is een scherm
Een scherm in gibeon.io is één geactiveerde fysieke display (een TV, monitor of tablet) gekoppeld aan een speler die content toont.
## Hoe gibeon.io je schermen ziet
Elk geactiveerd scherm heeft een eigen naam, een uniek ID en een status. De speler stuurt om de 30 seconden een korte heartbeat naar gibeon.io. Op basis van die heartbeat zie je in **Schermen** of een toestel online of offline staat.
## Wat hoort bij een scherm
- Een **naam** die jij kiest, bijvoorbeeld `Etalage Antwerpen` of `Inkomhal kantoor`
- Een **gekoppelde content-bron** (een playlist, schema of sequentie)
- Een **oriëntatie** (landscape of portrait)
- Een **device-type** dat de speler aangeeft (Android, browser, …)
- Een **fallback-instelling** voor wanneer er geen geplande content is
## Eén speler, één scherm
Elke speler kan op slechts één gibeon.io-scherm tegelijk werken. Wil je twee schermen ergens neerzetten, dan heb je twee spelers nodig, elk met zijn eigen activatiecode.
Een scherm activeren
---
# Wat is een sequentie
Een sequentie is een **geordende rij playlists** die na elkaar afspelen. De eerste playlist draait helemaal af, dan de tweede, enzovoort, en aan het einde van de laatste playlist begint de sequentie opnieuw.
## Wanneer gebruik je een sequentie
Wanneer je content wil opdelen in thema's zonder dat een specifiek thema op een specifiek moment moet draaien.
**Voorbeeld**, een vastgoedmakelaar:
1. Playlist `Nieuwe panden deze week`
2. Playlist `Topselectie`
3. Playlist `Diensten en team`
Elke playlist heeft eigen content en eigen visuele stijl. De speler doorloopt ze één na één en laat de sequentie continu lopen.
## Verschil met een playlist
Een playlist is een rij content-items. Een sequentie is een rij playlists. Sequenties bestaan om je content gestructureerd te houden in plaats van alles in één gigantische playlist te proppen.
## Verschil met een schema
Een schema bindt content aan een tijdvak. Een sequentie kent geen tijd. Ze draait gewoon door, in volgorde, oneindig. Wil je dezelfde structuur maar dan tijdgebonden, dan kun je in een schema verschillende sequenties op verschillende blokken zetten.
Een sequentie maken
---
# Wat is een speler
Een speler is het toestel dat de content op een scherm zet. Het is de schakel tussen de gibeon.io CMS in de cloud en het glas dat je klant ziet.
## Hardware-keuzes
gibeon.io werkt op vijf paden:
- **gibeon.io Speler**: onze eigen kant-en-klare box, pre-paired
- **Smart TV met Google TV**: recent Sony, TCL, Hisense
- **Google TV Streamer**: voor TV's zonder Smart-OS
- **Eigen Android-tablet of TV-box** (Android 11+)
- **Browser**: TV-browser, computer of iPad op `p.gibeon.io`
## Wat doet een speler
Eens geactiveerd doorloopt elke speler hetzelfde patroon:
1. Haalt zijn content-toewijzing op uit de CMS
2. Downloadt de bestanden lokaal voor offline-werking
3. Speelt content af volgens de actieve playlist, sequentie of schema
4. Stuurt elke 30 seconden een heartbeat met zijn status
5. Reageert op afstandscommando's (herstart, content wisselen)
## Wanneer is een speler geen gibeon.io-scherm
Pas zodra je een speler met een activatiecode aan jouw tenant koppelt, telt hij als één van je schermen. Een onbekoppelde speler toont enkel het wachtbeeld met een code.
Welk pad past bij jou
---
# Wat is een template
Een template is een herbruikbaar ontwerp waar gibeon.io data van een integratie automatisch invoegt. Het is wat ons onderscheidt van klassieke signage-software: je hoeft geen poster te ontwerpen per pand of per actie. Je ontwerpt één template en de data vult de rest in.
## Hoe het werkt
Een template definieert:
- Een **lay-out** (waar staat het beeld, waar de tekst, waar de prijs)
- **Velden die uit data komen** (bijvoorbeeld `{{title}}`, `{{price}}`, `{{images[0]}}`)
- **Visuele stijl**: typografie, kleuren, animatie, hoek-overlays
Wanneer je een template aan een data-item koppelt (bijvoorbeeld een Whise-pand) vult gibeon.io de velden automatisch in. Verandert de prijs in Whise, dan past de template zich aan zonder dat jij iets moet veranderen.
## Waarom dit een groot verschil maakt
Een traditionele signage-tool vereist dat jij elke poster manueel maakt. Voor een vastgoedmakelaar met 50 panden is dat 50 posters die je actueel moet houden. Met templates zet je één goed-werkende template op, en alle 50 panden zien er meteen consistent uit. Een nieuw pand toevoegen in Whise = automatisch op het scherm.
## Template-bibliotheek
gibeon.io levert standaard een aantal templates per vertical (vastgoed, retail, horeca, kantoor). Je kunt:
- Een bestaande template **duplicëren en aanpassen** aan je huisstijl
- Een **eigen template** uploaden vanaf nul
- **Per vertical filteren** in de templates-bibliotheek
## Wat een template niet is
Een template is geen losse content. Een template + data-item = één scene die in een playlist past. Zonder gekoppelde data toont de template enkel zijn placeholder-inhoud (de zogeheten preview-data).
Een playlist maken die templates gebruikt
---
# Wat is een zone
Een zone is een rechthoekig deelgebied van een scherm met eigen content. Door een scherm in zones te verdelen, toon je meerdere dingen op hetzelfde glas.
## Wanneer gebruik je zones
Wanneer één enkel content-item het scherm niet vol mag of moet maken:
- Een groot pand links, contactgegevens rechts
- Menu-kaart bovenaan, prijzen onderaan
- Live video met daarnaast een sociale-media-feed
Eén zone toont één content-stroom. Dezelfde scherm-pixel kan tegelijk een rotatie van panden tonen in zone 1 en een statische banner in zone 2.
## Hoe zones eruitzien
Zones zijn ingebouwd in een **template**. Een template kiest een **layout-type** (fullscreen, split-screen, elegant-stacked, gallery-grid) en stelt de zones binnen die layout in. Eens een template gekozen is, ligt de zone-indeling vast. Wat erin draait kun je per zone variëren.
## Verschil met meerdere schermen
Twee schermen naast elkaar = twee aparte spelers, twee aparte content-rotaties. Eén scherm met twee zones = één speler, één template, twee deelgebieden binnen hetzelfde glas. De keuze hangt vaak af van fysieke beperkingen en hoe je de boodschap visueel wil opdelen.
Zones in een template instellen
---
# Data-integraties
Een data-integratie haalt automatisch panden, prijzen en foto's uit je CRM en zet ze op je schermen. Eens geconfigureerd hoef je niets meer te uploaden. gibeon.io synchroniseert in de achtergrond.
---
# Microsoft Excel-koppeling
De Excel-koppeling leest data uit een werkmap op OneDrive of SharePoint via de Microsoft Graph API. Eens geconfigureerd ververst je scherm elke 15 minuten automatisch met de laatste waarden uit je werkmap. Geen Power BI-licentie nodig, geen tussenscripts, geen handmatige uploads.
## Wat doet de koppeling
- Leest één cel, één rij, een lijst rijen of een hele tab uit
- Vernieuwt elke 15 minuten, of meteen via **Nu synchroniseren**
- Werkt offline op de spelers: de laatste waarde blijft 24-72 uur zichtbaar bij internetstoring
- Ondersteunt privé-werkmappen via Microsoft 365 OAuth, geen publieke share-link nodig
- Past templating toe via de gibeon.io-template-engine, dezelfde als voor pand- en menutemplates
- Respecteert je Azure AD Conditional Access policies en tenant-permissies
## Vereisten
- Een gibeon.io-account, gratis tier volstaat
- Een Microsoft 365 / Office 365-account met toegang tot de werkmap
- Een werkmap op OneDrive for Business of SharePoint Online
- Voor row-presets: kolomheaders in rij 1
## Koppeling aanmaken
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Data-bronnen** en klik op **Nieuwe data-bron**.
3. Kies **Microsoft Excel**.
4. Klik op **Verbind met Microsoft** en log in met je 365-account. Geef leesrecht op de werkmappen die je expliciet selecteert. Je hoeft geen Azure-app te registreren. De gibeon.io-app is al goedgekeurd door Microsoft.
5. Kies werkmap, tab en cel of bereik.
6. Kies een preset:
- **KPI Groot** voor één cel als groot getal
- **Eén rij als kaart** voor een rij in een template-layout
- **Roterende lijst** voor meerdere rijen die rouleren
- **Tabel-view** voor de hele tab
- **Dashboard-grid** voor een 2×2, 3×2 of 4×3 layout met meerdere KPI's
7. Sla op en sleep de data-bron op een playlist of scherm.
De eerste sync start automatisch en is meestal binnen 30-60 seconden klaar voor werkmappen tot 10 MB.
## Presets
### KPI Groot: één cel als groot getal
Toont één cel als één groot getal, optioneel met label en conditional colors. Voor productie-output, dagomzet, wachttijd, OEE-score, voorraad.
Configuratie:
- **Cel-referentie**: bv. `Productie!B5` of `Sales!E12`
- **Label** (optioneel): bv. "Productie vandaag", "Omzet MTD"
- **Conditional colors** (optioneel): drempel-waarden voor groen/oranje/rood
- **Doelwaarde** (optioneel): wordt naast het cijfer getoond met percentage-vergelijking
### Eén rij als kaart
Toont één geselecteerde rij als kaart met jouw template. Voor "ploeg-leider van de dag", "huidige order", "actuele storingsmelding".
Configuratie:
- **Rij-selectie**: cel-referentie waar de actieve rij in staat (bv. een Excel-naamgebied of een cel met formule)
- **Template**: drag-drop layout-bouwer
- **Veldmapping**: welke kolom uit de rij bind je aan welk template-veld
### Roterende lijst
Loopt door alle rijen in een bereik, X seconden per rij, elke rij in jouw template. Voor open orders met klantnaam en deadline, lopende projecten met status, leaderboards.
Configuratie:
- **Rij-bereik**: bv. `Orders!A2:F50`
- **Filter** (optioneel): bv. "alleen rijen waar kolom E = 'open' is"
- **Tijd per rij**: 5-30 seconden, default 10
- **Template**: zelfde drag-drop als kaart-preset
### Tabel-view
Toont een hele tab als leesbare tabel: vetgedrukte headers, ruim padding, alternerende rijkleuren. Voor productieplanning, voorraad-overzicht, ploegrooster.
Configuratie:
- **Tab-naam**: bv. "Planning week 22"
- **Kolommen tonen**: kies welke kolommen op het scherm verschijnen (handig om kolommen met formules of metadata te verbergen)
- **Sortering**: optioneel sorteer-veld
### Dashboard-grid
Schikt meerdere KPI's in een raster naast elkaar. Voor sales-dashboards, finance-dashboards, executive-dashboards.
Configuratie:
- **Raster**: 2×2 (4 tegels), 3×2 (6 tegels), 4×3 (12 tegels), of vrije layout
- **Per tegel**: cel-referentie + label + optionele target + conditional colors
- **Datum-label** (optioneel): bv. "MTD t/m maandag" automatisch berekend
## Conditional formatting en charts
Excel's eigen conditional formatting en charts worden niet 1:1 overgenomen. Wij lezen de berekende cel-waarde, niet de visuele opmaak. Voor hetzelfde effect:
- Voor conditional colors: gebruik onze drempel-waarden op de KPI Groot- of Dashboard-preset
- Voor charts: gebruik de cel-waarden in onze template-engine; lijn- en staafdiagrammen komen begin Q3 2026
## Refresh-frequentie
Standaard om de 15 minuten. Manueel triggeren via **Nu synchroniseren** in de gibeon.io CMS. Pro-tier ondersteunt 5-minuten-sync voor real-time productie- en sales-dashboards.
Bij internet-uitval blijft de laatst-opgehaalde waarde 24-72 uur zichtbaar in de cache. Een verbroken verbinding wordt aan de bovenkant van het scherm getoond met een klein "cache" indicator.
## Permissies en security
Wij gebruiken delegated permissions via Microsoft Graph API met `Files.Read.All` scope op de werkmappen die je expliciet selecteert. Geen schrijfrechten. Geen toegang tot andere werkmappen of OneDrive-folders dan je expliciet kiest.
Een gebruiker die geen toegang heeft tot een werkmap krijgt die ook niet via gibeon.io op het scherm. Conditional Access policies (MFA, IP-restricties) blijven gelden. Wij voegen geen omleidingsroutes toe.
## Beperkingen
- Werkmappen groter dan 100 MB werken niet betrouwbaar: Microsoft Graph beperkt de file-size voor real-time uitlezen
- Lokale .xlsx-bestanden die nooit op OneDrive of SharePoint staan, worden niet ondersteund
- Excel macros (VBA) worden niet uitgevoerd: wij lezen de opgeslagen waarden, niet macros
- Voor real-time PLC-data raden we aan om een MES- of historian-tool tussen je PLC en Excel te zetten
## Probleemoplossing
### "Werkmap niet gevonden" na verbinding
De gebruiker die de OAuth-flow heeft doorlopen heeft mogelijk geen toegang tot de werkmap. Check of de gebruiker de werkmap kan openen in Excel Online. Als dat niet werkt, werkt gibeon.io ook niet.
### Cijfers zijn een uur oud op de wand-TV
Mogelijk staat de werkmap op een SharePoint-site die meer dan 100 MB groot is en synct traag op de Microsoft-kant. Verplaats kritieke werkmappen naar een OneDrive for Business-locatie of een lichtere SharePoint-bibliotheek.
### Formules berekenen niet
Wij lezen de opgeslagen waarde. Als Excel de formule niet heeft uitgerekend voor je het bestand opslaat, lezen wij een leeg veld of een #NAME? error. Forceer een Excel-recalc met F9 en opslaan voor je verwacht dat we de waarde lezen.
## Aanverwante landingspagina's
- [Excel op je scherm](https://www.gibeon.io/excel-op-scherm): algemene marketing-landing
- [Excel-dashboard live op je TV](https://www.gibeon.io/excel-dashboard-op-tv): KPI-dashboard use-case
- [Productiebord uit Excel op je werkvloer](https://www.gibeon.io/excel-productiebord-tv): manufacturing OEE-board
- [Google Sheets-koppeling](./google-sheets-koppeling): vergelijkbare flow met Google in plaats van Microsoft
## Tarieven
Gratis tot 3 schermen + 1 Excel-koppeling. Pro €99/maand voor 10 schermen + audit log. Business €198/maand voor 10 workspaces. Geen per-werkmap-tarief, geen per-cel-tarief: onbeperkt aantal Excel-koppelingen binnen je workspace.
---
# Google Calendar-koppeling
De Google Calendar-koppeling leest agenda-data uit Google Workspace via OAuth. Eens geconfigureerd ververst je scherm elke 15 minuten automatisch met de laatste meetings, out-of-office en bezoeker-info. Werkt met privé-calendars en resource-calendars (vergaderzalen).
## Wat doet de koppeling
- Toont vergaderzaal-status (bezet/vrij + huidige + volgende meeting)
- Toont team-agenda (komende afspraken voor het hele team)
- Combineert tot 5 calendars op één scherm
- Vernieuwt elke 15 minuten, of meteen via **Nu synchroniseren**
- Werkt offline op de spelers: de laatste agenda blijft 24-72 uur zichtbaar bij internetstoring
- Ondersteunt privé-calendars via OAuth, geen publieke share-link nodig
- Respecteert Google Workspace permissies (admin-restricties op resource-calendars werken door)
## Vereisten
- Een gibeon.io-account, gratis tier volstaat
- Een Google-account (persoonlijk of Workspace)
- Voor resource-calendars (vergaderzalen): Workspace-rechten om resource-calendars te zien
## Koppeling aanmaken
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Data-bronnen** en klik op **Nieuwe data-bron**.
3. Kies **Google Calendar**.
4. Klik op **Verbind met Google** en log in. Geef leesrecht op de calendars die je expliciet selecteert. Je hoeft geen calendar publiek te delen.
5. Kies één of meerdere calendars (tot 5).
6. Kies een preset:
- **Vergaderzaal-deur** voor één resource-calendar: bezet/vrij + countdown
- **Team-agenda** voor 1-5 calendars samen: chronologische lijst
- **Week-overzicht** voor multi-day planning
- **Receptie / bezoekers** voor lobby-schermen
- **Multi-zaal raster** voor alle vergaderzalen tegelijk
7. Sla op en sleep de data-bron op een playlist of scherm.
## Presets
### Vergaderzaal-deur: bezet/vrij + countdown
Toont één resource-calendar als deur-display. Zaalnaam, status (Bezet/Vrij), huidige meeting met titel en organisator, volgende meeting, "vrij voor X minuten" countdown.
Configuratie:
- **Resource-calendar**: bv. `meetingroom-alpha@bedrijf.com`
- **Privé-mode**: kies of titels en deelnemers worden getoond, of alleen "Bezet"
- **Branding**: zaalnaam, logo, kleuren
Aanbevolen hardware: 7-inch Android-tablet aan de muur, 24-inch TV via Chromecast, of e-paper display met aparte controller.
### Team-agenda: chronologische lijst
Combineer 1-5 calendars in een chronologische lijst van vandaag en morgen. Voor receptie, team-keuken, gemeenschappelijke ruimtes.
Configuratie:
- **Calendars**: tot 5 stuks
- **Tijdsspanne**: vandaag, vandaag+morgen, of week
- **Privé-filter**: privé-events tonen of verbergen
- **Color-coding**: overnemen uit Google of per calendar instellen
### Week-overzicht: 5-dagen-blokken
Voor planning-context. Meetings als gekleurde blokken per dag, voor team-managers die patronen willen zien.
### Receptie / bezoekers
Combineer een "Bezoekers"-calendar met openingstijden, wifi-info, contactnummer. Voor lobby-schermen waar bezoekers binnenkomen.
### Multi-zaal raster
Alle vergaderzalen tegelijk in een raster. Voor centraal facility-management-overzicht in de gang.
## Resource-calendars (vergaderzalen)
In Google Workspace zijn vergaderzalen gewone calendars onder "Resources". gibeon.io detecteert ze automatisch tijdens setup. Selecteer "Vergaderzaal Alpha" of "Boardroom 3e verdieping". Wij behandelen ze identiek aan persoonlijke calendars.
Admin-restricties (sommige resource-calendars zijn alleen zichtbaar voor bepaalde gebruikers in Workspace) blijven gelden. Een gebruiker die geen toegang heeft tot een zaal-calendar, krijgt hem ook niet via gibeon.io op het scherm.
## Privacy en sensitive meetings
Drie lagen van privacy-controle:
1. **Op meeting-niveau in Google**: markeer een meeting als "Privé". gibeon.io toont alleen "Bezet" zonder titel of deelnemers.
2. **Op calendar-niveau**: kies een gibeon.io-template-variant die altijd alleen status toont, geen titels.
3. **Op tenant-niveau** (enterprise): admin-policy om geen meeting-titels naar externe data-sources te sturen.
Voor M&A-meetings, HR-gesprekken, board-meetings raden we de "Minimal, alleen status"-template aan op alle vergaderzaal-displays.
## Refresh-frequentie
Standaard om de 15 minuten. Manueel triggeren via **Nu synchroniseren**. Pro-tier ondersteunt 5-minuten-sync voor vergaderzaal-displays waar elke minuut telt (last-minute booking-changes, no-show-detectie).
Bij internet-uitval blijft de laatst-opgehaalde agenda 24-72 uur zichtbaar in de cache. Een "verbinding hersteld"-badge verschijnt zodra het terug live is.
## Permissies en security
Wij gebruiken delegated permissions via Google OAuth2 met `https://www.googleapis.com/auth/calendar.readonly` scope. Alleen leesrecht. Geen schrijfrechten. Geen toegang tot andere Workspace-data dan de expliciet gekozen calendars.
Voor Workspace-admins: gibeon.io is een verified Google OAuth-app. Workspace-policies (data-region, retention, audit-log) blijven gelden. Wij respecteren ze.
## Beperkingen
- Sub-minuut-updates worden niet ondersteund: minimum 5 minuten op Pro, 15 op gratis
- Meetings met meer dan 100 deelnemers: deelnemers-lijst wordt afgekapt op het scherm (eerste 10 + count)
- Recurring events met onregelmatige uitzonderingen: wij tonen de berekende instances, niet de master-event
- Booking vanaf het scherm (tap-to-book) wordt op dit moment niet ondersteund
## Probleemoplossing
### "Calendar niet gevonden" na verbinding
De gebruiker die OAuth doorliep heeft mogelijk geen toegang tot de calendar. Check of de gebruiker hem kan openen in Calendar.google.com. Als dat niet werkt, werkt gibeon.io ook niet.
### Resource-calendars verschijnen niet in de lijst
Workspace-admin heeft mogelijk een restrictie geplaatst op "View resource calendars". Vraag aan je Workspace-admin om de gebruiker leesrecht op de resource-calendars te geven, of om een dedicated service-account voor gibeon.io op te zetten.
### Meeting verschijnt niet op scherm
Mogelijk privé-marked door de organisator. Check de Google Calendar-event-instellingen. Als "Privé" actief is, tonen wij alleen "Bezet". Voor wel-zichtbaar-mogen-events: vraag de organisator om "Standaard zichtbaarheid" of "Publiek".
### Tijden zijn een uur verkeerd
Time-zone-issue. Check of de calendar-tijdzone matcht met je locatie. Voor multi-locatie-bedrijven kan een resource-calendar in EU-tijdzone draaien terwijl het scherm in een US-locatie staat. Wij gebruiken de scherm-locale, niet de calendar-tijdzone.
## Aanverwante landingspagina's
- [Google Calendar op je scherm](https://www.gibeon.io/google-calendar-op-scherm): algemene marketing-landing
- [Vergaderzaal-display](https://www.gibeon.io/google-calendar-vergaderzaal): meeting room door use-case
- [Team-agenda op kantoor-TV](https://www.gibeon.io/google-calendar-kantoor-tv): office hub use-case
- [Google Sheets-koppeling](./google-sheets-koppeling): Sheets-data op een ander scherm
- [Excel-koppeling](./excel-koppeling): voor M365-equivalent
## Tarieven
Gratis tot 3 schermen + 1 Google Calendar-koppeling. Pro €99/maand voor 10 schermen + audit log. Business €198/maand voor 10 workspaces. Geen per-zaal-tarief, geen per-meeting-tarief: onbeperkt aantal calendar-koppelingen binnen je workspace.
---
# Google Sheets-koppeling
De Google Sheets-koppeling synchroniseert data uit een Google-spreadsheet naar gibeon.io. Eens geconfigureerd ververs je scherm elke 15 minuten automatisch met de laatste waarden uit je sheet. Geen tussenscripts, geen Zapier, geen handmatige uploads.
## Wat doet de koppeling
- Leest één cel, één rij, een lijst rijen of een hele sheet uit
- Vernieuwt elke 15 minuten, of meteen via **Nu synchroniseren**
- Werkt offline op de spelers: de laatste waarde blijft zichtbaar bij internetstoring
- Ondersteunt private sheets via Google OAuth, geen publieke share-link nodig
- Past templating toe via de gibeon.io-template-engine, dezelfde als voor pand- en menutemplates
## Vereisten
- Een gibeon.io-account, gratis tier volstaat
- Een Google-account met toegang tot de sheet
- Een sheet met kolomheaders in rij 1 (voor row-presets)
## Koppeling aanmaken
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Data-bronnen** en klik op **Nieuwe data-bron**.
3. Kies **Google Sheets**.
4. Klik op **Verbind met Google** en log in. Geef leesrecht op de sheets die je expliciet selecteert.
5. Kies sheet, tabblad en cel of bereik.
6. Kies een preset:
- **KPI Groot** voor één cel als groot getal
- **Eén rij als kaart** voor een rij in een template-layout
- **Roterende lijst** voor meerdere rijen die rouleren
- **Tabel-view** voor de hele sheet
7. Sla op en sleep de data-bron op een playlist of scherm.
De eerste sync start automatisch en is meestal binnen 30 seconden klaar.
## Presets
### KPI Groot: één cel als groot getal
Voor één cijfer dat groot leesbaar moet zijn: wachttijd, omzet, voorraad, OEE-percentage.
- Kies één exacte cel (bijvoorbeeld `Dashboard!B3`).
- Voeg optioneel een label toe ("Wachttijd vandaag").
- Stel conditional colors in op drempelwaarden (groen onder 10, oranje 10-20, rood erboven).
### Eén rij als kaart
Voor een specifieke rij die je als kaart-layout toont: medewerker van de maand, huidige aanbieding, actuele oproep.
- Selecteer één rij (filter op een waarde of kies expliciet een rij-index).
- Kies kolommen die zichtbaar moeten zijn.
- Pas de layout aan met de gibeon.io-template-editor of gebruik een default-template.
### Roterende lijst
Voor meerdere rijen die rouleren: menukaart, leaderboard, aankondigingen, queue-display.
- Kies een bereik (bijvoorbeeld `Menu!A2:E50`).
- Stel sorteer- en filter-regels in.
- Bepaal hoe lang elke rij in beeld blijft (3-30 seconden).
- Bouw de rij-layout in de template-editor of kies een default.
### Tabel-view
Voor wanneer je alles tegelijk wil tonen, leesbaar van afstand: planning, voorraad-overzicht, scoreboard.
- Kies een bereik.
- Stel headers, kolombreedte en padding in.
- gibeon.io kiest automatisch alternerende rij-kleuren voor leesbaarheid.
## Auto-refresh interval
Standaard ververst elke 15 minuten. Voor sommige use-cases is dat te traag (live-queue-display) of net snel zat (maandelijkse omzet). Het interval is vast op 15 minuten.
## Veelvoorkomende fouten
> **"Could not access sheet"**: De Google-account waarmee je inlogde heeft geen leesrecht op de geselecteerde sheet. Vraag de eigenaar om je te delen, of log in met een account dat toegang heeft.
> **"Sheet not found"**: De spreadsheet-ID is gewijzigd of de sheet is verwijderd. Bewerk de data-bron en herselecteer de sheet.
> **"Cell value is empty"**: De cel die je koos is leeg. Standaardgedrag: de laatste niet-lege waarde blijft staan. Configureerbaar in de data-bron-instellingen: vorige waarde behouden, fallback-tekst tonen, of item overslaan in de playlist.
## Permissies en privacy
- gibeon.io vraagt alleen **leesrecht** op de sheets die jij selecteert.
- We slaan geen sheet-inhoud op, behalve de laatst-opgehaalde waarde voor de offline-fallback op de speler.
- Je kan de toegang elk moment intrekken via [je Google-accountinstellingen](https://myaccount.google.com/permissions).
Een eerste playlist maken
---
# Omnicasa-koppeling
De Omnicasa-koppeling synchroniseert je actieve panden uit Omnicasa naar gibeon.io. Geen API-sleutel nodig: je geeft enkel je Customer ID op en wij regelen de rest aan onze kant.
## Wat doet de koppeling
- Synchroniseert actieve panden uit Omnicasa naar gibeon.io
- Haalt foto's, prijs, oppervlakte, type en beschrijving op
- Vernieuwt elke 15 minuten, of meteen via **Nu synchroniseren**
- Werkt offline op de spelers
- Eén integratie per Omnicasa-kantoor
## Vereisten
- Een gibeon.io-account op het Standard-plan
- Een Omnicasa-account
- Je Omnicasa **Customer ID** (een nummer, bijvoorbeeld `166`)
Je Customer ID is hetzelfde nummer dat je in Omnicasa-URL's of facturen ziet. Vraag het op bij je Omnicasa-contactpersoon als je het niet meteen vindt.
## Koppeling aanmaken
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Integraties** en klik op **Nieuwe integratie**.
3. Kies **Omnicasa**.
4. Vul je Customer ID in en klik op **Verbinden**.
5. De eerste sync start automatisch.
## Welke velden komen mee
| Veld | Gebruik in templates |
|------|----------------------|
| Foto's | Hero, carrousel, mini's |
| Prijs | Prijs-overlay of tekstblok |
| Adres | Adres-blok |
| Oppervlakte (m²) | Specs-blok |
| Type pand | Filter |
| Status | "Verkocht"-overlay, filtering |
| Beschrijving | Tekstblok |
| Slaapkamers | Specs-blok |
## Synchronisatie
Vernieuwing elke 15 minuten. Wijzigingen in Omnicasa staan binnen het kwartier op je scherm. Een handmatige sync vertrekt via **Nu synchroniseren** op de integratie-pagina.
## Wat als het niet werkt
Controleer dat je Customer ID klopt. Het is het numerieke ID, niet je login of e-mailadres. Vraag het bij je Omnicasa-contactpersoon als je twijfelt.
De koppeling werkt, maar Omnicasa levert geen actieve panden. Controleer in Omnicasa of er panden zijn met de juiste publicatiestatus. Gearchiveerde of inactieve panden komen niet mee.
Mail [support@gibeon.io](mailto:support@gibeon.io) met de naam van het Omnicasa-veld. We breiden de mapping uit als het veld via de Omnicasa-API beschikbaar is.
Zabun-koppeling
---
# Skarabee-koppeling
De Skarabee-koppeling synchroniseert je actieve panden via Skarabee MediaLink naar gibeon.io. Je dient een korte aanvraag in en ons team activeert de credentials samen met jou.
## Wat doet de koppeling
- Synchroniseert actieve panden via Skarabee MediaLink naar gibeon.io
- Haalt foto's, prijs, oppervlakte, type, status en beschrijving op
- Vernieuwt elke 15 minuten
- Werkt offline op de spelers
- Eén integratie per Skarabee-kantoor
## Vereisten
- Een gibeon.io-account op het Standard-plan
- Een actief Skarabee-account met MediaLink-toegang
- MediaLink-credentials (gebruikersnaam en wachtwoord). Heb je die nog niet, vraag ze aan bij Skarabee. Wij helpen je met de juiste contactpersoon als je vastloopt.
## Koppeling aanvragen
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Integraties** en klik op **Nieuwe integratie**.
3. Kies **Skarabee**.
4. Vul je naam, e-mail en (optioneel) telefoonnummer in. Klik **Aanvragen**.
5. Ons team neemt binnen één werkdag contact op om de MediaLink-credentials op te halen en de koppeling te activeren.
Zodra wij de koppeling activeren start de eerste sync automatisch.
## Welke velden komen mee
| Veld | Gebruik in templates |
|------|----------------------|
| Foto's | Hero, carrousel, mini's |
| Prijs | Prijs-overlay of tekstblok |
| Adres | Adres-blok |
| EPC | Specs-blok, hoek-overlay |
| Oppervlakte (m²) | Specs-blok |
| Status | "Verkocht"-overlay, filtering |
| Type pand | Filter |
| Beschrijving | Tekstblok |
| Slaapkamers | Specs-blok |
## Synchronisatie
Vernieuwing elke 15 minuten. Wijzigingen in Skarabee staan binnen het kwartier op je scherm. Een handmatige sync vertrekt via **Nu synchroniseren** op de integratie-pagina.
## Wat als het niet werkt
Binnen één werkdag nemen we contact op. De feitelijke activering hangt af van hoe snel de MediaLink-credentials beschikbaar zijn. Reken meestal op 1 à 3 werkdagen totaal.
De koppeling werkt, maar Skarabee levert geen actieve panden voor dit kantoor. Controleer in Skarabee of er panden zijn met status "actief". Gearchiveerde panden komen niet mee.
Standaard blijft een verkocht pand zichtbaar met een "Verkocht"-overlay totdat de status in Skarabee definitief op archief staat. Je past de grace-periode aan in de template of zet de "Verkocht"-overlay uit.
Ja. Vraag per kantoor een aparte integratie aan. Per scherm kies je daarna welke panden van welk kantoor je toont.
Mail [support@gibeon.io](mailto:support@gibeon.io) met de naam van het Skarabee-veld. We breiden de mapping uit als het veld via MediaLink beschikbaar is.
Een playlist maken die deze panden gebruikt
---
# Whise-koppeling
De Whise-koppeling synchroniseert al je actieve panden uit Whise naar gibeon.io. Eens geconfigureerd vernieuwt gibeon.io elke 15 minuten en tonen je schermen automatisch de nieuwste foto's, prijzen en statussen.
## Wat doet de koppeling
- Synchroniseert actieve panden uit jouw Whise-kantoor naar gibeon.io
- Haalt foto's, prijs, EPC, oppervlakte, status, type en beschrijving op
- Vernieuwt elke 15 minuten, of meteen via **Nu synchroniseren**
- Werkt offline op de spelers: content blijft draaien zonder internet
- Ondersteunt meerdere Whise-kantoren binnen één gibeon.io-tenant
## Vereisten
- Een gibeon.io-account op het Standard-plan
- Een Whise-account met API-toegang
- Je Whise **Client ID** (een nummer, bijvoorbeeld `1234`)
Je vindt je Client ID terug in Whise onder je accountgegevens, of vraag het bij je Whise-contactpersoon. Wij voegen aan onze kant onze gedeelde Whise-app-credentials toe. Jij hoeft geen API-sleutel of wachtwoord op te geven.
## Koppeling aanmaken
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Integraties** en klik op **Nieuwe integratie**.
3. Kies **Whise**.
4. Vul je Client ID in en klik op **Verbinden**.
5. De eerste sync start automatisch. Bij een paar honderd panden duurt dat 1-2 minuten.
## Welke velden komen mee
| Veld | Gebruik in templates |
|------|----------------------|
| Foto's | Hero, carrousel, mini's |
| Prijs | Prijs-overlay of tekstblok |
| Adres | Adres-blok |
| EPC | Specs-blok, hoek-overlay |
| Oppervlakte (m²) | Specs-blok |
| Status | "Verkocht"-overlay, filtering |
| Type pand | Filter (huis / appartement / grond) |
| Beschrijving | Tekstblok |
| Slaapkamers | Specs-blok |
| Bouwjaar | Specs-blok |
## Synchronisatie
Standaard synchroniseert gibeon.io **elke 15 minuten**. Wijzigingen in Whise staan binnen het kwartier op je scherm.
Wil je iets meteen zien? Open de integratie en klik op **Nu synchroniseren**. De sync vertrekt direct.
## Wat als het niet werkt
Controleer dat je de juiste Client ID gebruikt. Het is een numerieke ID, niet je e-mailadres of Whise-loginnaam. Vraag het bij je Whise-contactpersoon als je twijfelt.
De koppeling werkt, maar Whise levert geen actieve panden voor dit kantoor. Controleer in Whise of er panden zijn met status "actief", "te koop" of "te huur". Inactieve of gearchiveerde panden komen niet mee.
Wacht 5 minuten en probeer opnieuw via **Nu synchroniseren**. Houdt het aan, mail [support@gibeon.io](mailto:support@gibeon.io) met je tenant-ID en het tijdstip. Wij kijken in de logs.
Standaard blijft een verkocht pand zichtbaar met een "Verkocht"-overlay totdat de status in Whise op archief staat. Je kunt deze grace-periode in de template wijzigen of de "Verkocht"-overlay uitzetten.
Ja. Voeg per kantoor een aparte integratie toe met zijn eigen Client ID. Per scherm kies je daarna welke panden van welk kantoor je toont.
Omnicasa-koppeling
---
# Zabun-koppeling
De Zabun-koppeling synchroniseert je actieve panden uit Zabun (Max Immo) naar gibeon.io. Anders dan Whise of Omnicasa heeft Zabun per-klant credentials nodig die wij voor jou activeren. Je dient een korte aanvraag in en ons team neemt het over.
## Wat doet de koppeling
- Synchroniseert actieve panden uit Zabun naar gibeon.io
- Haalt foto's, prijs, oppervlakte, type, status en beschrijving op
- Vernieuwt elke 15 minuten
- Werkt offline op de spelers
- Eén integratie per Zabun-kantoor
## Vereisten
- Een gibeon.io-account op het Standard-plan
- Een actief Zabun-account met API-toegang
- API-credentials van Zabun. Heb je die nog niet, vraag ze aan bij Zabun. Wij helpen je met de juiste contactpersoon als je vastloopt.
## Koppeling aanvragen
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Integraties** en klik op **Nieuwe integratie**.
3. Kies **Zabun**.
4. Vul je naam, e-mail en (optioneel) telefoonnummer in. Klik **Aanvragen**.
5. Ons team neemt binnen één werkdag contact op om de credentials op te halen en de koppeling te activeren.
Zodra wij de koppeling activeren start de eerste sync automatisch. Bij een paar honderd panden duurt dat 1 à 2 minuten.
## Welke velden komen mee
| Veld | Gebruik in templates |
|------|----------------------|
| Foto's | Hero, carrousel, mini's |
| Prijs | Prijs-overlay of tekstblok |
| Adres | Adres-blok |
| EPC | Specs-blok, hoek-overlay |
| Oppervlakte (m²) | Specs-blok |
| Status | "Verkocht"-overlay, filtering |
| Type pand | Filter (residentieel, commercieel, grond) |
| Beschrijving | Tekstblok |
| Slaapkamers | Specs-blok |
## Synchronisatie
Vernieuwing elke 15 minuten. Wijzigingen in Zabun staan binnen het kwartier op je scherm. Een handmatige sync vertrekt via **Nu synchroniseren** op de integratie-pagina.
## Wat als het niet werkt
Binnen één werkdag nemen we contact op. De feitelijke activering hangt af van hoe snel de credentials beschikbaar zijn aan Zabun-zijde. Reken meestal op 1 à 3 werkdagen totaal.
De koppeling werkt, maar Zabun levert geen actieve panden voor dit kantoor. Controleer in Zabun of er panden zijn met status "te koop" of "te huur". Gearchiveerde panden komen niet mee.
Standaard blijft een verkocht pand zichtbaar met een "Verkocht"-overlay totdat de status in Zabun definitief op archief staat. Je past de grace-periode aan in de template of zet de "Verkocht"-overlay uit.
Ja. Vraag per kantoor een aparte integratie aan. Per scherm kies je daarna welke panden van welk kantoor je toont.
Mail [support@gibeon.io](mailto:support@gibeon.io) met de naam van het Zabun-veld. We breiden de mapping uit als het veld via de Zabun-API beschikbaar is.
Skarabee-koppeling
---
# Facturatie en abonnementen
Wat kost gibeon.io, welk plan past bij je situatie, welke add-ons je kan bijnemen en waar je je facturen vindt.
---
# Priority Support
€99 per maand of **€990 per jaar (twee maanden gratis)**. Te activeren op het Business-plan.
## Wat krijg je
- Eigen contactpersoon bij gibeon.io (naam + direct email-adres + telefoon)
- Reactie binnen één werkdag, ook op niet-blokkerende vragen
- Directe escalatie naar engineering bij iets dat een live scherm raakt
- Toegang tot een gedeeld Slack-kanaal voor snelle vragen
## Voor wie
Voor klanten die snel willen kunnen schakelen wanneer iets niet werkt zoals verwacht. Een retailer die een nieuwe campagne lanceert, een agency die op deadline werkt voor een klant, een hotel waar de schermen in de lobby er altijd uit moeten zien zoals beloofd.
Free of email-support is voldoende voor wie geen kritieke schermen heeft of zelf graag zoekt in de documentatie.
## Activeren
**Instellingen → Facturatie → Add-ons → Priority Support**. Stripe-checkout, meteen actief. Je contactpersoon krijg je in de mail binnen één werkdag na activatie.
## Inbegrepen in Agency
Het Agency-plan heeft Priority Support standaard inbegrepen, geen aparte activatie nodig.
---
# Storage Pack
€10 per maand per 100 GB extra opslag bovenop wat je plan al bevat. Stapelbaar zonder limiet: 300 GB extra is drie packs van €10 = €30/maand.
## Wanneer activeren
Je krijgt een banner in de CMS zodra je opslag boven 80% van je plan-limiet zit. Op dat moment kan je:
- Een Storage Pack erbij nemen (één klik vanuit de banner)
- Oude assets opruimen via **Inhoud beheren → Mediabibliotheek**
- Upgraden naar een hoger plan met meer opslag inbegrepen
Pas wanneer je effectief boven de limiet zit, blokkeert een upload. Tot dan zie je alleen de waarschuwing.
## Wat telt mee voor opslag
Alle bestanden die je in de gibeon.io-mediabibliotheek upload: afbeeldingen, video-thumbnails, fonts, custom HTML-assets, brand-assets, logo's. Video die je via onze video-CDN streamt telt **niet** mee voor de Storage cap.
## Activeren
**Instellingen → Facturatie → Add-ons → Storage Pack**. Stripe-checkout, meteen actief. Je nieuwe limiet zie je direct in **Instellingen → Usage**.
## Opslag per plan (inbegrepen)
| Plan | Inbegrepen opslag |
|------|-------------------|
| Free | 5 GB |
| Starter | 25 GB |
| Pro | 100 GB |
| Business | 500 GB |
| Agency | 500 GB (gedeeld over alle sub-accounts) |
Voor opslag boven Business of Agency komt Enterprise in beeld. Daar geldt geen vaste limiet maar een contractueel afgesproken volume.
---
# Whitelabel
€79 per maand of **€790 per jaar (twee maanden gratis)**. Te activeren vanaf het Pro-plan. (Verlaagd van €149 in mei 2026.)
## Wat krijg je
- Eigen domein voor de CMS (bv. `signage.jouwbedrijf.be`)
- Eigen logo, kleuren en favicon in de CMS-interface
- "Powered by gibeon.io" verdwijnt overal: login, mails, footer, speler-watermark
- Custom email-afzender voor uitnodigingen en notificaties
## Vereisten
Eén ding: je moet zelf een (sub)domein aansteken dat naar onze CMS verwijst. We geven een CNAME-instructie zodra je de add-on activeert. SSL-certificaat regelen wij automatisch.
Geen minimum aantal schermen meer nodig (de oude drempel van 20 schermen is geschrapt in mei 2026).
## Voor wie
- Eénpitter-makelaar of garage die zijn klanten een merkbeleving wil geven
- Agency die voor klanten werkt en de eigen huisstijl wil tonen
- Franchise-keten die "Powered by gibeon.io" wil vervangen door de eigen merknaam
## Activeren
**Instellingen → Facturatie → Add-ons → Whitelabel**. Stripe-checkout, daarna kies je je domein en upload je je logo. CNAME-instructie krijg je in de UI.
## Inbegrepen in Agency
Het Agency-plan heeft Whitelabel standaard inbegrepen, plus de mogelijkheid om sub-accounts allemaal onder jouw merk te draaien.
---
# Facturen downloaden
Facturen, betaalmethodes en facturatiegegevens beheer je via het Stripe Customer Portal. Geen aparte logins: je opent het rechtstreeks vanuit gibeon.io.
## Het facturatie-portaal openen
1. Log in op [app.gibeon.io](https://app.gibeon.io).
2. Ga naar **Instellingen → Facturatie**.
3. Klik op **Beheer abonnement**.
Een tab opent met je facturatie-portaal. Hier kun je facturen, betaalmethodes en je adresgegevens beheren.
## Wat kun je in het portaal
- **Facturen downloaden** als PDF, één voor één of in bulk
- **Betaalmethode wijzigen**: kaart of SEPA-domiciliëring
- **Facturatieadres en BTW-nummer aanpassen**: wordt op de volgende factuur overgenomen
- **Abonnement aanpassen of opzeggen**: annuleren stopt aan het einde van de lopende periode
- **Betalingsgeschiedenis bekijken**: alle facturen, gelukte en mislukte betalingen
## Veelgestelde vragen
Wijzig je facturatieadres in het portaal. Volgende facturen krijgen de nieuwe naam. Een al uitgegeven factuur wijzigen we manueel. Stuur ons een mail met je tenant-ID en de gewenste correctie.
Voeg het toe in het portaal onder **Facturatieadres → BTW-nummer**. Vanaf de volgende factuur staat het erop. Hebben we al een factuur uitgegeven zonder BTW-nummer, dan kunnen we hem hernieuwen op aanvraag.
Ja. We sturen de factuur naar het e-mailadres dat in het portaal staat. Wil je dat het naar je boekhoudafdeling gaat, vul daar het juiste adres in.
We proberen automatisch opnieuw na enkele dagen. In tussentijd kun je in het portaal een nieuwe betaalmethode toevoegen, dan rekenen we direct af. Lukt het niet binnen twee weken, dan pauzeren we het account tot betaling is voldaan.
Prijzen en abonnementen
---
# Prijzen en abonnementen
gibeon.io werkt met **workspace pricing**: één basisprijs per workspace, plus een vaste prijs per extra scherm boven het inbegrepen aantal. Vijf plannen: Gratis om uit te proberen, Starter voor een single-shop KMO, Pro voor zaken met meer schermen of een actieve CRM-koppeling, Business voor ketens met meerdere eigen vestigingen, en Agency voor wie signage manageert voor andere organisaties.
Geen volume-korting-formules om te onthouden, geen white-label-minimum apart te tellen. Wat je niet inbegrepen krijgt, betaal je via een transparante per-scherm en per-AI-generatie overage. Add-ons (Priority Support, Whitelabel, Storage Pack) en hardware (gibeon.io player Premium en Basic) bestel je los of als onderdeel van een hoger plan.
## Gratis
€0 per maand. Bedoeld om uit te proberen, niet voor productie.
- **3 schermen** (harde limiet)
- 1 CRM-koppeling actief, max 100 panden gesynct
- **5 AI-scènegeneraties per maand** (harde limiet, geen overage)
- 5 GB opslag, 30 video-minuten per maand
- **"Powered by gibeon.io" watermerk** op de speler
- **720p maximale resolutie** (geen 1080p of 4K)
- Community support
## Starter
€39 per maand of **€390 per jaar (twee maanden gratis)**.
- 1 vestiging (workspace)
- **Tot 5 schermen** (harde limiet)
- 1 CRM-koppeling actief
- **25 AI-scènegeneraties per maand** inbegrepen, €0,10 per extra generatie
- Geen watermerk
- Email support
Voor een makelaar met één zaak, een garage, een café of een kleine retailer.
## Pro
€99 per maand of **€990 per jaar (twee maanden gratis)**.
- 1 vestiging
- **10 schermen inbegrepen + €5 per extra scherm** (soft cap, je koopt door)
- Alle CRM-koppelingen tegelijk actief
- **100 AI-scènegeneraties per maand** inbegrepen, €0,10 per extra generatie
- Audit log + proof-of-play
- Priority email support
Voor zaken met meerdere schermen of wie meerdere CRMs tegelijk wil koppelen.
## Business
€198 per maand of **€1.980 per jaar (twee maanden gratis)**.
Alles van Pro, plus:
- **10 vestigingen (multi-workspace)**: verschillende merknamen of locaties onder één account
- **10 schermen inbegrepen + €5 per extra scherm** (soft cap, zelfde rate als Pro)
- **300 AI-scènegeneraties per maand** inbegrepen, €0,10 per extra generatie
- API + webhooks
De €99 prijsverschil met Pro is de multi-vestiging-fee: vlak, geen per-scherm uplift. Voor ketens en franchises die meerdere eigen vestigingen onder verschillende namen beheren.
## Agency
€249 per maand of **€2.490 per jaar (twee maanden gratis)**.
Voor wie schermen beheert voor andere organisaties (reseller, agency, integrator):
- 1 hoofdworkspace + **onbeperkt sub-accounts** (elk een eigen klant)
- **20 schermen inbegrepen pool**, verdeeld over je sub-accounts
- **€8 per extra scherm** boven het pool (vlak, ongeacht hoe de schermen over je sub-accounts verdeeld zijn)
- **500 AI-scènegeneraties per maand** inbegrepen (pooled), €0,10 per extra generatie
- **Whitelabel** zit inbegrepen (eigen domein, eigen branding)
- **Priority Support** zit inbegrepen
- Sub-account management vanuit één facturatie-rekening
Elke sub-account is een volwaardige klant-omgeving onder je eigen merk. Sub-accounts erven jouw Agency-branding.
De vlakke €8/scherm boven de 20-pool is bewust eenvoudig gehouden. Er is geen apart tarief per sub-account: of je nu 40 klanten met één scherm hebt of 8 klanten met vijf schermen, je betaalt hetzelfde bedrag voor dezelfde 60 schermen.
## Jaarbetaling
Bij jaarbetaling betaal je 10 maanden vooraf en houd je 2 maanden over. Dat geldt voor elk betaald plan: Starter, Pro, Business en Agency. Schakelen tussen maandelijks en jaarlijks kan op elk moment via **Instellingen → Facturatie**. Scherm- en AI-overage blijven maandelijks gefactureerd, ook bij jaarbetaling.
| Plan | Maandelijks | Jaarbetaling | Effectief per maand |
|------|-------------|--------------|---------------------|
| Starter | €39 | €390 | €32,50 |
| Pro | €99 | €990 | €82,50 |
| Business | €198 | €1.980 | €165 |
| Agency | €249 | €2.490 | €207,5 |
## Add-ons
Drie add-ons die je los bij je plan kan nemen wanneer je ze nodig hebt:
- **[Priority Support](/docs/facturatie/add-ons/priority-support)**: €99/maand. Eigen contactpersoon, reactie binnen één werkdag. Beschikbaar op Business. Bij Agency en Enterprise inbegrepen
- **[Whitelabel](/docs/facturatie/add-ons/whitelabel)**: €79/maand. Eigen domein en branding. Beschikbaar vanaf Pro. Bij Agency en Enterprise inbegrepen
- **[Storage Pack](/docs/facturatie/add-ons/storage-overage)**: €10/maand per 100 GB. Stapelbaar. Voor wie meer mediabibliotheek nodig heeft dan zijn plan bevat
## Hardware
gibeon.io draait op je eigen toestel: een Smart TV met Google TV, een Android-stick of -box, een mini-PC of een professionele signage-display met browser. Geen aparte hardware nodig.
Zie het [hardware-overzicht](/docs/schermen-en-spelers/hardware-overzicht/) voor de beslissingscriteria, of [App installeren via APK](/docs/hardware/apk-installeren) om de app op een Android-toestel zonder Play Store te zetten.
## Veelgestelde vragen
Free heeft harde limieten op zowel schermen (3) als AI-generaties (5/maand). Een banner verschijnt in de CMS wanneer je de limiet nadert. Wil je meer? Upgrade naar Starter (€39/maand) waar de scherm-limiet 5 wordt en de AI-cap 25/maand met pay-as-you-go boven cap.
**Instellingen → Facturatie → Upgrade**. Kies je tier (Starter, Pro, Business of Agency), kies maandelijks of jaarlijks, geef een betaalmethode op via Stripe en de upgrade is meteen actief. We rekenen pro rata af voor de lopende maand.
Ja, op elk moment. Je houdt je betaalde plan tot het einde van de betaalde periode. Komt het scherm-aantal of het aantal panden boven de Free-limiet uit, dan moet je eerst inkrimpen.
Starter is voor een single-shop met tot 5 schermen (hard cap) en 1 actieve CRM-koppeling. Pro heeft 10 schermen inbegrepen + €5 per extra scherm (soft cap, geen limiet), alle CRM-koppelingen tegelijk actief, en priority email support. Bij meer dan 5 schermen of wanneer je een tweede CRM-koppeling wil activeren, is Pro de logische stap.
Pro is voor één vestiging. Business is voor wie tot 10 eigen vestigingen apart wil beheren onder één account, plus API-toegang en facturatie op 30 dagen. Per-scherm-prijs is identiek (€5 boven 10 incl). Het €99 prijsverschil is de vlakke multi-vestiging-fee.
Business is voor wie zijn eigen vestigingen beheert (één merk, meerdere locaties). Agency is voor wie schermen beheert voor andere organisaties. Agency krijgt onbeperkt sub-accounts, Whitelabel en Priority Support inbegrepen, en sub-account management vanuit één facturatie-rekening. Boven het 20-schermen-pool reken je €8 per extra scherm, ongeacht hoeveel sub-accounts je hebt. Maak je geen onderscheid? Kies Business.
Pro, Business en Agency hebben soft caps op schermen, je kan altijd door bijkopen aan de overage-rate (€5/scherm voor Pro/Business, €8/scherm voor Agency). Alleen Free (3 schermen) en Starter (5 schermen) hebben harde limieten waarbij je niet meer kan toevoegen zonder te upgraden. Hetzelfde geldt voor AI-generaties: Free heeft een hard cap (5/maand), de andere tiers laten je over de cap met €0,10/gen pay-as-you-go.
Onze usage-meter draait elk uur en kijkt hoeveel schermen je workspace heeft. Aan het einde van je facturatiecyclus berekent een dagelijkse cron de overage en pusht die naar Stripe als metered usage. Je ziet de overage als aparte regel op je maandfactuur ("Pro screen overage: 12 × €5 = €60"). Pro en Business gebruiken één rate van €5/scherm. Agency rekent €8 per extra scherm boven het 20-pool.
Geen aparte proefperiode met tijdslimiet. Het Free-plan is blijvend gratis: geen tijdslimiet, geen creditcard nodig. Je test er rustig mee en stapt over naar een betaald plan wanneer je meer schermen, hogere resolutie of proof-of-play en audit-logs nodig hebt.
Automatische incasso door Stripe, zelfde flow als Starter en Pro. Eén kaart op je account, één maandelijkse afschrijving voor alle 10 vestigingen samen. Wil je facturatie op factuur met betaaltermijn? Dat hoort bij Enterprise. Neem contact op via [matthias@gibeon.io](mailto:matthias@gibeon.io).
Facturen downloaden
---
# Hardware
Alles over de hardware waarop gibeon.io draait: aanbevolen Android-toestellen en hoe je de app installeert. Kies in de zijbalk een onderwerp.
Geen Play Store op je toestel? Er zijn twee installatiepaden, kies vooraf de juiste:
- [App installeren via APK](/docs/hardware/apk-installeren/): de gewone app, het toestel blijft ook voor andere dingen bruikbaar.
- [Kiosk installeren (Device Owner)](/docs/hardware/kiosk-installeren/): een vergrendeld scherm dat alleen gibeon.io toont, voor publieke en onbeheerde opstellingen.
---
# App installeren via APK (zonder Play Store)
Heeft je Android-toestel geen Google Play Store (een signage-scherm met ingebouwde Android, of een merk dat zonder Play geleverd wordt)? Dan installeer je de gibeon.io-app rechtstreeks via het APK-bestand. Staat de Play Store er wél op, gebruik dan die route, dat is sneller, zie het [hardware-overzicht](/docs/schermen-en-spelers/hardware-overzicht/).
:::tip[Bouw je een vergrendeld kiosk-scherm?]
Deze pagina installeert de **gewone app**: het toestel blijft ook voor andere dingen bruikbaar. Voor een publiek scherm dat alleen gibeon.io mag tonen bestaat een aparte kioskversie. Volg dan [Kiosk installeren (Device Owner)](/docs/hardware/kiosk-installeren/) en sla deze pagina over: een kiosk gebruikt een andere APK en vraagt een leeg toestel zonder Google-account.
:::
## Wat heb je nodig
- Een Android-toestel met Android 11 of nieuwer
- Een internetverbinding op het toestel
- Je activatiecode uit de CMS (**Schermen → scherm toevoegen**)
## Stap 1: Onbekende bronnen toestaan
Android blokkeert standaard apps van buiten de Play Store. Zet dit aan voor de app waarmee je de APK gaat openen (je browser, een bestandsbeheerder of de Downloader-app):
**Instellingen → Apps → (de app) → Onbekende apps installeren → Toestaan.**
Op sommige toestellen heet dit **Install unknown apps** of **Unknown sources**.
## Stap 2: De APK op je toestel krijgen
Kies de methode die bij je toestel past.
### Via de browser of de Downloader-app (aanbevolen voor TV's en sticks)
1. Open de TV-browser, of installeer de gratis **Downloader**-app (beschikbaar op de meeste Android-TV's).
2. Ga naar **gibeon.io/install** en kies de Android-download, of voer rechtstreeks de download-URL in:
`https://cdn.gibeon.io/player/android/gibeon-player-latest.apk`
3. Wacht tot `gibeon-player-latest.apk` gedownload is en bevestig de installatie.
### Via een USB-stick
1. Download `gibeon-player-latest.apk` van [gibeon.io/install](/install) op je computer.
2. Kopieer het bestand naar een USB-stick, **FAT32 geformatteerd** (niet exFAT of NTFS).
3. Steek de stick in het toestel, open de bestandsbeheerder en selecteer de APK.
4. Bevestig de installatie.
### Via ADB (gevorderd)
Voor wie Android platform-tools op de laptop heeft:
```bash
adb connect :5555
adb install -r gibeon-player-latest.apk
adb shell am start -n io.gibeon.player/.OnboardingActivity
```
## Stap 3: Openen en activeren
Open de gibeon.io-app. Voer je activatiecode uit de CMS in en koppel het scherm in **Schermen**. Je content verschijnt zodra het scherm gekoppeld is.
## Autostart instellen
Wil je dat de app vanzelf opstart na een herstart? Zie [autostart instellen](/docs/schermen-en-spelers/autostart-google-tv/). Een vergrendelde kiosk regelt de autostart zelf, zie [Kiosk installeren (Device Owner)](/docs/hardware/kiosk-installeren/).
## Developer settings via de afstandsbediening
Zowel de gewone app als de kioskversie hebben een verborgen **developer settings**-scherm dat je opent met de afstandsbediening, zonder laptop of ADB. Handig om ter plaatse de status te lezen, autostart te wijzigen, of een vergrendelde kiosk te ontgrendelen.
Druk binnen 5 seconden deze reeks op de **richtingstoetsen** van de afstandsbediening:
**omhoog, omhoog, omlaag, omlaag, links, rechts, links, rechts.**
Er opent een **Developer settings**-venster in grote letters (leesbaar van op afstand, bijvoorbeeld tijdens een videocall met support) met:
- **Toestel-diagnostiek**: versie, netwerk, sync-status en hardware-info, om voor te lezen aan support.
- **Autostart aan of uit**: bepaalt of de app vanzelf opstart na een herstart.
- **Kiosk ontgrendelen**: alleen op de [kioskversie](/docs/hardware/kiosk-installeren/); haalt de vergrendeling er tijdelijk af zodat je bij de Android-instellingen kan. Op de gewone app valt er niets te ontgrendelen.
- **Sluiten**.
Het venster is een momentopname. Wil je verse waarden na het sluiten, doe dan de reeks opnieuw.
Werkt met een fysieke afstandsbediening of een toetsenbord met richtingstoetsen. Op een aanraakscherm zonder richtingstoetsen is de reeks niet beschikbaar.
## iiyama signage-schermen
iiyama ProLite signage-schermen (de LH-UHSB-serie) hebben een ingebouwde Android, maar geen Play Store. De APK-installatie werkt, met twee bijzonderheden:
- **Android-shell openen:** druk op de afstandsbediening snel achter elkaar `HOME` `1` `6` `6` `8`. Daarna installeer je via USB of ADB zoals hierboven.
- **gibeon.io als opstart-app:** ga naar **Signage Display → Source Settings → Custom App** en kies gibeon.io, en zet **General Settings → Boot on Source** op **Custom App**. Na een herstart start gibeon.io vanzelf.
Een iiyama firmware-update kan sideloaded apps verwijderen. Installeer in dat geval opnieuw via dezelfde stappen.
## Wat als het niet werkt
Controleer dat **Onbekende apps installeren** aanstaat voor de app waarmee je de APK opent (Stap 1). Bij een USB-stick: zorg dat die FAT32 is, niet exFAT of NTFS.
Op toestellen met Play Store updatet de app zichzelf. Een [kioskversie (Device Owner)](/docs/hardware/kiosk-installeren/) updatet zichzelf ook automatisch over de lucht. Alleen een gewone sideload-installatie zonder Play Store update je handmatig: installeer een nieuwe versie opnieuw via deze stappen.
Firmware-updates van het toestel kunnen sideloaded apps verwijderen. Installeer opnieuw via de stappen hierboven.
Technisch wel: Fire OS is gebaseerd op Android, dus de app draait er na een sideload. We ondersteunen het niet actief. Vraag het ons als dit voor jouw setup belangrijk is.
Eerste scherm activeren
---
# Kiosk installeren (Device Owner)
Voor een publiek scherm of een etalage wil je vaak dat het toestel **alleen** de gibeon.io-app toont: geen thuisknop, geen statusbalk, niemand die per ongeluk een andere app opent. Dat is de kioskmodus. Je stelt de **kioskversie** van de app eenmalig in als "Device Owner" via een laptop. Daarna is het scherm vergrendeld, herstelt het zichzelf na een herstart of een hapering, en updatet het zichzelf automatisch over de lucht zonder dat je opnieuw moet installeren.
:::tip[Gewoon de app op een TV die je ook nog anders gebruikt?]
Dan heb je deze pagina niet nodig. Installeer de gewone app via de Play Store, of zonder Play Store via [App installeren via APK](/docs/hardware/apk-installeren/).
:::
## Wat je wint en wat je inlevert
| | Gewone installatie | Kioskmodus (Device Owner) |
| --- | --- | --- |
| Vergrendeld op de app | nee, de thuisknop werkt | ja, geen ontsnapping |
| Statusbalk en instellingen | bereikbaar | geblokkeerd |
| Start na een herstart | meestal, toestelafhankelijk | ja, altijd (wordt de thuisapp) |
| Wekelijkse onderhoudsherstart | nee | ja |
| Toestel ook voor andere apps | ja | nee, enkel gibeon.io |
| Installeren | browser, USB of ADB | ADB op een leeg toestel |
| Weer uitschakelen | app verwijderen | enkel met een fabrieksreset |
Kies de kiosk voor een scherm dat onbeheerd en vast hangt. Voor een TV die je ook nog gewoon gebruikt, kies je de [gewone installatie](/docs/hardware/apk-installeren/).
## Wat je nodig hebt
:::caution[Begin met een leeg toestel]
Android staat Device Owner alleen toe op een toestel **zonder Google-account**. Start vers uit de doos of net na een fabrieksreset, en voeg geen account toe, ook niet tijdelijk. Heb je al ingelogd, of staat de gewone gibeon.io-app er al? Doe dan eerst een [fabrieksreset](#het-toestel-weer-vrijmaken-fabrieksreset) en begin opnieuw.
:::
- Een vers of teruggezet Android-toestel (Android 11 of nieuwer) zonder Google-account
- Android platform-tools (ADB) op een laptop, op hetzelfde netwerk als het toestel
- De **kioskversie** van de app. Let op: dit is een andere download dan de gewone APK.
- Je activatiecode uit de CMS (**Schermen → scherm toevoegen**)
## Stap voor stap
1. Start van een leeg toestel (vers uit de doos of net na een fabrieksreset). Voeg **geen** Google-account toe.
2. Download de kioskversie op je laptop:
`https://cdn.gibeon.io/player/android/gibeon-player-kiosk-latest.apk`
3. Verbind met het toestel en installeer:
```bash
adb connect :5555
adb install -r gibeon-player-kiosk-latest.apk
```
4. Stel de app in als Device Owner:
```bash
adb shell dpm set-device-owner io.gibeon.player.kiosk/io.gibeon.player.AdminReceiver
```
Krijg je hier een foutmelding, dan staat er nog een account op het toestel. Reset eerst en probeer opnieuw.
5. Herstart het toestel met `adb reboot`. De app komt vergrendeld terug, wordt de thuisapp en plant meteen de wekelijkse onderhoudsherstart.
6. Voer op het scherm je activatiecode in en koppel het scherm in **Schermen**.
:::note
De kioskversie heeft een eigen pakketnaam (`io.gibeon.player.kiosk`) en staat los van de gewone app. Allebei op hetzelfde toestel kan, maar de bedoeling is dat je er één kiest.
:::
## Ontgrendelen zonder laptop
Moet je ter plaatse bij de Android-instellingen, dan hoeft daar geen laptop bij. Druk binnen 5 seconden deze reeks op de **richtingstoetsen** van de afstandsbediening:
**omhoog, omhoog, omlaag, omlaag, links, rechts, links, rechts.**
Er opent een **Developer settings**-venster in grote letters. Kies **Kiosk ontgrendelen**: dat haalt de vergrendeling er tijdelijk af zodat je bij de Android-instellingen kan. Hetzelfde venster toont ook toestel-diagnostiek (versie, netwerk, sync-status), om voor te lezen aan support. Alle opties staan beschreven bij [developer settings via de afstandsbediening](/docs/hardware/apk-installeren/#developer-settings-via-de-afstandsbediening).
Werkt met een fysieke afstandsbediening of een toetsenbord met richtingstoetsen. Op een aanraakscherm zonder richtingstoetsen is de reeks niet beschikbaar.
## Het toestel weer vrijmaken (fabrieksreset)
Device Owner kan je niet via de instellingen uitzetten, dat is net de bedoeling van een kiosk. Wil je het toestel weer vrijmaken of opnieuw opzetten, dan is een **fabrieksreset** de enige weg. ADB en de fabrieksreset blijven bewust open op een gibeon.io-kiosk, dus je raakt nooit buitengesloten.
:::caution
Een fabrieksreset wist **alles** op het toestel. Doe dit alleen als je het scherm opnieuw wil opzetten.
:::
Er zijn twee manieren:
- **Via de instellingen**, na [ontgrendelen](#ontgrendelen-zonder-laptop): **Instellingen → Systeem → Reset-opties → Alle gegevens wissen**. Op een Android-TV staat dit onder **Instellingen → Apparaatvoorkeuren → Opnieuw instellen**.
- **Via een laptop**: `adb reboot recovery`, kies dan in het recovery-menu **Wipe data / factory reset**.
Na de reset is het toestel weer leeg. Je kan dan opnieuw de kioskmodus opzetten, of de [gewone app installeren](/docs/hardware/apk-installeren/).
## Wat als het niet werkt
Bijna altijd staat er nog een account op het toestel (van Google of van de fabrikant), of is er al een app met beheerrechten. Doe een fabrieksreset, sla het account-scherm over en begin opnieuw bij stap 1.
Niet zelf. De kiosk updatet zichzelf automatisch over de lucht, zowel de content als de app. Je hoeft nooit opnieuw te installeren.
Ja, zonder laptop: zie [ontgrendelen zonder laptop](#ontgrendelen-zonder-laptop). ADB blijft ook gewoon werken.
Eerste scherm activeren
---
# Samsung Tizen installeren (URL Launcher)
Heb je een Samsung Smart Signage-paneel? Dan draait gibeon.io rechtstreeks op het scherm zelf, zonder kastje of stick. Je wijst de ingebouwde **URL Launcher** één keer naar gibeon.io, en het paneel haalt de speler op en start hem bij elke boot.
:::tip[Een gewone Samsung Smart TV (geen Smart Signage)?]
Deze pagina geldt voor de **commerciële Smart Signage-panelen** (SSSP6 / Tizen 4.0+, bijvoorbeeld de OM- en QB-reeks). Een gewone consumenten-tv heeft geen URL Launcher: gebruik daar de [browser](/players/browser) (open p.gibeon.io) of een [gibeon.io player op Android](/docs/hardware/apk-installeren/) op een stick aan de HDMI-ingang.
:::
## Wat speelt er op je Samsung-scherm
gibeon.io draait als een echte app op het paneel zelf, geen apart kastje en geen browser-tab die open moet blijven. Alles wat je in gibeon.io maakt, speelt ook op je Samsung-scherm:
- **Foto's en afbeeldingen**
- **Templates met live data**, bijvoorbeeld vastgoed uit Whise, Omnicasa of Zabun, of een eigen feed, die automatisch meewijzigen
- **Video** met hardware-versnelling op het paneel
- **Playlists en sequenties** die je in de CMS samenstelt
- **Offline**: na de eerste synchronisatie cachet het paneel je content en blijft het spelen als het netwerk wegvalt
Goed om te weten over de Samsung-hardware: een paneel heeft één videodecoder, dus er speelt **één video tegelijk** (geen twee video's naast elkaar in aparte zones). Voor vlotte weergave gebruik je **H.264 tot 1080p**. Foto's, templates en data hebben die beperking niet.
## Wat heb je nodig
- Een Samsung Smart Signage-paneel met **SSSP6 / Tizen 4.0 of nieuwer**
- Een internetverbinding op het paneel
- Je activatiecode uit de CMS (**Schermen → scherm toevoegen**)
## Stap 1: Klok, tijdzone en scherminstellingen
Doe dit eerst, vóór je de URL Launcher instelt. Het paneel haalt gibeon.io op over een beveiligde `https`-verbinding, en een verkeerde klok breekt die verbinding (het scherm laadt dan niet). De juiste tijd zorgt er ook voor dat geplande en tijdgebonden content op het juiste moment speelt.
1. Open het menu en ga naar **System → Tijd (Time)**.
2. Zet de **klok en datum** goed. Is er een optie voor **automatische tijd (NTP)**, zet die dan aan; anders stel je de tijd handmatig in.
3. Kies de juiste **tijdzone** (voor België: Brussel, GMT+1) en zet de **zomertijd (DST)** aan.
4. Zorg dat het scherm **aan blijft**: ga naar **System → Eco Solution** en zet de automatische uitschakeling uit ("Auto Power Off" en "No Signal Power Off"), samen met de slaaptimer. Een signage-scherm hoort niet vanzelf in stand-by te gaan.
5. Wil je het scherm op vaste uren laten aan- en uitgaan (bijvoorbeeld op winkeluren)? Stel dan de **On/Off-timer** in onder **System → Tijd**.
## Stap 2: De URL Launcher instellen
1. Open op het paneel het menu (Home / Menu op de afstandsbediening).
2. Ga naar **System → Play via** en kies **URL Launcher**. Op sommige modellen heet dit **App Management → Install Custom App**.
3. Open de **URL Launcher-instellingen** en voer als adres in:
`https://cdn.gibeon.io/player/tizen`
Lukt het laden niet met `https`, probeer dan `http://cdn.gibeon.io/player/tizen` (oudere Tizen 4.0-panelen). Laadt het paneel de app helemaal niet, voeg dan een schuine streep toe op het einde: `https://cdn.gibeon.io/player/tizen/`. Tizen vraagt die soms zonder dat het paneel dat aangeeft.
4. Sla op en **herstart** het paneel. Het downloadt gibeon.io en start het automatisch bij elke boot.
:::note[Geen netwerk bij het instellen?]
Je kan gibeon.io ook van USB installeren. Maak op een USB-stick een map **SSSP** en zet daarin twee bestanden: `https://cdn.gibeon.io/player/tizen/gibeon-player.wgt` en `https://cdn.gibeon.io/player/tizen/sssp_config.xml`. Kies dan op het paneel **Install from USB Device**. Voor het activeren en het ophalen van content heeft het scherm nadien wel internet nodig.
:::
## Stap 3: Het scherm activeren
Na de herstart toont het paneel een **4-karakter activatiecode**. Geef die in op **app.gibeon.io** (Schermen → scherm toevoegen) en koppel het scherm. Je content verschijnt zodra het scherm gekoppeld is. Er is geen login op het paneel zelf: je koppelt het scherm vanuit de CMS, niet door op het scherm in te loggen.
## Niets per scherm registreren
Je hoeft bij Samsung niets aan te vragen of te registreren: geen DUID, geen ontwikkelaarscertificaat, geen MagicINFO-server en geen contract met Samsung. Elk paneel wijst gewoon naar dezelfde URL. Of je nu één scherm hebt of vierhonderd, de stappen zijn identiek en er is geen installatie per toestel.
## Updates en autostart
- **Autostart** is automatisch: zolang de URL Launcher de opstartbron is, start gibeon.io bij elke boot. Meer over autostart, de stroominstellingen en het herstart-gedrag: [autostart op Samsung-signage](/docs/schermen-en-spelers/autostart-samsung-tizen/).
- **Updates** komen vanzelf: bij een nieuwe versie haalt het paneel ze op via de URL Launcher en installeert ze op de achtergrond. Je content blijft spelen en je koppeling blijft behouden.
## Wat als het niet werkt
Samsung Smart Signage-panelen met SSSP6 / Tizen 4.0 of nieuwer (bijvoorbeeld de OM- en QB-reeks). Een gewone consumenten-Smart-TV heeft geen URL Launcher, gebruik daar de browser of een Android-speler aan de HDMI-ingang.
Controleer de internetverbinding en de datum/tijd van het paneel (zet de klok op automatisch). Werkt `https` niet, probeer dan `http://cdn.gibeon.io/player/tizen`. Zorg dat de opstartbron op **URL Launcher** staat en herstart het paneel.
Zet de automatische uitschakeling uit onder **System → Eco Solution** ("Auto Power Off" en "No Signal Power Off") en schakel de slaaptimer uit. Wil je het scherm net op vaste uren laten aan- en uitgaan, gebruik dan de On/Off-timer onder **System → Tijd**.
Zet de klok, tijdzone en zomertijd (DST) goed onder **System → Tijd** (zet automatische tijd / NTP aan als die optie er is). Een verkeerde klok breekt ook de beveiligde verbinding waarmee het paneel gibeon.io ophaalt.
Ja. Na de eerste synchronisatie cachet het paneel je beelden, templates en video, en blijft het afspelen als het netwerk even wegvalt. De eerste activatie heeft wel internet nodig.
Ja, video speelt met hardware-versnelling op het paneel zelf. Voor een vlotte werking gebruik je H.264 tot 1080p.
Nee. Een Samsung-paneel heeft één videodecoder, dus er speelt één video tegelijk. Foto's, templates en data combineer je wel in zones. Dit is een beperking van de Samsung-hardware, niet van gibeon.io.
Nee. Geen DUID, geen ontwikkelaarscertificaat, geen MagicINFO-server en geen contract met Samsung. Je wijst elk paneel gewoon naar hetzelfde URL Launcher-adres, of dat er nu één is of vierhonderd.
Eerste scherm activeren
---
# Inhoud beheren
Een playlist is een rij content die na elkaar afspeelt. Een schema bepaalt wanneer welke playlist draait. Een sequentie speelt meerdere playlists na elkaar af.
## Blok-types in een playlist
Per item in een playlist kies je een blok-type. Per type een eigen artikel:
- [Afbeelding](/docs/inhoud-beheren/blokken/afbeelding)
- [Video](/docs/inhoud-beheren/blokken/video)
- [YouTube](/docs/inhoud-beheren/blokken/youtube)
- [Studio (data)](/docs/inhoud-beheren/blokken/studio-data)
- [Image-slideshow](/docs/inhoud-beheren/blokken/image-slideshow)
- [Weer](/docs/inhoud-beheren/blokken/weer)
---
# Afbeelding
Een afbeelding-blok toont één foto of grafiek op het scherm gedurende een ingestelde duur. Het ondersteunt veelgebruikte formaten (JPG, PNG, WebP) en past de afbeelding aan het schermformaat aan via de schaal-instelling.
Wanneer de duur verstreken is, gaat de playlist door naar het volgende blok.
:::note
Binnenkort uitgebreid met voorbeelden, schaal-tips en aanbevolen resoluties.
:::
---
# Image Slideshow
Een Image Slideshow-blok bundelt meerdere afbeeldingen in één playlist-item. Elke afbeelding krijgt dezelfde duur en je kan kiezen tussen volgorde-afspelen of willekeurig.
Handig voor fotoreeksen van eenzelfde onderwerp zonder dat je elke foto als apart playlist-item moet toevoegen.
:::note
Binnenkort uitgebreid met voorbeelden, overgangstypes en tips voor lange reeksen.
:::
---
# Studio (data)
Een Studio-blok toont items uit een databron (bijvoorbeeld panden uit Whise, producten uit een catalogus of evenementen uit een agenda) gerenderd via een template. De data wordt periodiek opgehaald, zodat het scherm automatisch up-to-date blijft.
Combineer een databron met een template om dezelfde lay-out toe te passen op elk item in de feed.
:::note
Binnenkort uitgebreid met de stappen voor databron koppelen, template kiezen, en filteren/sorteren.
:::
---
# Video
Een video-blok speelt een video automatisch af op het scherm. De duur van het blok komt overeen met de lengte van de video, tenzij je expliciet een andere duur opgeeft.
Video's worden door gibeon.io getranscodeerd zodat ze op alle ondersteunde schermen vlot afspelen.
:::note
Binnenkort uitgebreid met aanbevolen codecs, resoluties en tips voor lange video's.
:::
---
# Weer
Een Weer-blok toont actueel weer voor een gekozen locatie: huidige temperatuur, weertype en een uurvoorspelling. De data komt van [Met.no](https://met.no) en wordt automatisch ververst.
Voor het uitgebreide configuratie-overzicht (locatie kiezen, taal, weergavetype): zie [Weer-widget](../weer-widget.md).
:::note
Binnenkort uitgebreid met voorbeelden per scherm-formaat en tips voor meertalige locaties.
:::
---
# YouTube
Een YouTube-blok toont een YouTube-video op het scherm. Plak de YouTube-URL en stel de duur in. Geluid en autoplay-gedrag volgen de regels van YouTube zelf.
Handig voor instructievideo's of trailers waarbij je geen eigen video wil uploaden.
:::note
Binnenkort uitgebreid met tips voor playlist-URL's, autoplay, en omgaan met YouTube-restricties.
:::
---
# Playlists
Een playlist is een geordende lijst van content-items die na elkaar afspeelt en daarna opnieuw begint. Het is de meest gebruikte manier om content op een scherm te krijgen.
## Een playlist maken
1. Ga in de CMS naar **Playlists** en klik op **Nieuwe playlist**.
2. Geef de playlist een naam. Voorbeelden: `Etalage avond`, `Receptie ontvangst`, `Lunch-aanbiedingen`.
3. Klik op **Aanmaken en content toevoegen**. Je belandt in de playlist-editor.
## Content toevoegen
In de editor kies je per item een blok-type:
- **Afbeelding**: een afbeelding vanuit je computer. [Meer](/docs/inhoud-beheren/blokken/afbeelding).
- **Video**: een video die automatisch wordt getranscodeerd voor vlot streamen. [Meer](/docs/inhoud-beheren/blokken/video).
- **YouTube**: een YouTube-video via URL. [Meer](/docs/inhoud-beheren/blokken/youtube).
- **Studio (data)**: een template gevuld met data uit een integratie (bijvoorbeeld een pand uit Whise). [Meer](/docs/inhoud-beheren/blokken/studio-data).
- **Image-slideshow**: meerdere afbeeldingen in één blok. [Meer](/docs/inhoud-beheren/blokken/image-slideshow).
- **Weer**: actuele temperatuur en voorspelling voor een gekozen locatie. [Meer](/docs/inhoud-beheren/blokken/weer).
Per item stel je een **duur** in (in seconden). Wanneer de playlist actief is, doorloopt de speler de items in volgorde en herstart aan het einde.
## Een playlist aan een scherm koppelen
Drie manieren:
1. **Bij activatie van een nieuw scherm**: kies de playlist in stap 3 van de wizard.
2. **Vanuit de scherm-detailpagina**: klik op **Content kiezen** en selecteer een playlist.
3. **Vanuit de playlist**: open de playlist en klik op **Naar schermen sturen**.
Eén playlist kan op meerdere schermen tegelijk draaien. Wijzig je de playlist, dan krijgen alle gekoppelde schermen automatisch de update.
## Wanneer kies je geen playlist
- **Verschillende content op verschillende tijden**: gebruik een [schema](/docs/inhoud-beheren/schedules-en-sequences) dat meerdere playlists rouleert.
- **Lange content-rotatie**: combineer playlists in een [sequentie](/docs/inhoud-beheren/schedules-en-sequences).
- **Eén pand groter, ander kleiner op hetzelfde scherm**: gebruik [zones](/docs/schermen-en-spelers/zones-en-layouts).
## Wat als het niet werkt
Open de playlist, klik op het item en bekijk de preview. Als die ook leeg is, ontbreekt de bron. Herupload het bestand of corrigeer de externe URL. Bij templates: controleer of het gekoppelde data-item nog bestaat in de integratie.
Bij videos volgt gibeon.io standaard de werkelijke videolengte. Wil je hem korter knippen, zet de duur dan onder de videolengte; langer dan de videolengte herhaalt de video tot de duur op is.
De ingestelde duur geldt per item uit je databron. Toont je blok bijvoorbeeld 22 panden met 10 seconden per item, dan duurt het blok 220 seconden. Wil je de playlist korter, verlaag dan de duur per item of beperk het aantal via **Maximum items** in de blok-instellingen.
Heb je expliciet op **Publiceren** geklikt? Wijzigingen in de CMS gaan pas live na een publish-actie. Online schermen pikken een nieuwe publicatie binnen een minuut op. Duurt het langer, controleer dan of de speler nog online is.
Wanneer wat tonen: schema's en sequenties
---
# Wijzigingen publiceren
Een wijziging die je in de CMS bewaart is meteen opgeslagen, maar nog niet zichtbaar op de schermen. Pas zodra je op **Publiceren** klikt, krijgt de speler een nieuwe versie van de content.
## Waarom een aparte publicatie-stap
Tijdens het bewerken wil je controleren hoe je playlist eruitziet zonder dat de speler bij elke tussenstap mee springt. De publicatie-stap maakt het verschil tussen "ik ben aan het bewerken" en "dit mag op het scherm staan".
Bij publicatie maakt de CMS een momentopname van alles wat het scherm nodig heeft: de gekoppelde playlist of sequentie, de mediabestanden, de templates en de configuratie. De speler haalt deze momentopname op en speelt eruit af. Tot je een nieuwe versie publiceert, blijft de oude actief.
## Wanneer publiceren
Publicatie geldt per scherm. Pas je een playlist aan die op vijf schermen draait, dan moeten alle vijf opnieuw publiceren. In de praktijk hoef je dit niet één voor één te doen. De CMS toont op drie plekken waar er wijzigingen openstaan:
- **Op de playlist-, sequentie- of schema-editor** verschijnt een banner: "Wijzigingen aan dit item staan klaar voor X schermen". Eén klik publiceert ze allemaal.
- **Op het scherm zelf** (in **Schermen → [scherm openen]**) staat dezelfde banner, alleen voor dat ene scherm.
- **Bovenaan in de CMS** verschijnt een **Publiceer X schermen**-knop zodra er ergens wijzigingen openstaan. Eén klik publiceert alle hangende schermen in je workspace.
## Automatische publicatie
In twee gevallen publiceert de CMS zonder dat je iets hoeft te doen:
- Bij het [activeren van een nieuw scherm](/docs/aan-de-slag/eerste-scherm-activeren) wordt de gekozen content automatisch live gezet.
- Wanneer een data-koppeling automatisch ververst (bijvoorbeeld nieuwe panden vanuit je CRM), publiceert de CMS de nieuwe data zonder tussenkomst.
## Status van een scherm
In de schermen-lijst staat naast elk scherm een status:
- **Up to date**: de speler draait op de meest recente publicatie.
- **Wijzigingen**: er staan wijzigingen klaar die nog niet gepubliceerd zijn.
- **Nooit gepubliceerd**: het scherm is geactiveerd maar er is nog niets naar gepubliceerd.
- **Publiceren...**: publicatie loopt.
- **Mislukt**: de laatste publicatie is mislukt. Klik **Opnieuw** om te hertesten.
## Wat als het niet werkt
Online schermen pikken een nieuwe publicatie binnen een minuut op. Blijft het scherm op de oude versie na enkele minuten, dan staat het waarschijnlijk offline (controleer de heartbeat in de schermen-lijst). Het pikt de wijziging dan op zodra het weer online komt.
De banner toont **Publiceren mislukt** met een **Opnieuw proberen**-knop. De meeste fouten zijn netwerk-glitches die bij een tweede poging slagen. Houdt de fout aan, mail [support@gibeon.io](mailto:support@gibeon.io) met de scherm-naam.
Niet via de UI. Bij een verkeerde publicatie: pas de content aan en publiceer opnieuw. De speler haalt de nieuwste versie op en de oude verdwijnt.
Dit gebeurt wanneer een scherm content probeert op te halen die nog nooit gepubliceerd is. Open het scherm in de CMS, koppel content en klik op Publiceren.
Playlists maken en beheren
---
# Schema's en sequenties
Een playlist roteert content. Een schema bepaalt **wanneer** welke playlist draait. Een sequentie speelt **meerdere playlists na elkaar** af, in een vaste volgorde.
## Wanneer welk concept
| Wat je wil | Gebruik |
|-----------|---------|
| Eén lijst content die loopt | Playlist |
| Verschillende content op verschillende tijden of dagen | Schema |
| Lange rotatie zonder tijdslot, meerdere playlists na elkaar | Sequentie |
## Een schema maken
1. Ga naar **Schema's** en klik op **Nieuw schema**.
2. Geef het schema een naam.
3. Voeg blokken toe in de tijdlijn: sleep een playlist op een dag en uur.
4. Stel een fallback in: wat speelt er buiten geplande blokken? Meestal "speel de gekoppelde playlist".
5. Koppel het schema aan een scherm via **Scherm-detail → Content kiezen**.
**Voorbeeld:** Een café:
- 06:00 - 11:00 → Playlist `Ontbijt`
- 11:00 - 16:00 → Playlist `Lunch`
- 16:00 - sluit → Playlist `Avond`
Buiten openingsuren toont de speler de fallback-playlist.
## Een sequentie maken
1. Ga naar **Sequenties** en klik op **Nieuwe sequentie**.
2. Geef de sequentie een naam.
3. Voeg playlists toe in de gewenste volgorde.
4. Koppel de sequentie aan een scherm.
De speler doorloopt de eerste playlist volledig, dan de tweede, enzovoort. Aan het einde begint de sequentie opnieuw.
**Voorbeeld:** Een vastgoedmakelaar:
1. Playlist `Nieuwe panden deze week`
2. Playlist `Topselectie`
3. Playlist `Diensten en team`
## Prioriteit bij overlappingen
Schema's hebben voorrang op sequenties en losse playlists die direct aan een scherm zijn gekoppeld. Heb je dus een schema gekoppeld én een fallback-playlist gekoppeld, dan speelt het schema waar het kan en valt de speler terug op de playlist op niet-geplande momenten.
## Wat als het niet werkt
Controleer dat de tijdsblokken niet overlappen. Bij een conflict draait alleen het eerste blok. De editor markeert overlappingen rood.
Bekijk de duur van de eerste playlist. Een sequentie wacht tot een playlist volledig is afgespeeld voor ze doorgaat. Een playlist met één lange video van 20 minuten "blokkeert" de sequentie tot die video klaar is.
Controleer of het schema aan het scherm gekoppeld is (Scherm-detail → Content). Veel mensen maken het schema en vergeten de koppeling.
Een scherm verdelen in zones
---
# Weer-widget
De weer-widget toont de huidige temperatuur, een weersconditie-icoon en de naam van een locatie naar keuze. Handig voor retail-vitrines, horeca-menubord, of een ontvangstscherm in een kantoor. Een snelle visuele check voor wie binnenkomt.
## Een weer-widget toevoegen
1. Open een playlist in de editor.
2. Klik op het **Weer**-blok in het zijbalkje of sleep het naar de gewenste positie.
3. Typ een stad in het zoekveld, bijvoorbeeld `Gent`, `Antwerpen`, of `Brussel`. Klik op **Zoeken**.
4. Controleer de resolved locatie in het kaartje (we tonen het volledige adres dat we van OpenStreetMap kregen).
5. Kies de eenheden (°C of °F) en de taal (Nederlands, Engels of Frans).
6. Stel de **tijd op scherm** in (standaard 10 seconden).
7. Klik op **Toevoegen aan playlist**.
De widget verschijnt onmiddellijk in de playlist met het label van de gekozen stad. Op publish ziet de speler de juiste temperatuur en conditie binnen 10 seconden.
## Hoe blijft de data fris
Drie lagen werken samen zodat het scherm nooit een leeg of verouderd weer-blok toont:
1. **Achtergrond-refresh elk uur.** Wij halen elk uur de nieuwste data op bij [Met.no](https://api.met.no/), de nationale Noorse meteo-dienst. Eén refresh per uur, gedeeld over alle klanten met een widget in dezelfde grid van ongeveer 11×11 km.
2. **Bij elke publish.** Op het moment dat je op **Publiceren** klikt, embedden we de huidige weersdata in de snapshot van het scherm. Een offline speler blijft dus tonen wat hij bij de laatste publish ontvangen heeft.
3. **Online speler ververst zelf.** Een speler met internet pollt elk uur opnieuw onze cache en vervangt het beeld in het geheugen. Geen herpublish nodig.
Als alle drie tegelijk falen (Met.no plat én jouw speler plat én geen recente publish), blijft de speler tonen wat hij voor het laatst zag. Hij gaat nooit zwart of toont een foutmelding op het scherm.
## Een weer-widget aanpassen
Klik op een bestaande weer-widget in de playlist (of op het driepuntsmenu rechts → **Bewerken**). Dezelfde modal opent met de huidige instellingen voorgevuld:
- **Andere stad?** Typ een nieuwe naam, klik op zoeken, opslaan.
- **Andere eenheid of taal?** Pas aan en klik op opslaan. Geen herpublish nodig: het wijzigt op de eerstvolgende refresh op de speler (uiterlijk binnen een uur).
- **Andere tijd op scherm?** Pas de duur aan.
## Wat als het niet werkt
De zoekfunctie gebruikt OpenStreetMap. Werkt een stadsnaam niet, probeer dan een grotere stad in de buurt, of voeg het land toe (`Sint-Niklaas, België`).
Wij ronden de locatie af op ongeveer 11 km voor cache-efficiëntie. Voor een stad als Brussel of Gent zit je daarmee altijd binnen het stadsgebied, maar in een ruraal gebied kan dat soms een paar graden afwijken van wat je telefoon toont. De data zelf komt van Met.no en wordt elk uur ververst.
Dit gebeurt enkel vóór de eerste publish na het toevoegen van de widget. Klik op **Publiceren**: binnen 10 seconden vervangt de speler de skeleton door echte data.
Ja. Eén widget per locatie. Voor een keten met vestigingen in Gent, Antwerpen en Brussel maak je gewoon drie aparte widgets aan en zet je ze in dezelfde of verschillende playlists. Wij delen automatisch de meteo-cache tussen widgets die in dezelfde grid (~11 km) vallen.
## Achtergrondinfo
- **Bron**: [Met.no, Norwegian Meteorological Institute](https://api.met.no/). Gratis, commercieel toegelaten weerdienst gerund door de Noorse overheid. Wereldwijde dekking.
- **Geocoding**: [Nominatim](https://nominatim.openstreetmap.org/) (OpenStreetMap). Eénmalig opgezocht bij opslaan, daarna niet meer.
- **Iconen**: Een eigen set SVG-iconen die met elke browser en elke schermgrootte schaalt. Er wordt geen externe icon-CDN aangesproken vanaf het scherm.
---
# Instellingen
Beheer je werkruimte: proof of play, audit-logs en wie toegang heeft tot wat. Kies in de zijbalk een onderwerp.
---
# Audit log
Het audit log toont wie wat heeft gedaan in jouw werkruimte. Beschikbaar op het **Pro**- en **Business**-plan voor gebruikers met rol **admin** of **owner**.
## Wat zie je
Een lijst van gebeurtenissen met:
- **Wanneer** het is gebeurd (relatieve datum, klik voor de exacte tijd)
- **Wie** het heeft gedaan (e-mailadres, of "Systeem" voor automatische acties)
- **Welke actie** (bv. `device_renamed`, `playlist_published`, `asset_deleted`)
- **Type** en **entity ID** van het onderwerp
- **Details** in een uitklap-paneel (oude waarde, nieuwe waarde, etc.)
## Welke acties worden gelogd
| Categorie | Acties |
|-----------|--------|
| Schermen | aangemaakt, hernoemd, verwijderd |
| Playlists | aangemaakt, hernoemd, verwijderd, gepubliceerd |
| Content-items | toegevoegd, gewijzigd, verwijderd |
| Assets | geüpload, hernoemd, verplaatst, verwijderd |
| Data-bronnen | gekoppeld, ontkoppeld, automatisch ververst |
| Gebruikers | uitgenodigd, toegevoegd, rol gewijzigd, verwijderd |
| Tenants | aangemaakt, instellingen gewijzigd |
| Facturatie | abonnement-events vanuit het betaalsysteem |
## Filteren
Bovenaan de pagina kies je een datumbereik, actie-type, of entity-type. De lijst wordt server-side gefilterd.
## Exporteren naar CSV
Klik **Download CSV** rechtsboven. Het bestand bevat de huidige filter-selectie tot maximaal 10.000 rijen, met UTF-8 BOM zodat Excel accenten correct toont. Voor grotere exports verfijn je het datumbereik en download je meerdere keren.
## Wat staat er NIET in
- De export-actie zelf (anders krijg je een audit-rij voor elke download)
- Pure metadata-bumps (bv. wanneer een script alleen `updated_at` op een asset wijzigt zonder echte verandering)
## Privacy
E-mailadressen van uitgenodigde gebruikers staan in de `details`-kolom. Alleen admins en owners van jouw werkruimte zien deze data. Resellers en superadmins van gibeon.io zien ze ook (voor support).
## Retentie
Audit-events worden voor onbeperkte tijd bewaard. Wanneer een tenant een grote hoeveelheid events bereikt, kan dit beleid wijzigen. We laten je dat vooraf weten.
---
# Proof of Play
Met Proof of Play kun je zien welke inhoud op welk scherm gespeeld werd, en
wanneer. Beschikbaar op Pro en Business.
## Waar vind ik het?
Settings → Proof of Play.
## Wat zie ik?
Een lijst van afgespeelde content-items. Per item:
- Tijdstip
- Toestel
- Naam van de inhoud (of "(verwijderd)" als de inhoud is verwijderd)
- Type
- Gemeten speeltijd
Filteren kan op toestel, periode (24u / 7d / 30d) en type.
## CSV-export
Klik op "Download CSV". De export bevat alle rijen die matchen met de
huidige filters, niet alleen de zichtbare pagina. Maximum 50.000 rijen per
export.
## Beperkingen in deze versie
We zijn open over wat MVP wel en niet doet:
- **Bewaartermijn 30 dagen.** Oudere events worden automatisch verwijderd.
- **Native video toont geplande duur, niet gemeten.** Voor video die buiten
de webview wordt afgespeeld op de gibeon.io player kiosk-box meten we
momenteel de geplande duur (uit de playlist), niet de werkelijke
speeltijd. Een follow-up verandert dit naar gemeten duur.
- **Offline-periodes worden niet apart aangeduid.** Als een toestel een
paar uur of dagen offline was, zie je een gat in het rapport. Dat gat
ziet er hetzelfde uit als "het scherm draaide maar speelde niets". Een
volgende versie markeert die gaten expliciet.
- **CSV-only.** Geen PDF-rapport met digitale handtekening. Voor
advertentie-billing met juridische bewijswaarde is dit (nog) niet
geschikt.
- **Tot ~3 weken offline-buffer per toestel.** Een toestel dat langer dan
~3 weken offline staat en blijft afspelen, verliest de oudste events.
---
# Support en contact
Loop je vast, mis je een feature of werkt iets niet zoals het hoort? Ons team helpt je via één e-mailadres.
## Hoe bereik je ons
Stuur een mail naar **[support@gibeon.io](mailto:support@gibeon.io)** met je vraag.
Voor sales-vragen (offertes, demo's, bulk-orders): **[hello@gibeon.io](mailto:hello@gibeon.io)**.
## Wat meegeven
Hoe meer context, hoe sneller we kunnen helpen.
Voor een technisch probleem:
- Welke pagina of welk scherm betreft het
- Wat je verwachtte en wat er gebeurde
- Wanneer het probleem startte
- Een screenshot of het exacte tijdstip van een storing als je dat hebt
Voor een feature-vraag:
- Wat je probeert te doen
- Waarom de huidige oplossing niet volstaat
- Of het urgent is voor een specifieke deadline
## Antwoordtijd
We antwoorden binnen één werkdag (Belgische werktijden, maandag tot vrijdag, 9u-17u). Voor productie-incidenten met meerdere offline schermen pakken we het sneller op. Vermeld dat duidelijk in je mail.
## Eerst zelf zoeken
Veel vragen staan al beantwoord in dit helpcenter:
- **[Aan de slag](/docs/aan-de-slag/)**: eerste scherm activeren, account opzetten
- **[Probleemoplossing](/docs/probleemoplossing/)**: scherm offline, video stottert, code werkt niet
- **[Data-integraties](/docs/data-integraties/)**: Whise, Omnicasa, Zabun, Skarabee koppelen
- **[Facturatie](/docs/facturatie/)**: facturen, plan-wijzigingen, add-ons
De zoekbalk bovenaan vindt artikels op trefwoord of zinsdeel.
---
# Probleemoplossing
Een scherm dat zwart blijft of data die niet vernieuwt: er is meestal één duidelijke reden. Onderstaande artikels lopen de checks af in de juiste volgorde.
---
# Activatiecode werkt niet
Je typt de code over van het scherm in de CMS en krijgt **Ongeldige of verlopen code**. Drie oorzaken.
## 1. Code is verlopen
Activatiecodes vervallen automatisch na enkele minuten. Toonde de speler de code een tijdje geleden? Dan is hij waarschijnlijk vervangen.
**Oplossing**: laat de speler een nieuwe code genereren. Twee manieren:
- **Reboot de speler** (stekker eruit, wachten, terug erin). Bij het opstarten verschijnt een nieuwe code.
- **Wacht.** Sommige spelers genereren elke paar minuten een nieuwe code zonder reboot. Kijk gewoon naar het scherm.
## 2. Code typo
Activatiecodes gebruiken hoofdletters en cijfers. De cijfer `0` (nul) lijkt op letter `O`, en `1` lijkt op `I` of `l`.
**Oplossing**: kijk goed naar de code. Het CMS-veld accepteert alleen geldige tekens, dus typ je `O` waar `0` moet staan, dan vindt het systeem geen match.
## 3. Code hoort bij een andere tenant
Als jij meerdere tenants hebt of als je een speler probeert te koppelen die al aan iemand anders zijn account hangt, krijg je deze fout.
**Oplossing**: controleer of je in de juiste tenant zit (rechtsboven in de CMS). Hoort de speler aan iemand anders, koppel hem dan eerst los aan die kant.
## Wat als het blijft mislukken
Dit is geen code-probleem maar een content-probleem. De koppeling is gelukt, maar er hangt geen content aan. Open de scherm-detailpagina en koppel een playlist.
De speler heeft geen internet. Zie [speler offline](/docs/probleemoplossing/speler-offline) voor de wifi-checklist.
Verwijder het scherm in de CMS via **Schermen → ⋯ → Verwijderen**. De code op de oude speler werkt dan niet meer; bij re-koppeling start je opnieuw met een nieuwe activatiecode.
De volledige activatie-flow
---
# Beeldverhouding klopt niet
Een uitgerekt logo, een afbeelding met zwarte balken eromheen, of content die op zijn kant gedraaid op het scherm landt. Drie typische oorzaken.
## 1. Scherm hangt portrait, content is landscape
Het scherm hangt rechtop maar de template, afbeelding of video is gemaakt voor een landscape-scherm. De content past niet.
**Oplossing**: kies een template gemarkeerd als **portrait** of **beide**. In de templates-bibliotheek staat per template welke oriëntaties ondersteund zijn.
Voor losse afbeeldingen: upload een variant in de juiste oriëntatie (1080×1920 voor portrait, 1920×1080 voor landscape).
## 2. Mismatch tussen content-formaat en zone
Een 16:9-video in een 4:3-zone krijgt zwarte balken. Een vierkante afbeelding in een brede zone wordt links en rechts opgevuld met achtergrondkleur.
**Oplossing**: stem de zone-verhouding af op je content, of verander de **fit-instelling** van het content-item:
- **Scale to fill**: vult de zone volledig, kropt eventueel
- **Fit and center**: toont volledige content, eventueel met balken
Beide hebben een use-case: voor een logo wil je vaak `fit and center` (geen kropping), voor een sfeerbeeld vaak `scale to fill` (geen lege ruimte).
## 3. Oriëntatie staat verkeerd ingesteld
Een scherm hangt staand maar toont liggende content (of omgekeerd), of de content landt op zijn kant.
**Oplossing**: zet de oriëntatie in gibeon.io zelf, per scherm: **Schermen → kies het scherm → Oriëntatie**. Kies **liggend**, **staand**, of **staand omgekeerd** als het scherm de andere kant op hangt. De wijziging is binnen enkele seconden op het scherm zichtbaar, publiceren is niet nodig. Stel de oriëntatie altijd in gibeon.io in, niet in het systeemmenu van het toestel zelf, dan blijft er maar één laag die draait.
## 4. Een extern scherm draait het beeld een tweede keer
Draait gibeon.io op een box die via HDMI op een TV of monitor hangt, en heeft dat scherm zijn eigen portrait- of rotatie-stand? Dan kan het scherm het al-correcte beeld nóg een keer draaien en uitrekken. Het beeld komt vervormd op het paneel.
**Oplossing**: laat gibeon.io de rotatie doen (oriëntatie in gibeon.io, zie hierboven) en zet het externe scherm op zijn **liggende bron** met beeldmodus **"Just Scan" of "1:1"** (geen overscan, geen "Fill" of "Stretch"). Eén laag mag draaien, niet twee. Wil je de menu's van het scherm wél gedraaid zien? Gebruik dan de aparte menu-oriëntatie van dat scherm en laat de **bron**-oriëntatie op liggend.
## Veelvoorkomende vragen
Dat is geen beeldverhouding-probleem maar een resolutie-probleem. De speler verkleint of vergroot je content naar de werkelijke schermresolutie. Lever 4K-content alleen als het scherm ook 4K is. Anders volstaat 1080p en houd je upload-tijd kort.
Templates schalen op basis van de zone-grootte. Een split-screen-template op een 4K-scherm en op een 1080p-scherm tonen beide alle content, maar de pixel-grootte van de tekst verschilt. Dat is verwacht gedrag. Gebruik `vw`-units in custom CSS om relatief te schalen.
Zones en layouts
---
# Data niet up-to-date
Je verandert iets in Whise of Omnicasa, maar het scherm toont nog de oude versie. Vier oorzaken in volgorde van frequentie.
## Wachten op de sync
gibeon.io haalt data op uit je integratie volgens een vast interval:
| Integratie | Sync-frequentie |
|------------|-----------------|
| Whise | elke 15 minuten |
| Omnicasa | elke 15 minuten |
| Zabun | elke 15 minuten |
Wijzigingen in je CRM komen dus binnen ~15 minuten op het scherm. Nu meteen zien? Forceer een handmatige sync (volgende stap).
## Een handmatige sync starten
1. Ga naar **Integraties** in de CMS.
2. Klik op je integratie (bijvoorbeeld Whise).
3. Klik **Nu synchroniseren**.
4. De knop verandert in **Bezig met synchroniseren** en wisselt na enkele seconden tot enkele minuten naar **Voltooid**.
## Verlopen credentials
Als de integratie al een tijd niet meer succesvol synchroniseert, zijn je inloggegevens vermoedelijk verlopen of geblokkeerd. Symptomen:
- Op de integratie-pagina staat **Sync fout** of **Verbinding mislukt**
- Het aantal panden in de integratie staat al dagen vastgepind
Oplossing:
1. Open de integratie-pagina.
2. Klik op **Verbinding herstellen** of **Inloggegevens wijzigen**.
3. Voer de actuele credentials opnieuw in.
4. Test de verbinding.
## Speler-cache
De speler bewaart content lokaal voor offline-werking. Tussen het moment van een succesvolle sync en het moment dat het scherm de nieuwe versie toont, kan tot ~30 seconden verlopen. Dat is normaal.
Duurt het langer dan een paar minuten:
1. Controleer of de speler online is in de CMS.
2. Forceer een herstart van de speler via **Scherm-detail → ⋯ → Herstart speler**. Bij het herstarten haalt de speler verse content op.
## Wat als het niet werkt
Het pand staat misschien als "inactief" of "verkocht" gemarkeerd in je CRM. gibeon.io haalt standaard alleen actieve panden op. Wijzig de status in je CRM en wacht op de volgende sync.
Foto's worden gecached op onze CDN. Bij sync vergelijken we de bestandsnamen: een foto met dezelfde naam wordt niet opnieuw gedownload. Vraag je makelaarssoftware om foto's onder een nieuwe bestandsnaam te uploaden, of laat het ons weten en we forceren een full refresh.
Dit duurt maximaal één sync-cyclus + ~30 seconden cache. Klopt het dan nog niet, kijk dan op de pand-detail in de CMS welke prijs daar geregistreerd staat. Als die ook verkeerd is, ligt het probleem in de integratie of in je CRM.
Whise-koppeling configureren
---
# Scherm toont niets
Een zwart scherm, een eeuwig wachtbeeld of een bevroren beeld. In bijna alle gevallen is het één van vijf oorzaken. Loop ze af in volgorde, te beginnen bij de meest waarschijnlijke.
## Stap 1: is de speler online
Open de CMS en ga naar **Schermen**. Elk scherm heeft een statusindicator:
- **Online**: de speler stuurt elke 30 seconden een heartbeat. Probleem ligt elders.
- **Offline**: de speler heeft al meer dan een paar minuten geen contact gemaakt. Ga door naar stap 2.
## Stap 2: heeft de speler internet
Geen heartbeat = geen internet, of de speler is uit. Check ter plaatse:
1. Heeft het scherm stroom en is het aan?
2. Hangt de wifi nog op het toestel? Schakel kort over naar een ander toestel met dezelfde wifi om te valideren.
3. Bij bekabeld: zit de ethernetkabel goed?
## Stap 3: is er content gekoppeld
Is de speler online maar toont hij geen content?
1. Open in de CMS de scherm-detailpagina.
2. Kijk naar het **Content**-veld. Staat hier "Geen playlist"? Klik op **Content kiezen** en selecteer er één.
3. Heb je een schema gekoppeld zonder fallback? Buiten de geplande blokken toont de speler dan niets. Voeg een fallback-playlist toe.
## Stap 4: firewall blokkeert verbindingen
In bedrijfsnetwerken houdt soms een firewall de speler tegen. Open uitgaand:
- **TCP 443 (HTTPS)** naar `*.gibeon.io` en `*.bunnycdn.com`
- **WebSocket 443 (WSS)** naar `api.gibeon.io`
Bij gebruik van een captive portal (hotelnetwerk, gastenwifi): de speler kan zich niet authenticeren. Verbind de speler met een netwerk zonder portaalpagina.
## Stap 5: herstart de speler
Wanneer alles op orde lijkt en het scherm blijft hangen:
- **Vanuit de CMS:** open het scherm en klik **⋯ → Herstart speler**. De speler reboot binnen 30 seconden.
- **Handmatig:** trek de stekker uit, wacht 10 seconden, steek terug in.
Een herstart lost ~80% van de hangende-content-problemen op.
## Wanneer support contacteren
Stappen 1-5 doorlopen zonder succes? Stuur een mail naar [support@gibeon.io](mailto:support@gibeon.io) met:
- De naam van het scherm zoals in de CMS
- Een foto van wat het scherm toont
- Sinds wanneer het probleem speelt
We kijken in de logs en koppelen meestal binnen één werkdag terug.
Volgende: data niet up-to-date
---
# Speler herstarten
Een herstart lost ongeveer 80% van vastlopers, hangende content of trage updates op. Twee manieren om dat te doen.
## Vanuit de CMS, op afstand
1. Open **Schermen** in de CMS.
2. Klik op het scherm dat je wil herstarten.
3. Klik op **⋯ → Herstart speler**.
De speler reboot binnen 30 seconden. Tijdens de reboot toont het scherm kort een wachtbeeld, daarna komt de gekoppelde content terug op.
Op afstand werkt alleen voor spelers die online zijn. Een offline speler reageert niet op een afstandscommando.
## Fysiek, ter plaatse
Voor een offline speler of als de afstandscommando niet aankomt:
1. Trek de stroomstekker van de speler uit.
2. Wacht 10 seconden.
3. Steek de stekker terug in.
De speler boot opnieuw en herstelt zijn verbinding. Bij de gibeon.io Speler is er geen aparte aan-/uitknop: de stekker is de schakelaar.
## Wat lost een herstart op
- Speler die online lijkt maar geen nieuwe content meer ophaalt
- Een bevroren of zwart scherm
- Een speler met een verlopen activatiecode-cache
- Tijdelijke wifi-haperingen
## Wat lost een herstart niet op
- Een fundamenteel netwerkprobleem (firewall, captive portal, geen wifi)
- Verkeerd gekoppelde content (geen playlist of fout schema)
- Een corrupt content-bestand. Re-upload het bestand
## Geplande herstarts
Voor productie-omgevingen raden we een dagelijkse herstart aan, bijvoorbeeld 's nachts om 03:00. Dat houdt het geheugen vers en voorkomt 99% van de typische langdurigheids-issues. Bij de gibeon.io Speler regelen wij dat aan onze kant. Aan jouw kant is geen actie nodig.
Voor BYOD-Android-toestellen kun je een wakker-blijf-en-reboot-app installeren of de TV-instellingen op auto-reboot zetten.
## Wat als een herstart niet helpt
Je krijgt geen feedback dat de reboot is verstuurd? De speler is offline. Zie [speler offline](/docs/probleemoplossing/speler-offline). Als de speler online is en de knop niets doet, mail [support@gibeon.io](mailto:support@gibeon.io).
Wacht 2 minuten. De eerste boot na een lange uitstand kan langer duren omdat de speler updates ophaalt. Niet terug binnen 5 minuten? Check internet, daarna stroom, daarna mail support met het scherm-ID.
Zeer zeldzaam, meestal door een corrupt update-pakket. Mail [support@gibeon.io](mailto:support@gibeon.io). Wij rollen een herstel-update uit naar het toestel.
Scherm toont niets: checklist
---
# Speler offline
Het scherm-overzicht in de CMS markeert een speler als offline wanneer er meer dan een paar minuten geen heartbeat is binnengekomen. Vijf redenen, in volgorde van waarschijnlijkheid.
## 1. Geen stroom of het toestel staat uit
Begin altijd hier. Iemand die de TV uitschakelt na sluitingstijd? De speler stuurt geen heartbeat tot hij weer aan staat. Tijdens openingsuren een korte stroomonderbreking? Idem.
**Check**: hangt het scherm aan? Brandt het lampje van de speler?
## 2. Wifi-verbinding verbroken
Tweede meest voorkomende oorzaak. De speler heeft internet nodig om heartbeats te sturen.
**Check**: is de wifi nog actief op de plaats waar de speler hangt? Kun je met een telefoon op hetzelfde netwerk verbinden? Werkt het netwerk wel maar zit de speler erbuiten? Is het wifi-wachtwoord gewijzigd? Toestel uit het netwerk geworpen?
**Oplossing**: rebind de speler met de wifi via de instellingen op het toestel zelf. Bij de gibeon.io Speler kan dat via de afstandsbediening en het wifi-paneel.
## 3. Captive portal (gastenwifi, hotelnetwerk)
Sommige netwerken vereisen een browser-login per toestel. Dat heet een captive portal. De speler kan dat niet doorlopen.
**Oplossing**: kies een netwerk zonder portaalpagina. Vraag een vast SSID + wachtwoord aan de IT-afdeling als die beschikbaar is.
## 4. Firewall blokkeert verbindingen
In bedrijfsnetwerken houdt soms een strikte firewall heartbeat-verkeer tegen. Zie [wifi en firewall](/docs/probleemoplossing/wifi-en-firewall) voor de exacte URL's en poorten die open moeten staan.
## 5. Speler hangt of is gecrasht
Zelden, maar mogelijk. De speler-software stopt zonder fout en stuurt geen heartbeats meer terwijl het toestel zelf nog aan staat.
**Oplossing**: herstart de speler. Zie [speler herstarten](/docs/probleemoplossing/speler-herstarten).
## Wat als alles in orde lijkt
Stappen 1-5 doorlopen zonder succes? Mail [support@gibeon.io](mailto:support@gibeon.io) met de naam van het scherm en het tijdstip van de laatste heartbeat (zichtbaar op de scherm-detailpagina). Wij kijken in de logs.
Speler herstarten
---
# Video laadt traag of stottert
Een video die ronddraait op de loader of tijdens het afspelen begint te haperen. In vrijwel alle gevallen is het bandbreedte of bestandsgrootte. Vier oorzaken in volgorde.
## 1. De video is te groot
Een 4K-video van enkele honderden MB kan op trage internetlijnen niet snel genoeg laden om vlot af te spelen. gibeon.io streamt video via een snel CDN, maar als je upload-bron al zwaar is, blijft hij zwaar.
**Oplossing**: comprimeer de video voor je hem upload. Voor signage volstaat 1080p meestal. 4K alleen waar het echt iets toevoegt. Tools zoals HandBrake brengen een video van 200 MB makkelijk naar 30 MB zonder zichtbaar verlies.
## 2. Onvoldoende bandbreedte op de speler
De speler hangt op een trage of overbelaste internetlijn.
**Check**: snelheidstest op een laptop op hetzelfde wifi-netwerk. Onder ~10 Mbps download bij videos, dan zit je krap voor 1080p streaming.
**Oplossing**: verbind de speler bekabeld als dat kan, of upgrade de internetlijn op die locatie. Tijdelijk kun je naar een lichtere video terugschakelen.
## 3. Te veel videos achter elkaar in de playlist
Vier zware videos na elkaar belasten de speler-cache zwaar. Tussen items door downloadt de speler de volgende. Is die nog niet klaar, dan krijg je een korte buffer.
**Oplossing**: wissel videos af met statische items (afbeelding, template). De speler heeft tussen items een korte adempauze om de volgende klaar te zetten.
## 4. Speler-hardware aan de limiet
Een oudere browser of een Raspberry Pi 3 heeft het zwaar met 1080p video. De gibeon.io Speler en moderne Android-toestellen lopen vlot, maar een browser op een 8 jaar oude Smart TV kan stotteren.
**Oplossing**: kies een recentere speler. Voor productiekwaliteit raden we de gibeon.io Speler of een Google TV-pad aan. Zie [hardware-overzicht](/docs/schermen-en-spelers/hardware-overzicht).
## Wat als het probleem blijft
Het bestand zelf is het probleem. Re-encode hem (constant bitrate, H.264, 5-8 Mbps voor 1080p) en upload opnieuw.
Internet of speler-hardware is de bottleneck. Test bandbreedte; werkt dat, vervang dan de speler.
Dat is geen video-probleem maar een transitie. Stel in de playlist het transitie-effect in op `geen` voor een soepeler overgang.
Een playlist maken
---
# Wifi en firewall
Voor IT-afdelingen die spelers in een bedrijfsnetwerk willen plaatsen. Praktische checklist.
## Bandbreedte-vereisten
| Use-case | Aanbevolen download |
|----------|---------------------|
| Alleen statische content (afbeeldingen, templates) | 5 Mbps |
| Met 1080p video | 10 Mbps |
| Met 4K video | 25 Mbps |
Upload-bandbreedte op de speler is irrelevant: de speler ontvangt content, hij verzendt enkel kleine heartbeats.
## Poorten
Open uitgaand op de speler:
- **TCP 443** (HTTPS) voor alle content-downloads en API-calls
- **TCP/UDP 443** (WSS) voor real-time commando's vanuit de CMS
Open inkomend hoeft niet. De speler initieert alle verbindingen zelf.
## URL's om door de firewall te laten
Whitelist deze hosts:
```
*.gibeon.io CMS, API, auth, database, media en websocket-commando's
*.bunnycdn.com video-CDN
*.b-cdn.net video content delivery
play.google.com Play Store updates (alleen bij Play Store-installatie)
android.googleapis.com Android-systeemupdates
```
Voor de gibeon.io player kiosk-box komen daarbij nog endpoints voor remote management. Die endpoints krijg je samen met de toestellen.
## Captive portals: niet ondersteund
Hotelnetwerken, gastenwifi en sommige bedrijfsnetwerken vereisen een browser-login per toestel. Een speler heeft geen browser en kan geen captive portal doorlopen.
**Oplossing**: voorzie een vast SSID + wachtwoord zonder portaalpagina, of zet de speler op een MAC-adres-whitelist op het netwerk.
## VPN's en proxies
Een speler werkt prima achter een VPN als die transparant is. Een proxy met SSL-inspectie breekt de TLS-verbinding en moet uitgesloten zijn voor de hosts hierboven.
## Statisch IP
Niet vereist, maar handig voor support: bij een offline-melding kun je het toestel sneller terugvinden in de switch.
## Wat als het netwerk volledig dichtgaat
Op aanvraag kunnen we voor een tenant een private CDN-route opzetten via een specifiek subdomein van `cdn.gibeon.io`. Mail [support@gibeon.io](mailto:support@gibeon.io) met je netwerk-context.
Sommige bedrijfs-MDM's voorkomen dat externe toestellen wifi-wachtwoorden onthouden. Voor de gibeon.io Speler werkt dit altijd omdat het toestel buiten je interne MDM staat. Voor BYOD Android-toestellen die in een MDM zitten: vraag IT om een uitzondering, of gebruik een apart signage-netwerk.
Ja. Spelers cachen aggressief. Eens content gedownload, blijft die lokaal. Vier spelers met dezelfde playlist downloaden de bestanden elk één keer en daarna nooit meer (tenzij content wijzigt).
Speler offline troubleshooten
---
# Quotas
De limieten per plan (schermen, opslag en bestandsgroottes) en wat er gebeurt als je een grens nadert. Kies in de zijbalk een onderwerp.
---
# Fair-use policy
"Onbeperkt" in onze plannen betekent: geen harde cap zolang je verbruik past binnen normaal gebruik door één klant. Geen rekenmachine, geen schrik om iets in te schakelen, geen hidden fee als je een rustige week en dan een drukke maand hebt.
## Hoe het werkt in de praktijk
Voor elke fair-use-categorie hanteren we een **soft cap**. Bij 80% van die cap zie je een banner in de CMS. Bij 100% sturen we een mail om mee te kijken, niet om automatisch te suspenden.
Een soft cap is geen wettelijke limiet, het is een gespreksstart. Zit je structureel hoger dan we hadden ingerekend, dan kijken we samen of je op het juiste plan zit of een add-on een betere fit is dan een upgrade.
## Wat valt onder fair-use
- Schermen op Pro, Business en Agency (boven het inbegrepen aantal voor Business / Agency)
- API requests per maand
- Webhook deliveries per maand
- MCP tool calls per maand
- Transactional emails per maand
- Realtime concurrent connections
Voor deze items krijg je geen plotse blokkade. Banner, mail, gesprek.
## Wat heeft een harde limiet
Sommige items hebben wél een harde limiet omdat ze direct kost veroorzaken die niet in de plan-prijs zit:
- **Opslag** (storage): boven cap = upload faalt. [Storage Pack](/docs/facturatie/add-ons/storage-overage) à €10/100 GB lost het op
- **AI-generaties per maand op Free**: boven cap = "AI-generatie tijdelijk niet beschikbaar"-message tot nieuwe billing-cycle of upgrade naar Starter+. Voor Starter, Pro, Business en Agency draait AI op pay-as-you-go: €0,10 per generatie boven het inbegrepen aantal, geen blokkade.
- **Maximum bestandsgrootte per upload**: [zie aparte pagina](/docs/quotas/maximum-bestandsgrootte). Boven cap = upload geweigerd met duidelijke melding
- **Video-minuten per maand** (video-CDN stream): boven cap = video stopt met afspelen tot nieuwe cycle of upgrade
- **CDN egress** (bandbreedte): boven cap = CDN Pack add-on of upgrade nodig
## Echte abuse
Geen klant heeft 1 miljoen schermen of 100 GB-uploads per uur nodig. Patronen die wijzen op script-misbruik (geautomatiseerde bulk-uploads van honderden GB, miljoenen API-calls per dag, scraping) triggeren een gesprek waar nodig een tijdelijke suspend. Doel is niet meer-betalen-afdwingen, maar zorgen dat één klant de service niet kapot maakt voor anderen.
## Vragen
Niet zeker of je gebruik binnen fair-use valt? Mail [matthias@gibeon.io](mailto:matthias@gibeon.io) of open een conversation vanuit de CMS-sidebar. Beter vooraf vragen dan achteraf verrast worden.
---
# Maximum bestandsgrootte
Per upload hanteren we een maximum bestandsgrootte. Dit voorkomt dat één enkel bestand de hele opslag-cap opslorpt of het uploaden vertraagt voor anderen.
## Limiet per plan
| Plan | Max per bestand |
|------|-----------------|
| Free | 50 MB |
| Starter | 100 MB |
| Pro | 250 MB |
| Business | 500 MB |
| Agency | 500 MB |
| Enterprise | Op aanvraag, contractueel |
De limiet geldt per upload. Een mediabibliotheek met 1.000 files van 200 MB op Pro is prima zolang elke individuele upload binnen 250 MB blijft.
## Wat doe je bij een te groot bestand
### Voor video
Vrijwel alle te-grote uploads zijn video. Drie opties:
1. **Comprimeer de video** voor upload. H.264 in MP4-container, 1080p, bitrate rond 5 Mbps. Een tool als HandBrake doet dit gratis
2. **Knip de video korter**. Een 30-seconden-clip op een scherm is bijna altijd effectiever dan een minuut-lange video
3. **Stream via onze video-CDN** in plaats van te uploaden. Gestreamde video's tellen niet mee voor opslag en hebben geen max-bestandsgrootte aan onze kant. Zie [video-content beheren](/docs/inhoud-beheren) voor de stream-flow
### Voor afbeeldingen
Een te-grote afbeelding is vaak een afbeelding op print-resolutie. Voor scherm-weergave volstaat 1920 × 1080 op 72 DPI. Een JPEG van 300 KB ziet er op een 4K-scherm net zo goed uit als een PNG van 30 MB.
Wij comprimeren zelf afbeeldingen automatisch naar WebP achter de schermen, maar de upload-cap is op het bronbestand. Comprimeer dus vóór upload.
### Voor PDFs
Splits grote PDFs op per pagina of converteer naar afbeeldingen vóór upload.
## Wanneer de limiet verhogen
Vraag aan gibeon.io om een tijdelijke verhoging als:
- Je een eenmalige campagne hebt met een echt grote video die niet verder kan worden gecomprimeerd
- Je migreert van een ander signage-platform en bestaande grote files moet overzetten
Mail [matthias@gibeon.io](mailto:matthias@gibeon.io). Voor Enterprise-klanten is dit een contractueel item, geen ad-hoc vraag.
---
# Schermen en spelers
gibeon.io draait op de meeste Android-toestellen, op Smart TV's met Google TV en in een gewone browser. Hier vind je hoe je hardware kiest, een scherm activeert en zones instelt.
---
# Autostart op Google TV en Android-stick
gibeon.io player start vanzelf bij elke boot. Sommige Android-toestellen vragen één extra instelling. Hier vind je per merk wat je moet doen.
## Toegewijd signage-scherm of gedeelde TV?
Tijdens de eerste setup vraagt de wizard welke modus je kiest:
- **Toegewijd signage-scherm**: gibeon.io player start automatisch bij elke boot en brengt zichzelf terug op de voorgrond als er iets anders overheen komt. Dit is de standaardkeuze voor schermen die alleen als signage dienen.
- **Gedeelde TV**: gibeon.io player start niet automatisch. Je opent de app zelf wanneer je wil. gibeon.io blijft volledig uit de weg buiten die momenten. Gebruik dit wanneer dezelfde TV ook voor andere doeleinden dient (vergaderruimte, ontvangstbalie).
Je kunt de keuze later aanpassen via het admin-menu in de app.
## Wat doet autostart?
Bij elke boot van de TV of stick probeert gibeon.io player zichzelf op de voorgrond te brengen. Dat werkt zonder verdere instellingen op de meeste toestellen. Twee scenario's vragen wel actie:
- **Sony Bravia Google TV** heeft een ingebouwde "Auto-start app"-toggle die standaard uit staat. Zet hem AAN voor gibeon.io player.
- **Google TV Streamer en Chromecast** tonen eerst de home-launcher. Vanaf daar druk je op de gibeon.io-tegel om af te spelen. Pin gibeon.io helemaal links voor één-klik-toegang.
Op Xiaomi TV Stick 4K en andere stock-Android TV-toestellen probeert gibeon.io player vanzelf op te starten. Meestal lukt dat. Werkt het niet? Check de tip onderaan.
## Sony Bravia
1. Open **Instellingen** op je Bravia.
2. Ga naar **Apps**.
3. Kies **Auto-start**.
4. Vink **gibeon.io player** aan.
Vanaf de volgende boot start gibeon.io player vanzelf op zonder dat je iets hoeft te drukken.
## Xiaomi TV Stick
De Xiaomi TV Stick 4K heeft geen apart auto-start menu. gibeon.io player probeert zichzelf bij elke boot op te starten via Android's standaard BOOT_COMPLETED-mechanisme. Op de meeste Xiaomi-firmwares werkt dat zonder verdere actie.
Werkt het niet?
- Open één keer manueel gibeon.io player na een boot om te verifiëren dat alles goed staat.
- Schakel in de wizard "Achtergrond toestaan" → "Open instellingen" → batterij-optimalisatie voor gibeon.io UIT. Dat voorkomt dat Android gibeon.io na een paar minuten kilt.
## Google TV Streamer en Chromecast
Google blokkeert apps om zichzelf als HOME launcher te zetten op Google TV. Bij elke boot toont Google TV dus eerst zijn eigen launcher. Zo zorg je dat gibeon.io één klik weg blijft:
1. Open gibeon.io player één keer na de boot.
2. Druk op de home-knop. gibeon.io staat nu in de "Recente apps"-rij.
3. Long-press de gibeon.io-tegel en kies **Naar links verplaatsen** tot gibeon.io helemaal vooraan staat.
Vanaf dan is gibeon.io één druk op de afstandsbediening weg.
## Andere Android TV-toestellen
Voor TCL, Hisense, Philips of andere stock-Android TV-merken volg je het Sony-blok hierboven als visuele referentie. Sommige merken hebben de Auto-start-toggle op een andere plaats. Zoek in **Instellingen** naar "Auto-start", "Auto-launch" of "Apps die opstarten".
Geen toggle te vinden? Schakel in de wizard "Achtergrond toestaan" → batterij-optimalisatie voor gibeon.io UIT. Dat is meestal voldoende.
## Waarom vraagt de wizard om "Display over other apps"?
Tijdens de eerste setup vraagt de wizard om de toestemming **Display over other apps** (SYSTEM_ALERT_WINDOW). Die gebruiken we niet om iets visueel boven andere apps te tonen. We gebruiken hem alleen om gibeon.io player terug naar voren te halen wanneer een Android systeem-popup (firmware-update, opslag-waarschuwing) tijdelijk de focus pakt.
Werkt de toggle niet op jouw toestel? Sla over. gibeon.io werkt verder gewoon, alleen kan het in dat geval een onderbreking niet automatisch oplossen.
Een eerste playlist maken
---
# Autostart op Samsung-signage
Op een Samsung Smart Signage-paneel hoef je geen aparte autostart-app of toggle in te stellen zoals op Android. De ingebouwde **URL Launcher** is meteen de autostart: zodra je hem als opstartbron instelt, haalt het paneel gibeon.io op en start het bij elke boot vanzelf. Eén keer instellen, daarna komt het scherm na elke stroomonderbreking of herstart vanzelf terug op je content.
:::tip[Een gewone Samsung Smart TV (geen Smart Signage)?]
Deze pagina geldt voor de **commerciële Smart Signage-panelen** (SSSP6 / Tizen 4.0+, de OM- en QB-reeks). Een gewone consumenten-tv heeft geen URL Launcher: gebruik daar een [gibeon.io player op Android](/docs/hardware/apk-installeren/) aan de HDMI-ingang en [stel de autostart daar in](/docs/schermen-en-spelers/autostart-google-tv/).
:::
## De URL Launcher is de autostart
Stel je het paneel voor de eerste keer in? Volg dan [Samsung Tizen installeren (URL Launcher)](/docs/hardware/samsung-tizen-installeren/). In het kort:
1. Zet de **opstartbron** op de URL Launcher: **System → Play via → URL Launcher** (op sommige modellen heet dit **App Management → Install Custom App**).
2. Geef als adres `https://cdn.gibeon.io/player/tizen` in.
3. Sla op en herstart het paneel.
Vanaf dat moment hoef je niets meer te doen. Zolang de URL Launcher de opstartbron blijft, start gibeon.io bij **elke** boot vanzelf op. Geen login op het scherm, geen handmatige start, en geen toggle die per ongeluk kan afspringen.
## Zorg dat het scherm niet vanzelf uitvalt
Autostart heeft pas zin als het paneel ook echt aan blijft. Een Samsung-paneel zet zichzelf standaard uit bij geen signaal of na een tijdje stilte. Schakel dat uit:
1. Ga naar **System → Eco Solution**.
2. Zet **Auto Power Off** en **No Signal Power Off** uit.
3. Zet ook de **slaaptimer** uit.
Wil je het scherm net op vaste uren laten aan- en uitgaan (bijvoorbeeld op winkeluren)? Gebruik dan de **On/Off-timer** onder **System → Tijd**, zie [scherm op schema uitzetten](/docs/schermen-en-spelers/scherm-uit-op-schema/). Het paneel start dan op het ingestelde uur vanzelf op én terug in gibeon.io.
## Zet de klok goed, anders laadt de boot niet
Het paneel haalt gibeon.io bij elke boot op over een beveiligde `https`-verbinding. Staat de klok verkeerd, dan breekt die verbinding en blijft het scherm zwart of hangt het op het laadscherm. Zet de tijd dus goed vóór je het scherm achterlaat:
1. Ga naar **System → Tijd**.
2. Zet **automatische tijd (NTP)** aan als die optie er is, anders stel je de tijd handmatig in.
3. Kies de juiste **tijdzone** (België: Brussel, GMT+1) en zet de **zomertijd (DST)** aan.
De juiste klok zorgt er meteen ook voor dat geplande en tijdgebonden content op het juiste moment speelt.
## Herstart of update: wat onthoudt het scherm?
- **Een gewone herstart of stroomonderbreking**: het paneel start via de URL Launcher vanzelf opnieuw op, blijft gekoppeld en toont je content meteen, ook **offline** uit zijn cache. Je hoeft niets opnieuw te activeren.
- **Een update van de speler**: bij een nieuwe versie haalt het paneel die vanzelf op via de URL Launcher en installeert ze op de achtergrond. Je content blijft gewoon spelen en je koppeling blijft behouden, je hoeft normaal niets opnieuw te doen.
:::note[Afstandsbediening-uit is stand-by, geen herstart]
De aan/uit-knop op de afstandsbediening zet het paneel in **stand-by**, het gaat dan niet echt uit. Bij het terug aanzetten hervat het exact waar het stond. De autostart (en een eventuele update-check) loopt alleen bij een **echte** boot, dus na een stroomonderbreking of een herstart via het menu.
:::
## De speler start niet vanzelf op
Dan staat de opstartbron niet meer op de URL Launcher. Een installatie van USB of een andere bron kan hem hebben overschreven. Ga naar **System → Play via**, kies opnieuw **URL Launcher**, controleer het adres `https://cdn.gibeon.io/player/tizen` en herstart het paneel.
Zet de automatische uitschakeling uit onder **System → Eco Solution** (**Auto Power Off** en **No Signal Power Off**) en schakel de slaaptimer uit. Wil je het scherm op vaste uren laten werken, gebruik dan de On/Off-timer onder **System → Tijd**.
Controleer de internetverbinding en de datum/tijd (zet de klok op automatisch / NTP). Werkt `https` niet op een ouder Tizen 4.0-paneel, probeer dan `http://cdn.gibeon.io/player/tizen`. Zet de opstartbron op URL Launcher en herstart.
Nee. Elk paneel wijst gewoon naar hetzelfde URL Launcher-adres en start daarna vanzelf op. Of je er nu één hebt of vierhonderd, de stappen zijn identiek en er is geen instelling per toestel.
Scherm op schema uitzetten
---
# Hardware-overzicht
gibeon.io draait op je eigen toestel, via vier hardware-paden. Twijfel je welke voor jou past? Onderaan staat een snelle keuzehulp.
## De vier paden
### Smart TV met Google TV
Veel recente Sony-, TCL- en Hisense-TV's draaien Google TV. gibeon.io staat in de [Play Store](https://play.google.com/store/apps/details?id=io.gibeon.player) op de TV zelf.
- Voor wie: bedrijven die al een Smart TV hebben
- Installatie: Play Store openen op de TV → gibeon.io zoeken → installeren → activeren
- Meer info: [/players/smart-tv-google-tv](https://www.gibeon.io/players/smart-tv-google-tv)
:::tip Autostart instellen
Zie [autostart instellen](autostart-google-tv.md) voor de eerste keer opstarten.
:::
### Google TV Streamer
Een aparte streaming-stick die je aansluit op een TV zonder Smart-TV-functies.
- Voor wie: bestaande TV's of monitors zonder OS
- Installatie: streamer aansluiten → Play Store → gibeon.io → installeren
- Meer info: [/players/google-tv-streamer](https://www.gibeon.io/players/google-tv-streamer)
:::tip Autostart instellen
Zie [autostart instellen](autostart-google-tv.md) voor de eerste keer opstarten.
:::
### gibeon.io Android-app
Eigen Android-tablet, Android-TV-box of Android-stick (Android 11 of nieuwer).
- Voor wie: BYOD, je hebt al hardware en wilt die hergebruiken
- Installatie: via [Play Store](https://play.google.com/store/apps/details?id=io.gibeon.player). Geen Play Store op je toestel? Zie [App installeren via APK](/docs/hardware/apk-installeren).
- Meer info: [/players/gibeon-android-app](https://www.gibeon.io/players/gibeon-android-app)
:::tip Autostart instellen
Zie [autostart instellen](autostart-google-tv.md) voor de eerste keer opstarten.
:::
### Browser
Een TV-browser, een laptop of zelfs een iPad. Geen installatie, je opent gewoon `p.gibeon.io`.
- Voor wie: snelle proef of testopstelling
- Installatie: geen, open de URL en activeer
- Aandachtspunt: standby-instellingen en firmware-updates van een TV-browser zijn buiten onze controle. Voor productie raden we een Android-toestel aan.
- Meer info: [/players/browser](https://www.gibeon.io/players/browser)
## Welk pad past bij jou
| Situatie | Aanbevolen pad |
|----------|----------------|
| Wil snel starten | Smart TV met Google TV |
| Heeft al een Smart TV met Google TV | Smart TV met Google TV |
| Heeft een TV zonder Smart-OS | Google TV Streamer |
| Wil eigen Android-tablet of -box hergebruiken | gibeon.io Android-app |
| Android-toestel zonder Play Store | [App installeren via APK](/docs/hardware/apk-installeren) |
| Vergrendeld publiek scherm (etalage, onbeheerd) | [Kiosk installeren (Device Owner)](/docs/hardware/kiosk-installeren/) |
| Snelle proef, geen install | Browser |
## Updates en support
Je brengt zelf het toestel, dus het beheer is gedeeld:
- **App-updates**: op toestellen met Play Store updatet de gibeon.io-app zichzelf. Een vergrendelde [kioskversie (Device Owner)](/docs/hardware/kiosk-installeren/) updatet zichzelf ook automatisch over de lucht. Alleen een gewone sideload zonder Play Store update je handmatig, opnieuw via de [APK-stappen](/docs/hardware/apk-installeren).
- **Het toestel-OS** update je zelf, net als bij elk ander toestel.
- **Monitoring**: wij zien de online-status en content-sync van de gibeon.io-app op je scherm, niet je toestel of je netwerk. Gaat een scherm langer dan 24 uur offline, check dan stroom en wifi ter plaatse (zie [speler offline](/docs/probleemoplossing/speler-offline/)).
- **Diagnostiek ter plaatse**: zowel de gewone app als de kiosk hebben een verborgen developer-settings-scherm dat je met de afstandsbediening opent (status lezen, autostart wijzigen, een [kiosk ontgrendelen](/docs/hardware/kiosk-installeren/#ontgrendelen-zonder-laptop)). Zie [App installeren via APK](/docs/hardware/apk-installeren).
- **Garantie** op het toestel loopt via de leverancier waar je het kocht.
Software-support op de gibeon.io-app is voor elk toestel hetzelfde. Zie [support en contact](/docs/instellingen/support-en-contact/).
## Veelgestelde vragen
Nee. Apple TV laat geen signage-apps van derden toe. Gebruik een aangesloten display met een Google TV Streamer of een browser.
Niet actief ondersteund. Technisch is Fire OS gebaseerd op Android, dus de Android-app draait er, maar zonder Play Store moet je [sideloaden](/docs/hardware/apk-installeren). Vraag het aan ons als dit voor jouw setup belangrijk is.
Via de browser-route: Chromium in kiosk-modus naar `p.gibeon.io`. Je registreert dan als type "Browser" in het overzicht.
Full HD (1920×1080) en 4K (3840×2160). Beide in landscape én portrait. Het scherm gedraagt zich naar de werkelijke resolutie van het scherm waarop het draait.
Zones en layouts instellen
---
# Scherm draaien (staand of liggend)
Elk scherm heeft een oriëntatie. Hangt je scherm rechtop aan de muur, dan zet je het in gibeon.io op staand en draait de content mee.
## De oriëntatie instellen
Ga naar **Schermen**, kies het scherm en open **Oriëntatie**. Je kiest uit drie standen:
- **Liggend**: het standaard horizontale beeld (1920×1080).
- **Staand**: een rechtopstaand beeld (1080×1920), voor een scherm dat 90° gedraaid hangt.
- **Staand omgekeerd**: hetzelfde staande beeld, maar de andere kant op gedraaid.
Een wijziging is binnen enkele seconden op het scherm zichtbaar. Je hoeft niet te publiceren.
## Staand of staand omgekeerd?
Beide tonen een rechtopstaand beeld. Het verschil is de draairichting: een scherm kan met of tegen de wijzers van de klok aan de muur hangen. Staat je beeld na het kiezen van **staand** ondersteboven, kies dan **staand omgekeerd** (of omgekeerd).
## Een extern scherm (TV of monitor via HDMI)
Draait gibeon.io op een box die via HDMI op een TV of monitor aangesloten is? Laat dan **gibeon.io de rotatie doen** en zet het externe scherm op zijn **liggende bron**, met beeldmodus **"Just Scan" of "1:1"** (geen overscan, geen "Fill" of "Stretch").
Zet je het externe scherm óók op zijn eigen staande stand, dan draait het beeld twee keer en wordt het uitgerekt. Eén laag mag draaien, niet twee. Wil je de menu's van het scherm wél gedraaid zien, gebruik dan de aparte menu-oriëntatie van dat scherm en laat de bron-oriëntatie op liggend.
Beeldverhouding klopt niet
---
# Scherm op schema uitzetten
Wil je je scherm 's nachts laten uitgaan om stroom te besparen en de levensduur van het paneel te verlengen? Dat kan op twee manieren, afhankelijk van je toestel.
## In gibeon.io: uit-zones in je planning
Je voegt in een planning een **uit-zone** toe: een tijdvenster (bijvoorbeeld 22:00 tot 07:00) waarin het scherm uitgaat. Buiten dat venster speelt je gewone inhoud. Je hoeft geen "aan"-moment te plannen, het scherm staat standaard aan.
Wat gibeon.io dan doet, hangt af van het type toestel:
- **Toestel met een eigen scherm** (tablet, een Smart TV met ingebouwde Android, een monitor): gibeon.io dimt het scherm naar zwart en zet de helderheid op het minimum. Dat bespaart echt stroom (de achtergrondverlichting is de grootste verbruiker).
- **Een stick die een TV aanstuurt** (Xiaomi TV Stick, Chromecast met Google TV, Fire TV): gibeon.io toont een zwart beeld, maar een stick heeft geen eigen scherm en kan de achtergrondverlichting van de TV niet zelf uitzetten. Het beeld is zwart, maar de TV blijft technisch aan.
## Een TV achter een stick écht uitzetten
Wil je dat de TV zelf volledig uitgaat (niet alleen zwart)? Gebruik een van deze, in volgorde van betrouwbaarheid:
1. **Een slimme stekker met timer** (vanaf ongeveer €10). Stel hem in om de TV 's nachts uit en 's ochtends aan te schakelen. Dit werkt op elke TV, los van merk of instellingen, en is het meest betrouwbaar.
2. **De slaap-timer of "automatisch uit" van de TV zelf.** Bijna elke TV heeft dit in zijn eigen instellingen.
3. **HDMI-CEC.** Veel TV's kunnen de aangesloten stick mee in- en uitschakelen via CEC. Zet CEC aan in de TV-instellingen (heet vaak anders per merk: Bravia Sync, Anynet+, SimpLink, ...).
:::tip
Voor een toestel met een eigen scherm (tablet, ingebouwde Android-TV) heb je niets extra nodig: de uit-zone dimt het paneel rechtstreeks.
:::
---
# Scherm uitrollen via URL
gibeon.io ondersteunt browser-only signage-hardware (zoals Yodeck, BrightSign HTML, generieke Chromium-kiosk-displays) via een directe URL. Geen account-koppeling op het scherm nodig. URL plakken volstaat. Dit is uniek: andere signage-platforms vragen vaak een login op het device.
## Twee soorten URLs
Elk scherm heeft twee URLs in **Technische info**:
### Privé URL
Voor uitrol op een echt scherm. Eén sessie tegelijk per URL.
- Vorm: `https://p.gibeon.io/?d=`
- Zodra een scherm de URL opent, claimt het de sessie
- Een tweede toestel dat dezelfde URL opent moet wachten of overneemt na 60 seconden inactiviteit van het eerste
- Bedoeld voor productie-uitrol
### Preview URL
Voor delen, bijvoorbeeld naar een collega die wil zien wat er op het scherm staat.
- Vorm: `https://p.gibeon.io/?preview=<32-tekens-secret>`
- Meerdere kijkers tegelijk OK, geen sessie-conflict
- Zichtbare "PREVIEW"-badge rechtsboven zodat duidelijk is dat het geen echt scherm is
- Intrekbaar: één klik op **Nieuwe URL genereren** maakt de oude meteen ongeldig
## Een URL ophalen
1. Open je scherm in de CMS.
2. Klik onderaan op **Technische info**.
3. Genereer of kopieer de gewenste URL.
## Op browser-only hardware uitrollen
De Privé URL is exact wat browser-only signage-hardware nodig heeft.
1. Open de console van je signage-platform.
2. Maak een nieuwe "Web App" of "URL" widget.
3. Plak de Privé URL.
4. Stel **Reload-interval** in op **Uit** (de URL handelt zijn eigen verversing af).
5. Zet **Audio** aan als je video met geluid afspeelt.
6. Wijs de widget toe aan je scherm en push.
Na ongeveer tien seconden draait je gibeon.io-content.
## Wanneer regenereer ik mijn URL?
| Situatie | Wat doen |
|---|---|
| Je vermoedt dat de URL gelekt is | Vernieuw de Privé URL en herconfigureer het scherm |
| Een Preview-link is in de verkeerde Slack-channel beland | Vernieuw de Preview URL, de oude werkt niet meer |
| Een scherm wordt aan een nieuwe klant gegeven | Vernieuw beide URLs voor de oplevering |
| Routine-onderhoud | Niet nodig. URLs zijn stabiel zolang er geen lek-risico is |
## Troubleshooting
**"Dit scherm wordt elders afgespeeld" (Privé URL)**
Een andere sessie heeft de lock op dit scherm. Wacht 60 seconden, de pagina ververst automatisch. Komt het probleem terug: een ander apparaat gebruikt dezelfde URL, of er staat een tweede browser-tab open. Sluit de andere tab(s) of vernieuw de URL.
**"Deze preview-link is verlopen"**
De Preview URL is ingetrokken (door een nieuwe te genereren) of nooit aangemaakt. Vraag de eigenaar om een nieuwe link.
**Eerste boot werkt, maar na een reboot zie ik tijdelijk een foutscherm**
De Privé URL heeft een korte beveiligings-grace (60 seconden) waarin een tweede sessie wordt afgewezen. Na een reboot kan het scherm net binnen die grace vallen. De pagina ververst automatisch, geen actie nodig.
## Veelgestelde vragen
**Hoeveel schermen kan ik via een URL uitrollen?**
Geen limiet vanuit gibeon.io. Voor 70+ schermen tegelijk raden we aan om in waves uit te rollen (start met 1, dan 5, dan 20, dan rest) zodat je eventuele issues vroeg ziet.
**Werkt offline-modus ook bij URL-uitrol?**
Ja, zodra de eerste boot succesvol is geweest. De player cached content lokaal in de browser. Bij een tijdelijke netwerk-uitval blijft afgespeeld wat al gecached is. Bij een verse boot na een wipe heb je netwerk nodig.
**Kan ik dezelfde Privé URL op twee schermen tegelijk gebruiken?**
Nee, de URL is per-device en single-session. Voor twee schermen genereer je twee URLs.
---
# Zones en layouts
Een zone is een deelgebied van een scherm met eigen content. Door een scherm in zones te verdelen kun je bijvoorbeeld een groot pand tonen met daarnaast een ticker met openingsuren of een eindeloze afbeeldingen-rotatie.
## Wanneer gebruik je zones
Eén content-item per scherm? Dan heb je geen zones nodig. Kies een **fullscreen** template en je bent klaar.
Wel zones als je tegelijk meerdere dingen wil tonen:
- Pand groot links, contactgegevens rechts
- Menu-kaart bovenaan, prijslijst onderaan
- Live video met daarnaast een sociale-media-feed
## Layouts
Bij het maken van een template kies je een layout-type:
- **Fullscreen**: één zone die het volledige scherm vult
- **Split-screen**: twee zones, links groot en rechts smal (of omgekeerd)
- **Elegant-stacked**: verticale stack van blokken, geschikt voor portrait
- **Gallery-grid**: meerdere panden naast elkaar in een raster
Elke zone toont onafhankelijk content. Eén zone kan een specifiek pand tonen, een andere kan een rotatie zijn van vijf andere panden.
## Stappen
1. Ga naar **Templates** en kies **Nieuwe template**.
2. Selecteer een **layout** (fullscreen, split-screen, ...).
3. Stel per zone in welke data wordt getoond, bijvoorbeeld pand-detail in zone 1 en een afbeeldingen-galerij in zone 2.
4. Stel een **oriëntatie** in: landscape, portrait of beide.
5. Sla de template op en gebruik hem in een playlist.
## Portrait of landscape
Een scherm gedraagt zich naar zijn werkelijke fysieke oriëntatie. Heb je een staand scherm bij de etalage? Kies dan een template gemarkeerd als **portrait** of **beide**. Hiermee schikt de layout zich correct.
Sommige layouts werken alleen in landscape (zoals een brede split-screen) of alleen in portrait (zoals elegant-stacked). De template-bibliotheek toont per template welke oriëntaties ondersteund zijn.
## Wat als het niet werkt
Open de template-editor en controleer of de zone gekoppeld is aan een data-bron. Geen gekoppelde data → geen content.
Tekst-grootte schaalt mee met de zone-breedte. Als de tekst niet past, verklein dan de tekst-grootte in de template of maak de zone breder.
Zorg dat de template overeenkomt met hoe het scherm fysiek hangt. Is het scherm gekanteld maar de template landscape? Roteer de template of het scherm.
Een playlist maken die deze template gebruikt
---
# White-label en resellers
Voor partners die gibeon.io onder eigen merk verkopen. Minimum 20 schermen, hardware inbegrepen, jij zet de prijs.
---
# Eigen merk koppelen
Je hebt het white-label-contract getekend. Hier is het pad van technische setup naar je eerste live klant.
## Wat heb je nodig vóór je begint
- Toegang tot je domein-registrar (om DNS-records aan te passen)
- Logo in SVG of transparante PNG, primaire merkkleur, secundaire kleur
- Het e-mailadres dat je voor partner-correspondentie gebruikt
- Een testklant (bij voorkeur jezelf) voor de eerste activatie
## Stappen
### 1. Subdomein kiezen en DNS instellen
Kies een subdomein voor de white-label CMS, bijvoorbeeld `app.jouwbedrijf.be`.
Voeg in je domein-registrar dit DNS-record toe:
```
Type: CNAME
Naam: app
Waarde: gibeon-whitelabel.cloudflare.net
TTL: 300
```
Het effectieve domein wijst gibeon.io je toe na contractondertekening. Gebruik exact wat we doorgeven, niet de placeholder hierboven.
DNS-propagatie duurt meestal 5-30 minuten. Wij zien automatisch wanneer het record actief is en sturen een bevestiging zodra het SSL-certificaat uitgerold is.
### 2. Branding uploaden
In het partnerportaal:
1. Open **Partner-instellingen → Branding**.
2. Upload je logo (300×80px aanbevolen voor de horizontale variant).
3. Stel je primaire kleur in (hex-code, bijvoorbeeld `#1a73e8`).
4. Optioneel: secundaire kleur, lettertype-keuze.
5. Klik op **Voorbeeld** om te zien hoe het CMS er voor je klanten uitziet.
### 3. Eerste klant aanmaken
1. In het partnerportaal: **Klanten → Nieuwe klant**.
2. Vul de bedrijfsnaam in en het e-mailadres van de eindgebruiker die admin wordt.
3. Wij sturen een uitnodiging naar dat adres.
4. De klant accepteert, kiest een wachtwoord, en land in jouw gebrand CMS.
### 4. Facturatie-flow
| Wie betaalt wie | Wat | Hoe |
|-----------------|-----|-----|
| Klant → jij | Naar jouw eigen tarief per scherm of per klant | Via jouw eigen facturatieproces |
| Jij → gibeon.io | Agency: €249 basis + €8 per extra scherm boven het 20-schermen-pool. Whitelabel + Priority Support inbegrepen | Maandelijks via Stripe |
Je behoudt het verschil tussen je Agency-totaal en wat je je klanten aanrekent. Volledige opbouw met voorbeelden in [white-label vereisten](/docs/white-label/whitelabel-vereisten#prijszetting-voorbeeld).
### 5. Klant-support
Eerste lijn neem jij voor je rekening. Eindklanten contacteren jou voor hulp. Lukt het niet? Stuur ons een mail vanuit jouw partner-account; wij zien het in onze partner-queue en nemen technische escalaties over.
## Wat als het niet werkt
DNS-propagatie duurt soms tot 24 uur, afhankelijk van je registrar en TTL. Test met `dig app.jouwbedrijf.be CNAME` of een online DNS-checker. Krijg je nog je oude IP-adres terug, dan is de propagatie nog bezig.
Mail-templates zijn aanpasbaar maar dit gebeurt aan onze kant. Stuur ons een opmerking bij activatie en we verwerken de mail-templates met jouw merknaam.
In het partnerportaal onder **Branding**. Wijzigingen zijn live binnen enkele minuten. Bestaande klanten zien de nieuwe kleur bij hun volgende paginabezoek.
Niet via dit white-label-pakket. De gibeon.io-app blijft onder onze naam in de [Play Store](https://play.google.com/store/apps/details?id=io.gibeon.player); je klanten installeren hem en activeren in jouw CMS. Een eigen Play Store-app is een aparte offerte.
White-label vereisten op een rij
---
# White-label vereisten
White-label laat je gibeon.io onder je eigen merk doorverkopen. Jouw logo, jouw kleur, jouw domein, jouw prijs. Wij verzorgen het platform aan onze kant.
Sinds mei 2026 is white-label inbegrepen in het **Agency-plan** (de standaard reseller-tier), of beschikbaar als **€79/mnd add-on op Pro of Business** voor single-brand whitelabel-scenario's.
## Twee paden
**Pad 1, Agency-tier (volledig reseller, €249/mnd):**
- Geschikt voor wie veel klanten beheert onder eigen merk
- Onbeperkt sub-accounts (elk een eigen klant-omgeving)
- 20 schermen pool inbegrepen + €8 per extra scherm boven pool
- Whitelabel én Priority Support inbegrepen, geen extra fee
- Sub-account management vanuit één facturatie-rekening
**Pad 2, Pro/Business + €79 Whitelabel add-on:**
- Geschikt voor wie één eigen merk wil zonder reseller-structuur
- Pro €99 + €79 = €178/mnd (single workspace) of Business €198 + €79 = €277/mnd (10 workspaces)
- Per-scherm overage €5/scherm (Pro/Business rate) boven 10 inbegrepen
- Geen sub-account-management, geen Priority Support inbegrepen
Voor de meeste reseller-cases kies je Agency. Voor "ik wil mijn eigen merk maar geen multi-customer reseller-portaal" kies je Pro of Business + Whitelabel add-on.
## Wat heb je nodig (Agency-pad)
- Een actief **Agency-abonnement** (€249 per maand of €2.490 per jaar)
- Een **logo** (SVG of PNG, transparant) en een **primaire kleur** (hex-code)
- Een **eigen domein** of subdomein voor de CMS, bijvoorbeeld `app.jouwbedrijf.be`
- Een **bedrijf met BTW-nummer** voor facturatie
## Wat is inbegrepen (Agency)
- Volledig white-label CMS, geen gibeon.io-naam zichtbaar voor je sub-account-klanten
- Onbeperkt sub-accounts, elk een gescheiden klant-omgeving met volledige data-isolatie
- 20-schermen-pool gedeeld over je sub-accounts
- €8 per extra scherm boven het pool (zie [prijzen-en-abonnementen](/docs/facturatie/prijzen-en-abonnementen))
- Priority email support inbegrepen
- API + webhooks
- Hosting, monitoring, security en updates blijven aan onze kant
- Eén contactpersoon bij gibeon.io voor alle technische escalaties
## Wat blijft beperkt
- Het visuele kader is aanpasbaar (logo, kleur, lettertype), de structurele UI niet, geen aparte feature-set per sub-account
- E-mailcommunicatie naar eindklanten verloopt via jouw mailadres en domein
- Klantcontact is jouw verantwoordelijkheid; technische escalaties via jouw partner-contactpersoon
## Prijszetting voorbeeld
Stel: 38 sub-account-klanten met gemiddeld 1,5 schermen elk = 60 schermen totaal (immo-distributie). Onder Agency:
| Item | Berekening | Bedrag |
|------|------------|--------|
| Agency basis | | €249 |
| Pool dekt | 20 schermen | €0 |
| Extra schermen boven pool | 40 × €8 | €320 |
| **Totaal per maand** | | **€569** (€9,48/scherm) |
Wat je je sub-account-klanten aanrekent kies je zelf. Je marge zit tussen jouw Agency-totaal en wat jij doorberekent.
## Doorlooptijd
Tussen contractondertekening en je eerste live klant: ongeveer **5 werkdagen**, opgesplitst als:
- Dag 1: contract en facturatie-setup
- Dag 2-3: branding-pakket verwerken (logo, kleur, domein-DNS)
- Dag 4-5: testaccount + eerste schermen activeren
## Wat als het niet werkt
Onbeperkt. Sub-accounts zijn gratis, er is geen aparte sub-account-fee op de factuur. Je betaalt alleen €8 per scherm boven het 20-schermen-pool, ongeacht hoe die schermen over je sub-accounts verdeeld zijn.
Je Agency-abonnement blijft maandelijks lopen op €249. Zonder sub-accounts en schermen betaal je alleen die basis. Maandelijks opzegbaar.
Agency (€249) bevat sub-account-management met volledige data-isolatie tussen klanten. Business + Whitelabel (€198 + €79 = €277) is single-workspace whitelabel, perfect als je één eigen merk wil voeren zonder multi-customer portaal. Bij ~50+ schermen wordt Business + Whitelabel goedkoper dan Agency.
Niet standaard. De gibeon.io Speler en de gibeon.io-app blijven onder de gibeon.io-naam in de [Play Store](https://play.google.com/store/apps/details?id=io.gibeon.player). Wel: het CMS dat je klanten gebruiken is volledig white-label. Voor een gebrand-eigen Play Store-app vraag je een offerte op maat aan.
Je merk koppelen
---