HandyCafe Docs
it-admin

Erste Schritte: IT-Administrator

Dieser Leitfaden behandelt die technische Einrichtung von HandyCafe. Am Ende haben Sie Server und Clients installiert, das Netzwerk konfiguriert, App-Menüs erstellt und die Fernverwaltung getestet.

Geschätzte Dauer: 5 Minuten (plus Bereitstellungszeit für Clients)

Schritt 1: Server und Clients installieren

Server-Installation:

  1. Stellen Sie sicher, dass Ihr Server-PC die Systemanforderungen erfüllt.
  2. Laden Sie den HandyCafe Server herunter und installieren Sie ihn auf Ihrem Verwaltungs-PC.
  3. Starten Sie den Server und schließen Sie den Ersteinrichtungsassistenten ab, um das Administratorkonto zu erstellen.
  4. Notieren Sie die lokale IP-Adresse des Server-PCs. Die Clients benötigen diese zur Verbindung.

Client-Installation (für jeden PC wiederholen):

  1. Laden Sie den HandyCafe Client auf jeden Kunden-PC herunter.
  2. Installieren und starten Sie den Client.
  3. Der Client sucht den Server im lokalen Netzwerk per mDNS-Erkennung.
  4. Falls der Server nicht automatisch gefunden wird, geben Sie die Server-IP-Adresse manuell in den Client-Einstellungen ein.
  5. Nach erfolgreicher Verbindung erscheint der Client im Admin-Panel des Servers.

Tipp: Nutzen Sie die automatische Benennung des Servers (Einstellungen > Clients), um Clients automatisch mit einem Präfix wie "PC #1", "PC #2" usw. zu benennen. Anzeigenamen können Sie später anpassen.

Siehe Server-Installation und Client-Installation für detaillierte Schritte.

Schritt 2: Netzwerkeinstellungen konfigurieren

Navigieren Sie zu Einstellungen > Netzwerk auf dem Server.

HandyCafe verwendet vier Ports für die Kommunikation:

Port Standard Zweck
TCP-Port 5001 Befehls- und Antwortkommunikation
Datei-Port 5002 Dateiübertragungen zwischen Server und Clients
Fernverwaltungs-Port 5003 Steuerung des Remote-Desktop-Streamings
UDP-Port 5004 Bildschirmstreaming-Daten

Konfiguration:

  1. Legen Sie die Ports fest (Standardwerte funktionieren für die meisten Setups).
  2. Setzen Sie den Verbindungsschlüssel. Dies ist ein gemeinsames Geheimnis für die HMAC-SHA256-Authentifizierung. Alle Clients müssen denselben Schlüssel verwenden.
  3. Klicken Sie auf Speichern.

Firewall-Regeln:

Stellen Sie sicher, dass diese Ports sowohl auf dem Server als auch auf den Client-PCs geöffnet sind:

  • TCP: 5001, 5002, 5003 (eingehend auf Server, ausgehend auf Clients)
  • UDP: 5004 (bidirektional für Bildschirmstreaming)

Wichtig: Alle PCs müssen sich im selben lokalen Netzwerk (Subnetz) befinden. HandyCafe verwendet mDNS zur Client-Erkennung, was LAN-Konnektivität voraussetzt.

Siehe Netzwerkeinstellungen für alle Netzwerkoptionen.

Schritt 3: Client-Menü einrichten

Das Client-Menü ist der App-Launcher, den Kunden auf ihrem Desktop sehen. Navigieren Sie zu Einstellungen > Clients > Inhalt-Reiter.

  1. Kategorien erstellen. Gruppieren Sie Apps nach Typ (z. B. Spiele, Browser, Soziale Medien, Tools).
  2. Apps hinzufügen zu jeder Kategorie:
    • Legen Sie App-Name und Beschreibung fest.
    • Wählen Sie die App-Art: Spiel, Browser, Link, Datei oder App.
    • Geben Sie den Pfad zur ausführbaren Datei oder den Start-URI an.
    • Laden Sie ein Symbol und optional ein Posterbild für die App-Karte hoch.
  3. Reihenfolge ändern von Kategorien und Apps per Ziehgriff.
  4. Sichtbarkeit umschalten, um Elemente ein- oder auszublenden.
  5. Klicken Sie auf Speichern.

Änderungen werden automatisch in Echtzeit per TCP an alle verbundenen Clients übertragen.

Tipp: Nutzen Sie die IGDB-Integration, um Spielmetadaten und Symbole automatisch zu suchen.

Siehe Client-Menü für die vollständige Dokumentation des Menü-Builders.

Schritt 4: Leerlaufbildschirm und Erscheinungsbild konfigurieren

Leerlaufbildschirm (Einstellungen > Clients > Leerlaufbildschirm-Reiter):

Der Leerlaufbildschirm ist das, was Kunden sehen, wenn keine Sitzung aktiv ist (der Sperrbildschirm).

  1. Aktivieren Sie die Leerlaufbildschirm-Diashow.
  2. Fügen Sie Bilder oder Videos hinzu (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Legen Sie die Dauer pro Element und den Übergangseffekt fest (Einblenden, Gleiten, Zoomen).
  4. Optional können Sie eine Uhrenanzeige und die Cafe-Namensanzeige mit benutzerdefinierten Farben aktivieren.
  5. Klicken Sie auf Speichern.

Erscheinungsbild (Einstellungen > Clients > Erscheinungsbild-Reiter):

Konfigurieren Sie das Aussehen des Online-Desktops, den Kunden während der Sitzungen nutzen.

  1. Wählen Sie ein Design: Neon Arena, Crimson Pulse oder Emerald Depth.
  2. Wählen Sie ein Layout-Preset: Split Classic, Hero Wide Top, Catalog Wide Bottom oder Compact Focus.
  3. Konfigurieren Sie den Hintergrund: Volltonfarbe, Farbverlauf, Bild oder Video mit Overlay- und Unschärfe-Einstellungen.
  4. Passen Sie Kartendichte (Groß, Mittel, Kompakt) und Hover-Effekte an.
  5. Klicken Sie auf Speichern.

Siehe Client-Leerlaufbildschirm und Client-Erscheinungsbild für alle Optionen.

Schritt 5: Remote-Desktop und Screenshots testen

Überprüfen Sie, ob die Fernverwaltung funktioniert:

Screenshots:

  1. Wählen Sie im Admin-Panel eine beliebige Online-Client-Karte aus.
  2. Klicken Sie auf Screenshot auf der Client-Karte.
  3. Ein Screenshot des Client-Bildschirms erscheint im Viewer.
  4. Sie können den Screenshot herunterladen oder aktualisieren.

Remote-Desktop:

  1. Wählen Sie eine Online-Client-Karte aus und klicken Sie auf Remote-Desktop.
  2. Ein Remote-Desktop-Fenster öffnet sich mit Live-H.264-Streaming.
  3. Sie können Maus und Tastatur auf dem Remote-PC steuern.
  4. Die Zwischenablage-Synchronisierung funktioniert zwischen Server und Client.

Hinweis: Remote-Desktop verwendet UDP-Streaming. Falls das Video verzögert ist, prüfen Sie Ihre Netzwerkbandbreite und stellen Sie sicher, dass UDP-Port 5004 nicht blockiert ist. Sie können die Bitrate in den Stream-Einstellungen anpassen (350-25.000 kbps).

Siehe Remote-Desktop und Screenshots für alle Fernzugriffsfunktionen.

Netzwerkarchitektur im Überblick

Server-PC (Verwaltung)
    |
    |--- TCP (5001) --- Befehle/Antworten (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Dateiübertragungen
    |--- TCP (5003) --- Fernverwaltungssteuerung
    |--- UDP (5004) --- Bildschirmstreaming (H.264)
    |--- mDNS ------- Client-Erkennung (automatisch)
    |
    +-- Client-PC 1
    +-- Client-PC 2
    +-- Client-PC 3
    +-- ...

Nächste Schritte