Skip to content

WhatsApp

Michael Massee edited this page Aug 10, 2026 · 2 revisions

WhatsApp

Turnier-Inhalte (Teilnehmerliste, aktuelle Spielrunde, Rangliste, ein beliebiges Blatt oder eine freie Zellauswahl) lassen sich direkt aus Calc heraus als Bild in einen WhatsApp-Chat posten — ohne Umweg über Screenshot-Tools oder manuelles Fotografieren des Bildschirms.

Warum?

Für viele Turniere existiert bereits eine eigene WhatsApp-Gruppe (Teilnehmer, Verein, Helfer). Mit dieser Funktion lässt sich die aktuelle Teilnehmerliste, die nächste Spielrunde oder die laufende Rangliste mit einem Klick direkt aus Calc in genau diese Gruppe posten.

Wichtige Einschränkung: Das Feature braucht eine bestehende Internetverbindung — die lokale WhatsApp-Bridge verbindet sich über das Internet mit WhatsApp, sowohl beim einmaligen Login als auch bei jedem einzelnen Post. Ist am Turnierort kein oder nur unzuverlässiges Internet verfügbar (z. B. auf abgelegenen Boulodromes), lässt sich WhatsApp-Posting nicht nutzen. Alle übrigen PTM-Funktionen (Turnierverwaltung, Auslosung, Ranglisten, Export) bleiben davon unberührt und funktionieren weiterhin komplett offline.

Video

PTM Update v5.37.0: Ergebnisse direkt per WhatsApp an Spieler & Gruppen senden

Installation

Ein separates Zusatzmodul ist nicht nötig — die Einrichtung erfolgt automatisch beim ersten Gebrauch:

  1. Beim ersten Klick auf Login / QR-Code (Optionsseite, siehe Konfiguration) oder beim ersten Versuch, etwas zu posten, erscheint der Dialog „WhatsApp-Unterstützung einrichten":

    Für WhatsApp wird ein lokales Zusatzmodul benötigt. Portable Node.js und die WhatsApp-Bridge werden in ~/.petanqueturniermanager/whatsapp/ installiert. Jetzt einrichten?

  2. Nach Bestätigung lädt PTM eine portable Node.js-Laufzeit herunter, prüft deren Prüfsumme und installiert anschließend die WhatsApp-Bridge (Node-Abhängigkeiten) — beides ausschließlich im Benutzerprofil, ohne Eingriff ins System. Der Status wird währenddessen live angezeigt (Download, Einrichtung, Bridge-Installation).
  3. Danach startet PTM bei Bedarf automatisch einen lokalen Bridge-Prozess (nur auf localhost erreichbar, kein offener Netzwerkport nach außen).
  4. Abschließend Login / QR-Code erneut klicken: Der QR-Code öffnet sich im Standardbrowser — mit dem Smartphone (WhatsApp → Verknüpfte Geräte → Gerät hinzufügen) scannen, fertig.

Voraussetzungen:

  • Internetverbindung (Erstinstallation und laufender Betrieb)
  • Windows, Linux oder macOS — dieselben Plattformen wie PTM selbst
  • Kein separat zu installierendes Node.js nötig — PTM bringt eine eigene portable Version mit

Wird die Einrichtung im Dialog abgebrochen, bleibt WhatsApp-Posting schlicht deaktiviert; die Einrichtung kann jederzeit erneut über Login / QR-Code gestartet werden.

Konfiguration

Erreichbar über Extras → Optionen → PétTurnMngr → WhatsApp-Chats für Turnier-Posts.

Chat-Liste

Element Beschreibung
Liste der Chats Zeigt alle konfigurierten WhatsApp-Chats (Name, Typ, ggf. Favorit-Markierung)
Hinzufügen Fügt Chats hinzu, die über Chats aktualisieren aus der Bridge geladen wurden
Bearbeiten Bearbeitet den ausgewählten Chat-Eintrag
Klonen Legt eine Kopie des ausgewählten Chat-Eintrags an
Löschen Entfernt den ausgewählten Chat-Eintrag aus der Liste
Favorit Markiert den ausgewählten Chat als Favorit
Login / QR-Code Startet die WhatsApp-Bridge (inkl. Erstinstallation falls nötig) und zeigt bei Bedarf den QR-Code zum Verbinden des WhatsApp-Kontos
Chats aktualisieren Lädt die aktuelle Chat-Liste aus dem verbundenen WhatsApp-Konto und gleicht sie mit der lokalen Liste ab
Status-Zeile Zeigt den aktuellen Bridge-/Verbindungsstatus, z. B. „Bereit. Login starten oder Chats aktualisieren.", „WhatsApp verbunden.", „WhatsApp nicht verbunden: …"

Favoriten

Sind ein oder mehrere Chats als Favorit markiert, zeigt der Chat-Auswahl-Dialog beim Posten (siehe unten) ausschließlich die favorisierten Chats zur Auswahl an. Ist kein Favorit gesetzt, stehen alle konfigurierten Chats zur Auswahl. Praktisch, um z. B. aus vielen bekannten Chats gezielt nur die für Turnier-Posts relevante Gruppe anzubieten.

Chat-Auswahl-Dialog (beim Posten)

Beim Klick auf eine der Post-Aktionen (siehe Funktionen) erscheint der Dialog „WhatsApp-Chat auswählen":

Element Beschreibung
Zielchat Auswahl aus den Favoriten (bzw. allen Chats, falls keine Favoriten gesetzt sind)
Kopf-/Fußzeile einschließen Checkbox, standardmäßig aus; bestimmt, ob die im Turnier konfigurierten Kopf-/Fußzeilentexte (siehe Konfiguration, Abschnitt „Kopf- und Fußzeilen") im geposteten Bild mit erscheinen

Die zuletzt getroffene Auswahl (Chat + Kopf-/Fußzeile-Einstellung) wird pro Dokument gemerkt und beim nächsten Post vorausgewählt. Ein Klick auf Abbrechen bricht den Post-Vorgang ohne Fehlermeldung ab.

Funktionen

Alle Aktionen sind sowohl über das Menü PétTurnMngr → WhatsApp als auch über die WhatsApp-Toolbar erreichbar. Jede Aktion rendert den jeweiligen Inhalt als Bild (PNG, exakt auf den tatsächlichen Inhalt zugeschnitten) und öffnet danach den Chat-Auswahl-Dialog.

Teilnehmerliste posten

Postet die aktuelle Teilnehmerliste (Meldeliste) des Turniers.

Aktuelle Spielrunde posten

Postet die aktuell laufende Spielrunde. Je nach Turniersystem heißt die Aktion im Post-Titel unterschiedlich: bei Jeder gegen Jeden, Liga und Trip-Tête erscheint sie als „Spielplan", bei K.-o.-System als „Turnierbaum", bei den übrigen Systemen als „Aktuelle Spielrunde".

Rangliste posten

Postet die aktuelle Rangliste. Vor dem Rendern wird die Rangliste bei Bedarf automatisch neu berechnet, damit der Post immer den aktuellen Stand zeigt.

Aktuelles Blatt posten

Postet das gerade aktive Tabellenblatt (das im Dokument sichtbare Blatt), unabhängig vom Turniersystem — praktisch für Blätter, die keine eigene Post-Aktion haben.

Selektion posten

Postet nur den aktuell markierten Zellbereich des aktiven Blatts. Voraussetzungen:

  • Es muss vor dem Klick eine Zellauswahl bestehen (whatsapp.post.fehler.keine.selektion, falls nicht).
  • Es wird nur ein einzelner, zusammenhängender Bereich unterstützt — eine Mehrfachauswahl (mehrere getrennte Bereiche mit gedrückter Strg-Taste) führt zu einer Fehlermeldung (whatsapp.post.fehler.mehrfachselektion).

Gemeinsame Voraussetzungen aller Aktionen

  • Es muss mindestens ein WhatsApp-Chat konfiguriert sein (siehe Konfiguration).
  • Das jeweilige Blatt muss für das Turnier bereits erzeugt worden sein — bei Teilnehmerliste, Spielrunde und Rangliste wird das zugehörige Blatt automatisch gesucht; existiert es noch nicht, erscheint ein Hinweis, es zunächst über das PétTurnMngr-Menü anzulegen.

Fehlerbehandlung

Meldung Ursache Lösung
„WhatsApp ist noch nicht verbunden (Status: …). Bitte unter Extras > Optionen > PétTurnMngr > WhatsApp-Chats auf „Login / QR-Code" klicken und anmelden." Die Bridge läuft (noch) nicht oder das WhatsApp-Konto ist nicht verbunden Optionsseite öffnen, Login / QR-Code klicken und den QR-Code erneut scannen
„Es sind noch keine WhatsApp-Chats konfiguriert. Bitte unter Extras > Optionen > PétTurnMngr > WhatsApp-Chats einrichten." Die Chat-Liste ist leer Auf der Optionsseite Chats aktualisieren klicken (lädt Chats aus dem verbundenen Konto) und mindestens einen Chat mit Hinzufügen übernehmen
„{Blattname}" wurde für dieses Turnier noch nicht erzeugt. Bitte zuerst über das PétTurnMngr-Menü anlegen und dann erneut versuchen." Das für die Aktion benötigte Blatt (z. B. Rangliste) existiert im Dokument noch nicht Das Blatt zunächst regulär über das PétTurnMngr-Menü erzeugen, dann die Post-Aktion erneut ausführen
„Bitte zuerst Zellen markieren, die gepostet werden sollen." Selektion posten wurde ohne aktive Zellauswahl aufgerufen Gewünschten Zellbereich markieren, dann erneut posten
„Mehrfachauswahl wird nicht unterstützt. Bitte einen einzelnen zusammenhängenden Bereich auswählen." Bei Selektion posten war mehr als ein getrennter Bereich markiert Nur einen zusammenhängenden Bereich markieren
WhatsApp-Bridge-Prozess startet nicht / bricht ab Häufig ein blockierter Port, eine unterbrochene Erstinstallation oder fehlende Internetverbindung LibreOffice neu starten und erneut versuchen; bei dauerhaftem Fehler das Verzeichnis ~/.petanqueturniermanager/whatsapp/ löschen, damit die Einrichtung beim nächsten Login-Versuch neu durchläuft
Setup-Dialog wurde abgebrochen Der Einrichtungsdialog wurde mit „Nein" beantwortet Login / QR-Code erneut klicken und den Dialog diesmal bestätigen

Alle Post-Vorgänge protokollieren Fehler zusätzlich im PTM-Logfile (siehe Konfiguration → Log-Level) — bei unklaren Fehlern hilft ein Blick dorthin.

Siehe auch

  • Konfiguration — globale Plugin-Einstellungen und Kopf-/Fußzeilen-Texte
  • Webserver — alternativer Weg, Turnierdaten öffentlich zugänglich zu machen (statt aktiv zu posten)

Clone this wiki locally