Telvi - Handleiding

1Wat is Telvi?

Telvi is een systeem om een eigen tv-/uitzendkanaal te plannen en automatisch af te spelen. Je stelt in wat er wanneer moet spelen, en Telvi zorgt dat het op het juiste moment op het scherm komt.

Telvi bestaat uit twee hoofdonderdelen die samen één systeem vormen:

• Telvi Server - de web-interface (de "controlekamer"). Hier beheer je je media, maak je formats, genereer je afspeellijsten, schrijf je scripts en bewaak je de uitzending via de Cue Clock. Je opent dit gewoon in een browser.
• Telvi Player - de speler (de "playout"). Dit is de applicatie die op de uitzend-pc draait en de media daadwerkelijk fullscreen op het scherm afspeelt volgens de afspeellijst.

Beide onderdelen praten met elkaar via een gedeelde datamap (de Telvi Data-map, bijvoorbeeld op een netwerkschijf/NAS). De Server schrijft de afspeellijsten en instellingen daarin weg; de Player leest ze uit. Zo kun je één of meerdere spelers op verschillende schermen laten draaien, allemaal vanuit dezelfde centrale planning.

2Kernbegrippen

Deze termen kom je overal in Telvi tegen. Als je deze snapt, snap je de rest bijna vanzelf.

Cue-types: hoe start- en eindtijden werken

Elke regel in een format heeft een starttype en een eindtype. Die bepalen wanneer een item begint en eindigt:

3Eerste installatie, drive & licentie

Bij een verse installatie loodst Telvi je één keer door drie dingen: de setup ontgrendelen, de datadrive kiezen en je licentie invoeren.

Stap A - Setup ontgrendelen

Is de server nog niet ingesteld, dan opent automatisch het Setup-scherm. Telvi maakt bij installatie een bestand LOGIN_CODE.txt aan in de programmamap. Open dat bestand, neem de code over in het Setup-scherm en ga verder.

Stap B - Een Telvi Drive kiezen of aanmaken

Vervolgens bepaal je waar de data komt te staan. Je krijgt twee keuzes:

• Een bestaande Telvi Drive gebruiken - wijs Telvi naar een bestaande Telvi Data-map (bijvoorbeeld op een NAS die een andere server al gebruikt). Telvi controleert eerst of het echt een geldige Telvi Drive is voordat hij hem accepteert.
• Een nieuwe Telvi Drive aanmaken - Telvi genereert de volledige mappenstructuur en alle benodigde bestanden voor je, plus een standaard beheerdersaccount: gebruikersnaam TelviAdmin, wachtwoord TelviBroadcast.

Stap C - Licentie

Telvi wordt geactiveerd met een licentiecode. Bij de eerste start voer je je code in; Telvi valideert die online bij EventalMedia en registreert deze machine. Daarna:

• Wordt de licentie automatisch opnieuw gecontroleerd bij elke start en elke 15 minuten tijdens het draaien.
• Als het internet tijdelijk wegvalt, blijft Telvi werken binnen een offline respijtperiode van 7 dagen, gerekend vanaf de laatste succesvolle online controle.
• Wordt de licentie (of dit apparaat) in het EventalMedia-portaal verwijderd, dan merkt Telvi dat bij de volgende controle en vraagt hij opnieuw om een geldige code - ook als het dezelfde sleutel is.

Stap D - Inloggen

Op het inlogscherm voer je je gebruikersnaam en wachtwoord in. Gebruikers en rechten beheer je later in Instellingen → Gebruikers.

4Telvi Server - navigatie & taal

Na het inloggen kom je in de web-interface. Links zit de navigatie, bovenin zie je de titel van de huidige pagina.

In de zijbalk vind je alle onderdelen: Dashboard, Media, Formats, Playlists (met Afspeellijst-weergave en Afspeellijst-bouwer), Cue Clock, Nood-override, Logboek, Scripting en Instellingen. Onderaan de zijbalk staan je gebruikersnaam, een uitlog-knop, de themaschakelaar (licht/donker) en de taalschakelaar.

5Dashboard

Het startscherm met een snel overzicht en snelkoppelingen.

Het Dashboard toont in één oogopslag de status (waaronder de lokale tijd van de server en of de player verbonden is), een blok met de laatste logs, en snelacties om direct naar de mediabibliotheek, de afspeellijst-weergave, de instellingen of de logs te springen. Het is bedoeld als startpunt; het echte werk gebeurt op de andere pagina's.

6Media

De bibliotheek van al je afspeelbare items. Hier beheer je video's, websites en livestreams.

Overzicht & zoeken

De mediapagina toont je items als kaartjes met een thumbnail. Bovenin kun je zoeken (op naam, groep of ID), filteren op type, en met de knop Gearchiveerd ook gearchiveerde items tonen. Met Herladen ververs je de lijst.

Een nieuw item toevoegen

Met de knop Nieuw maak je zelf een Website of Livestream aan (je geeft een naam, groep en de URL op).

Een item bewerken

Klik op een kaartje om het bewerkvenster te openen. Bij een videobestand speelt de thumbnail als speler (kan de browser het formaat niet aan, dan toont hij de thumbnail met een melding). Links zie je snelle info (ID, aantal keer gespeeld, datum toegevoegd, laatst gespeeld) en de knop Opslaan. Rechts staan meerdere tabbladen:

• Overzicht - naam, groep, mediatype, (bij Website/Livestream) de URL, omschrijving en privénotities.
• Automatisering - of het item meedoet in de automatische planning, mediagewicht (hoe vaak het gekozen wordt), minimum aantal uren tussen afspelen, geldigheidsperiode (start-/einddatum) en het automatiseringsraster.
• Audio - een volume-offset per item van -100 tot +100, ten opzichte van het standaardvolume van de player. 0 betekent "gebruik het standaard", +20 is luider en -100 dempt dit item. Oudere geïmporteerde media blijft gewoon werken (standaard een offset van 0).
• Scripting - optioneel een script uitvoeren bij het begin en/of einde van dit item. Zet de optie aan en kies een script uit de scriptbibliotheek. De Player draait het gekozen script op basis van zijn ID.
• Geavanceerd - archiveren en "tonen in API".
• Gevarenzone - dit media-item permanent verwijderen.

7Formats & de Format-editor

Een format is het dagsjabloon van je kanaal: de regels die bepalen wat er speelt. Uit een format genereer je afspeellijsten.

Formats-overzicht

Op de pagina Formats zie je al je formats. Je kunt een Nieuw format maken, een bestaand format Bewerken, of Verwijderen. Formats worden lokaal opgeslagen in de Telvi-datamap.

De Format-editor

Dit is de krachtigste plek in Telvi: een lijst-editor waarin elke rij één programmapunt is. Bovenin geef je de Naam en Notities van het format op. Daaronder staat de werkbalk met alle bewerkacties:

• Rij toevoegen / Erboven invoegen / Eronder invoegen - regels toevoegen.
• Kopiëren, Knippen, Plakken, Dupliceren, Verwijderen - regels beheren.
• Omhoog / Omlaag - de volgorde wijzigen.
• Zoeken op notitie/groep/media-id, en Naar toolbox om een selectie als snippet op te slaan.

Per rij stel je in:

8Scriptbibliotheek

Een centrale bibliotheek met kleine Windows-batchscripts die de Player kan uitvoeren aan het begin of einde van een media-item - bijvoorbeeld om een mixer te schakelen, een lamp te triggeren of een ander systeem te informeren.

De bibliotheek

De pagina Scripting (in de zijbalk tussen Logboek en Instellingen) toont al je scripts, net als de Formats-pagina. Elk script krijgt een eigen ID en een naam die je zelf kiest. Je kunt hier scripts aanmaken, hernoemen, bewerken en verwijderen. Scripts worden opgeslagen in de Telvi-datamap onder Telvi Data\scripts.

De code-editor

Bewerken doe je in een echte code-editor (dezelfde engine als Visual Studio Code) met syntaxkleuring voor Windows-batchbestanden. Hij werkt volledig offline - de editor wordt met Telvi meegeleverd en werkt zichzelf op de achtergrond bij zodra er een nieuwere versie is.

Een script gebruiken op een media-item

Je schrijft scripts niet op het media-item zelf. In plaats daarvan zet je op het tabblad Scripting van het media-item "script bij start/einde uitvoeren" aan en kies je een script uit de bibliotheek. De Player draait dan het gekozen script (op basis van zijn ID) op het juiste moment. Eén script hergebruiken over veel items houdt alles consistent en op één plek makkelijk aan te passen.

9Playlists genereren (Playlist builder)

Hier zet je een format om in concrete afspeellijsten, tot 30 dagen vooruit - en bouw je de noodplaylist (terugvallijst).

1. Kies bovenin het Format dat je wilt gebruiken.
2. Selecteer de dagen in het kalenderraster (klik op dagen), of gebruik de snelknoppen Volgende 7, Volgende 14 of Volgende 30.
3. Klik op Geselecteerde genereren. Telvi bouwt de afspeellijsten; je ziet de voortgang per dag en per formatregel.

In het raster zie je per dag of er al een afspeellijst bestaat (groen) of nog ontbreekt (rood), en welke dagen je hebt geselecteerd. Met Status verversen herlaad je die staat.

De Noodplaylist-tegel

De laatste tegel in het raster (rechtsonder) is de Noodplaylist. Die selecteer je net als een dag - maar niet samen met dagen: kies je de Noodplaylist-tegel, dan worden geselecteerde dagen leeggemaakt en andersom. Met Geselecteerde genereren bouwt Telvi dan de terugvallijst uit het gekozen format en slaat die op in de Telvi Drive. De Player loopt deze lijst af zodra er niets anders is om te spelen.

10Playlists bekijken (Playlist viewer)

Zie precies wat er per datum gepland staat - en spot mogelijke problemen.

Kies een datum (of klik op Vandaag), en blader door de dagen met Vorige/Volgende. Je kunt zoeken en met Alleen problemen filteren op rijen die aandacht nodig hebben. De tabel toont per rij de start- en eindtijd, duur, type, titel, ID en notitie. In de kolom Vlaggen zie je waarschuwingen:

• Ontbreekt - het gekoppelde mediabestand is niet gevonden.
• Statische start / Statisch einde - de regel gebruikt een harde (vaste) tijd.

Klik op een rij voor de details (timing, type, titel/groep, eventuele problemen en de URL). Deze pagina is alleen-lezen: hier bekijk je, in de Format-editor bewerk je.

11Cue Clock & live cues

Het live scherm van de uitzending: wat er nu speelt, wat er komt, en de knop om zelf een moment te bepalen.

De Cue Clock toont een grote klok, het item dat nu speelt (met resterende tijd en een voortgangsbalk) en de volgende items (Next, Then, Later). Ideaal om op een tweede scherm te laten draaien tijdens de uitzending.

De NEXT CUE-knop

Rechtsboven zit de knop NEXT CUE. Die wordt alleen actief wanneer de volgende overgang een user cue is - dus wanneer het huidige item een user-cue-eindtijd heeft, of het volgende item een user-cue-starttijd. Op alle andere momenten is de knop grijs.

Als je erop klikt, stuurt Telvi een commando naar de playouts en springen ze naar de volgende media. Zo bepaal je live het exacte moment van de overgang - perfect voor bijvoorbeeld het uitspelen van een live item of een handmatige cut.

12Nood-override

Forceer direct één media-item op de buis, dwars over het lopende schema heen - voor een breaking-newsbeeld, een storingskaart of een noodstream.

Met de pagina Nood-override (in de zijbalk, gemarkeerd met een ⚠) neem je de uitzending in seconden over:

1. Kies de media die je op de buis wilt (zoek en selecteer uit de bibliotheek).
2. Kies wanneer hij moet stoppen:
   • Eén keer spelen, dan door - speelt het item één keer af en gaat daarna terug naar het live schema.
   • Loopen tot ik het uitzet - blijft het item herhalen (of houdt een stream aan) tot je de override uitzet. Ideaal voor een stream of een wachtkaart.
   • Tot een ingesteld tijdstip - blijft op de buis tot het tijdstip dat je kiest en gaat daarna terug naar het live schema.
3. Voeg optioneel een reden toe en druk op Nu overriden (harde cut). De Player neemt binnen ongeveer een seconde over.

Zodra de override eindigt (via een van de modi hierboven, of wanneer je op Override UITzetten drukt), keert de Player terug naar het live schema - hij pikt op wat op dat moment op de buis hoort, zodat je precies weer bent waar de normale playout zou zijn.

13Logs

Bekijk live wat Telvi doet - handig om te controleren en problemen op te lossen.

De pagina Logs toont de recente serverlogs. Je kunt filteren op tekst, kiezen hoeveel regels je toont, en met Auto automatisch verversen (met een instelbaar interval). Met Boven/Onder spring je snel door de lijst. Terwijl je in het filter typt, pauzeert het automatisch verversen even zodat de weergave niet onder je handen wegspringt.

14Instellingen

Alle configuratie op één plek, verdeeld over tabbladen. Onderaan sla je alles op met Alles opslaan.

15Telvi Player

De speler die op de uitzend-pc draait en de afspeellijst fullscreen op het scherm zet.

Wat de Player doet

De Player leest de afspeellijst van de dag uit de datamap en speelt de items op tijd af: video's, websites en livestreams. Hij toont de station bug op het scherm, valt terug op de noodplaylist als er niets te spelen is, gehoorzaamt de nood-override en user cues (de NEXT CUE-knop), en draait eventuele start-/eindscripts die aan een media-item hangen.

Vloeiende, naadloze playout

Telvi Player gebruikt een dubbele-speler-techniek met voorladen: de volgende video wordt op een tweede, verborgen speler klaargezet terwijl de huidige nog op de buis staat, en de wissel gebeurt pas zodra er echt beeld klaar is. Het resultaat is een schone, frame-nauwkeurige cut tussen items - geen zwarte flits ertussen.

Live playlist-updates (hot reload)

Bewerk of hergenereer je de afspeellijst die op dat moment speelt (de normale daglijst of de noodlijst), dan laadt de Player de nieuwe versie live in. Het item dat op de buis staat blijft gewoon doorspelen; alleen de wachtrij en de tijden volgen het nieuwe schema, zodat kijkers niets zien. Een nieuwe harde starttijd die al verstreken is, mag overschakelen om het schema exact te houden.

De station bug

De bug is een echte PNG met volledige transparantie per pixel, altijd bovenop de (fullscreen) video getekend. De Player houdt hem in het geheugen, zodat het PNG-bestand vervangbaar blijft, en hij herlaadt automatisch wanneer je de afbeelding of de instellingen op de server wijzigt. Ontbreekt het bestand, dan verbergt hij zich simpelweg tot het terugkomt.

Het instellingenscherm (SHIFT+ESC)

De Player heeft een eigen lokaal instellingenscherm. Je opent het zo:

1. Start de Telvi Player. Tijdens het opstarten verschijnt de splash.
2. Houd in de eerste 2 seconden na de splash de toetsen Shift + Esc ingedrukt. Onderin de splash zie je de hint "Press SHIFT+ESC for configuration menu".
3. Het instellingenscherm opent. Pas je instellingen aan en klik op OK. De Player slaat op en herstart automatisch met de nieuwe instellingen. (Met Annuleren ga je gewoon verder.)

In dit scherm stel je per machine in:

• Uitvoerscherm - op welk aangesloten scherm de Player afspeelt.
• GPU-rendering - hardware-acceleratie aan of uit (voor zowel de browserweergave als de videodecodering).
• Automatisch starten met Windows - de Player laten starten zodra Windows start.

De uitvoer­resolutie stel je hier niet meer in - die komt uit de serverinstellingen (hoofdstuk 14).

16Typische workflow (stap voor stap)

Zo ziet een volledige reis van "leeg" naar "in de lucht" eruit.

1. Media voorbereiden. Voeg websites/livestreams toe via Media → Nieuw, en video's via de Telvi Importer. Zet items in logische groepen.
2. Eigenschappen instellen. Bepaal per item de automatisering, het volume per item (tabblad Audio) en eventuele start-/eindscripts (tabblad Scripting).
3. Een format bouwen. Maak je dagschema in de Format-editor: regels met de juiste media, selectie en start-/eindtypes (Follow/Hard/User cue).
4. Playlists genereren. Kies in de Playlist builder je format en de dagen, en klik op Geselecteerde genereren. Bouw hier ook een Noodplaylist.
5. Controleren. Controleer in de Playlist viewer of alles klopt en er geen rode vlaggen zijn.
6. Uitzenden. Start de Telvi Player op de uitzend-pc (juiste scherm ingesteld via SHIFT+ESC). Hij speelt de afspeellijst automatisch af.
7. Live sturen. Houd de Cue Clock in de gaten, gebruik NEXT CUE voor handmatige cues, en grijp naar de Nood-override als je ooit direct moet overnemen.

17Beheer & goed om te weten

Een paar dingen die handig zijn voor beheerders en tijdens het draaien.

• Gedeelde datamap. Server en Player(s) delen de Telvi Data-map. Zet die op een betrouwbare, snelle locatie (lokaal of NAS) die alle machines kunnen bereiken.
• Meerdere players. Je kunt meerdere playouts draaien; ze lezen hetzelfde schema en reageren samen op cues en overrides. Telvi houdt via "heartbeats" bij welke players actief en gezond zijn.
• Noodplaylist. Bouw er altijd een (Playlist builder → Noodplaylist-tegel), zodat er nooit een zwart scherm ontstaat als de reguliere lijst leegloopt.
• Licentie. Houd de machine af en toe online; de licentie hercontroleert elke 15 minuten en tolereert tot 7 dagen offline. Verwijder je de licentie of het apparaat in het portaal, dan moet je opnieuw invoeren.
• Compliance-opname. Voor compliance kun je automatisch snapshots en audio/video opnemen (tabblad Compliance).
• Watchdog. Bewaakt de player en kan waarschuwen/ingrijpen bij problemen.
• Beveiliging. Wachtwoorden worden gehasht opgeslagen; houd het inlogscherm in productie aan en wijzig het standaard beheerderswachtwoord.
• Logs. Bij twijfel: check de Logs - daar zie je live wat er gebeurt.

18Woordenlijst

19Bijlage: sneltoetsen