IntroTimer - Installatiehandleiding

IntroTimer is een webapplicatie voor tijdbeheer bij presentatie-introductierondjes. Deelnemers worden als screenshots (afbeeldingen) geladen, met een timer als gekleurde rand.

Snelle start

Mac

1. Open Terminal (zoek via Spotlight: Cmd+Spatie, typ "Terminal")
2. Ga naar de map waar je IntroTimer hebt uitgepakt:

   cd pad/naar/introtimer
   

3. Maak het setup-script uitvoerbaar en draai het:

   chmod +x setup.sh
   sh setup.sh
   

4. De app opent automatisch in je browser op http://localhost:5175

Windows

1. Open PowerShell (zoek in Start-menu naar "PowerShell")
2. Ga naar de map waar je IntroTimer hebt uitgepakt:

   cd pad\naar\introtimer
   

3. Draai het setup-script:

   powershell -ExecutionPolicy Bypass -File setup.ps1
   

4. De app opent automatisch in je browser op http://localhost:5175

Wat doet het setup-script?

Het script doet drie dingen:

1. Controleert of Node.js geinstalleerd is en of de versie nieuw genoeg is (minimaal versie 18)
2. Installeert de benodigde packages (via npm install)
3. Start de applicatie (via npm run dev)

Je hoeft verder niets handmatig te doen.

Handmatige installatie (als het script niet werkt)

Als het setup-script om welke reden dan ook niet werkt, kun je het handmatig doen:

1. Open een terminal/command prompt
2. Controleer of Node.js werkt:

   node --version
   

   Je zou iets als v18.x.x of hoger moeten zien. Zie je een foutmelding? Installeer Node.js via https://nodejs.org (kies de LTS-versie).
3. Ga naar de introtimer-map:

   cd pad/naar/introtimer
   

4. Installeer de packages:

   npm install
   

5. Start de app:

   npm run dev
   

6. Open je browser en ga naar http://localhost:5175

De app gebruiken

Deelnemers toevoegen

1. Druk op Esc om het bewerkingspaneel te openen
2. Upload screenshots van de deelnemers (bijv. foto's of naamkaartjes)
3. Stel de timer in (standaard: 60 seconden)
4. Sleep deelnemers in de gewenste volgorde
5. Druk op Esc om het paneel te sluiten

Presentatie bedienen

• Klik op Start om de eerste deelnemer te tonen met timer
• Spatie of pijl rechts: volgende deelnemer
• Pijl links: vorige deelnemer
• Esc: bewerkingspaneel openen (stopt de timer)

Timer

De rand rond de afbeelding werkt als timer:

• Groen: nog genoeg tijd
• Oranje: tijd loopt op
• Rood: bijna geen tijd meer

Na de laatste deelnemer verschijnt een zwart eindscherm.

Stoppen

Druk in de terminal op Ctrl+C om de app te stoppen.

Problemen?