Handbuch & Dokumentation

Willkommen bei HandballMetrics. Dieses Handbuch führt Dich durch alle Module der App, damit Du vom initialen Setup über das Live-Scouting bis hin zur detaillierten Analyse professionell und effizient arbeiten kannst.

1. Setup & Vorbereitung (Setup-Tab)

Der Startpunkt jedes Spiels. Hier konfigurierst Du die Rahmenbedingungen und die Kader.

• Spielverwaltung: Über Neues Spiel startest Du eine leere Sitzung. Mit Spiel speichern kannst Du den aktuellen Stand jederzeit als JSON-Datei lokal herunterladen und später über Spiel laden / Spiel fortsetzen exakt dort weitermachen, wo Du aufgehört hast (inkl. Uhrzeit und Statistiken).
• Spielregeln: Wähle die Spieldauer (z.B. 2 x 30 Min.) und die Timeout-Regel (3 pro Spiel oder 1 pro Halbzeit). Dies beeinflusst die automatische Freischaltung der T1/T2 Buttons im Match-Tab. In den letzten 5 Spielminuten wird die Anzahl der Timeouts automatisch auf eine pro Team beschränkt.
• Kaderverwaltung & Excel: Trage Spieler manuell ein oder nutze den Excel Import. Die Excel-Datei benötigt keine Kopfzeile, muss aber das Format: Spalte A = Nummer, Spalte B = Nachname, Spalte C = Vorname haben. Über Team Export kannst Du bestehende Kader für zukünftige Spiele als Excel speichern.
• WICHTIG (TW-Checkbox): Markiere jeden Torhüter zwingend mit dem Haken bei TW. Nur so schaltet das System die Paraden-Statistiken frei und berücksichtigt den Spieler korrekt für Quoten und Heatmaps.

2. Das Live-Scouting (Match-Tab)

Das Herzstück während des Spiels. Es ist auf Schnelligkeit und Fehlervermeidung (Poka-Yoke) optimiert. Die Erfassung ist so konzipiert, dass immer zuerst der betreffende Spieler ausgewählt wird und dann die Aktion. Bei einer Parade wird der Torhüter ausgewählt und dann im weiteren Verlauf automatisch der werfende Spieler des Gegners abgefragt.

• Aktionserfassung (Der Flow):
  1. Aktiven Torhüter des Gegners prüfen (Dropdown oben).
  2. Eignen Spieler anklicken (wird blau markiert).
  3. Angriffsphase wählen (Position, 1. Welle, etc.).
  4. Aktion klicken (z.B. TOR oder PARADE).
  5. Es öffnet sich ein Pop-Up für Abwurfort, Einschlag im Tor und ggf. den Assistgeber oder Werfer.
• Ballbesitz (Poka-Yoke): Die App denkt mit. Wenn Team A z.B. einen Steal verzeichnet, wechselt der Ballbesitz automatisch zu Team A. Umgekehrt wechselt der Ballbesitz z.B. zu Team B, wenn für Team A ein Schrittfehler erfasst wird.
• 7-Meter Modus: Aktiviere den großen schwarzen 7-METER MODUS Button. Die nächste Aktion wird automatisch als 7-Meter gewertet (inkl. speziellem 7m-Spielfeld). Danach deaktiviert sich der Modus von selbst.
• Daten editieren: Aktion verpasst? Gehe jederzeit im Menü auf "Daten editieren" und klicke auf + Aktion hinzufügen. Gib die Zeit ein. Du landest im Match-Tab, der sich nun gelb/orange einfärbt. Die nächste erfasste Aktion wird exakt zu diesem Zeitpunkt in die Historie eingeschoben. Ebenso kann eine falsch erfasste Aktion über die Dropdown-Menüs geändert oder auch vollständig gelöscht werden. Die App berechnet im Hintergrund sofort alle Spielstände, Quoten und Heatmaps neu. Diese Funktionen eignen sich auch für eine Anpassung der Live-Daten bei einer nachfolgenden Videoanalyse.
• Undo-Funktion & Feed: Unten rechts findest Du die letzte Aktion. Vertippt? Klicke auf Undo, um die Aktion rückgängig zu machen.

3. Analyse & Auswertung (Analyse-Tab)

Hier werden die rohen Daten in aussagekräftige Grafiken und Tabellen umgewandelt (Live-Updates während des Spiels).

• Momentum- & Butterfly-Chart: Oben siehst Du den Spielverlauf (wer hatte wann einen Lauf?) und darunter einen direkten Team-Vergleich (Tore, Paraden, Assists, Fehler) als Schmetterlings-Diagramm.
• Detaillierte Tabellen & Rankings: Getrennte Auswertungen für Feldspieler und Torhüter. Die Rankings küren automatisch die Topscorer und Torschützen.
• Interaktive 3D-Heatmaps & Rays:
  • Du siehst Spielfeld und Tor für verschiedene Szenarien (Normal, 7m, Paraden).
  • Filterfunktion: Klicke auf eine Zone im Spielfeld (z.B. Linksaußen). Das Tor rechts daneben filtert sich sofort und zeigt Dir exakt, wohin die Würfe von Linksaußen gingen. Außerdem lassen sich mehrere Zonen gemeinsam betrachten, indem sie nacheinander angeklickt werden. Durch Abwählen (Anklicken) der markierten Zonen oder durch Anklicken aller Zonen lässt sich wieder der Standard – Anzeigen aller Zonen gemeinsam – aktivieren.
  • Wurf-Strahlen: Mit der Checkbox "Rays" visualisierst Du die exakten Flugbahnen vom Abwurfort zum Tor. Grün = Erfolg (Tor/Parade für das eigene Team), Rot = Misserfolg, Blau (gestrichelt) = Block.
• Export & PDF-Druck:
  • CSV: Lade die Rohdaten aller Spieler für Dein eigenes Excel herunter.
  • Bericht drucken: Generiert ein professionelles, mehrseitiges PDF. Inklusive Deckblatt, Team-Head-to-Head, Wurfbildern jedes einzelnen Spielers und einem chronologischen Scoutfeed.

4. Video-Scouting & Analyse (Video-Tab)

Das Video-Modul ermöglicht die nahtlose Verknüpfung Deiner erfassten Scouting-Daten mit den tatsächlichen Spielszenen. Ideal zur Nachbereitung, zur Erstellung von Highlight-Clips oder für Halbzeit- und Teambesprechungen.

• Video Player & Grundlagen:
  • LADEN: Lade ein Youtube-Video. HandballMetrics nutzt die offizielle YouTube-API, um Videos nahtlos als Stream einzubetten und die exakten Zeitstempel für das Scouting in Echtzeit auszulesen, ohne eigenen Speicherplatz zu beanspruchen.
  • 📁 Lokal: Lade eine lokale Videodatei (MP4, WebM etc.) von Deinem Gerät. Das Video wird nicht ins Internet hochgeladen, alles bleibt lokal und schnell auf Deinem Gerät.
  • 🎥 Match-Scouting: Dieser Button wechselt in den Match-Tab und aktiviert dort direkt das Video-Scouting (der Player erscheint über den Scouting-Buttons). Perfekt, um ein Spiel komplett anhand des Videos zu erfassen.
  • Abspielgeschwindigkeit: Über die Buttons 0.5x, 1.0x und 1.5x kannst Du das Video in Zeitlupe, normal oder beschleunigt abspielen.
• Synchronisation (Live-Scouting vs. Video-Scouting):
  • Modus "Live-Scouting": Hast Du das Spiel live in der Halle getrackt, passen die Zeiten der App nicht exakt zur Videodatei. Um sie zu synchronisieren, suche im Video den genauen Moment des Anpfiffs der 1. Halbzeit und klicke auf Anpfiff H1 Setzen. Wiederhole dies für die 2. Halbzeit (Anpfiff H2 Setzen). Die App berechnet nun alle Aktionszeiten automatisch passgenau zum Video.
  • Modus "Video-Scouting": Hast Du das Spiel direkt in der App per Video gescoutet, sind die Zeiten bereits absolut synchron. Ein Klick auf ▶ Zum Anpfiff springen bringt Dich sofort zum Start.
• Playlist & Filter (Szenen finden):
• Sequenzen markieren: Im Match-Tab findest du unter dem Video den Button "🎬 Sequenz markieren". Ein Klick darauf öffnet ein Pop-Up, in dem du eine kurze Beschreibung der Szene eingeben kannst. Die exakte Video-Zeit wird dabei sofort eingefroren und gespeichert. Deine Beschreibung erscheint anschließend direkt in der Video-Playlist und im Tab "Daten editieren" (wo du sie auch nachträglich noch ändern kannst). Diese Szenen werden automatisch als Highlight (Stern) markiert und werden in der Playlist ausschließlich dann angezeigt, wenn du den Filter "Highlights" im Video-Tab aktivierst.

• Filter Dropdowns: Filtere die Ereignisse punktgenau nach Team, Spieler, Wurfzone oder Angriffsphase.
• Aktions-Filter (Checkboxen): Wähle per Klick aus, welche Aktionen in der Liste landen sollen (z.B. nur Tore, Fehlwürfe, Paraden, Blocks, Steals etc.).
• Szenen abspielen: Klicke einfach auf einen Eintrag in der Playlist (z.B. "Tor von #7"), und der Player springt sofort zu dieser Szene.
• Pre (s) & Post (s): Bestimme, wie viele Sekunden vor und nach dem eigentlichen Ereignis-Zeitpunkt der Clip starten und enden soll (Standard: 4 Sek. davor, 2 Sek. danach).
• Auto Next: Ist diese Checkbox aktiviert, springt die App nach dem Ende eines Clips automatisch zur nächsten Szene in Deiner gefilterten Liste.
• Zeichentools & Taktikboard (Canvas):
  • Zeichnen: Aktiv (Checkbox): Setze den Haken, um den Player zu pausieren und das Video in ein interaktives Taktikboard zu verwandeln.
  • Werkzeuge: Wähle zwischen Stift (Freihand), Pfeil (zeigt Richtung an), Rechteck oder Kreis, um Räume und Laufwege zu markieren.
  • Farbwähler (Pipette): Klicke auf das Farbkästchen links neben den Buttons, um die Farbe Deiner Zeichnungen anzupassen.
  • ↩ Undo: Macht Deinen jeweils letzten Zeichenschritt rückgängig.
  • Löschen: Entfernt alle Zeichnungen komplett vom Bildschirm.
  • 📸 Screenshot: Erstellt ein hochauflösendes Bild der aktuellen Szene inklusive all Deiner Einzeichnungen und lädt es herunter. Ideal, um Szenen per WhatsApp an Spieler zu schicken oder in Präsentationen einzubauen.
• Shortcuts (Schnellbedienung): Für den perfekten Workflow am Laptop kannst Du das Video per Tastatur steuern:
  • Leertaste: Play / Pause
  • Pfeil Links / Rechts: Spult im Video 2 Sekunden vor oder zurück
  • Pfeil Hoch / Runter: Springt direkt zum vorherigen oder nächsten Clip in der gefilterten Playlist

5. Taktikboard (Taktik-Tab)

Das digitale Taktikboard für Spielzüge, Laufwege und die Visualisierung von Wurfquoten.

• Spieler & Ball bewegen (Smart Drag): Wähle das Werkzeug "Bewegen" und ziehe die Spieler aus der Ersatzbank auf das Feld. Ist Smart Drag aktiviert, zeichnet die App automatisch den Laufweg (bzw. den Pass), sobald Du eine Figur bewegst.
• Zeichen-Werkzeuge: Neben freiem Zeichnen kannst Du Pässe (gestrichelt), Laufwege (Pfeil) und Blocks direkt auf das Feld malen.
• Formationen (Presets): Nutze die Schnellwahl für Abwehr (z.B. 6:0, 3:2:1) oder Angriff (z.B. Breit, 7-gg-6), um die Spieler automatisch auf dem Feld zu positionieren.
• Spielfeld-Ansichten: Wechsle zwischen Ganzfeld und Halbfeld. Über das Vollbild-Icon (neben Smart Drag) kannst Du das Feld auf dem gesamten Monitor maximieren.
• Wurfquoten Overlay: Blende die tatsächlichen Heatmap-Wurfquoten des aktuellen Spiels live in das Taktikboard ein, um Deine Abwehr oder Deinen Angriff optimal auf den Gegner abzustimmen.