2. Handbuch

2.1. Einführung

blunderDB ist eine Software zum Erstellen von Datenbanken mit Backgammon-Stellungen. Ihre größte Stärke besteht darin, einen einzigen Ort zu bieten, an dem ein Spieler die Stellungen sammeln kann, die ihm begegnet sind (online, im Turnier), und sie erneut studieren kann, indem er sie nach verschiedenen beliebig kombinierbaren Filtern filtert. blunderDB kann außerdem verwendet werden, um Kataloge von Referenzstellungen zu erstellen.

Die Stellungen werden in einer Datenbank gespeichert, die durch eine Datei .db dargestellt wird.

2.2. Wichtigste Interaktionen

Die wichtigsten mit blunderDB möglichen Interaktionen sind:

  • eine neue Stellung hinzufügen,

  • eine bestehende Stellung bearbeiten,

  • das Brettbild über Ctrl+X in die Zwischenablage kopieren (PNG) oder mit der vollständigen Analyse über Ctrl+X Ctrl+X,

  • eine bestehende Stellung löschen,

  • eine oder mehrere Stellungen suchen,

  • Matches aus verschiedenen Quellen importieren (XG, GNUbg, BGBlitz, Jellyfish), einschließlich der Kommentare aus XG-Dateien,

  • durch die Züge eines importierten Matches navigieren,

  • Stellungen in Sammlungen organisieren,

  • Matches in Turnieren organisieren.

Der Benutzer kann Stellungen frei mit Tags versehen und sie mit Kommentaren annotieren.

2.3. Beschreibung der Benutzeroberfläche

Die Benutzeroberfläche von blunderDB besteht von oben nach unten aus:

  • [oben] der Werkzeugleiste, die alle wichtigen auf der Datenbank ausführbaren Operationen zusammenfasst,

  • [in der Mitte] dem Hauptanzeigebereich, der das Anzeigen oder Bearbeiten von Backgammon-Stellungen ermöglicht,

  • [unten] der Statusleiste, die verschiedene Informationen über die Datenbank oder die aktuelle Stellung anzeigt und die Befehlszeile integriert.

Es können Panels angezeigt werden, um:

  • die mit der aktuellen Stellung verknüpften Analysedaten aus eXtreme Gammon (XG), GNUbg oder BGBlitz anzuzeigen,

  • Kommentare anzuzeigen, hinzuzufügen oder zu bearbeiten,

  • Stellungen nach kombinierbaren Kriterien zu suchen und zu filtern,

  • Stellungssammlungen anzuzeigen und zu verwalten (Sammlungen-Panel),

  • die Liste der importierten Matches anzuzeigen und durch die Züge eines Matches zu navigieren (Matches-Panel),

  • Turniere anzuzeigen und zu verwalten (Turnier-Panel),

  • Leistungsstatistiken anzuzeigen (Stats-Panel),

  • den EPC (Effective Pip Count) einer Bearoff-Stellung zu berechnen (Bearoff-Panel),

  • Stellungen durch verteiltes Wiederholen zu studieren (Anki-Panel),

  • die Metadaten der Datenbank anzuzeigen (Metadaten-Panel).

Es können modale Fenster angezeigt werden, um:

  • die Hilfe von blunderDB anzuzeigen,

  • den Katalog der geführten Touren anzeigen (siehe Geführte Touren und Beispieldatenbank),

  • den Export der Datenbank zu konfigurieren,

  • blunderDB zu konfigurieren, insbesondere die Sprache der Benutzeroberfläche (siehe Konfiguration).

Der Hauptanzeigebereich stellt dem Benutzer Folgendes bereit:

  • ein Brett, um eine Backgammon-Stellung anzuzeigen oder zu bearbeiten,

  • den Wert und den Besitzer des Dopplers,

  • den Pip-Count jedes Spielers,

  • den Punktestand jedes Spielers,

  • die zu spielenden Würfel. Wenn auf den Würfeln keine Werte angezeigt werden, gibt die Position der Würfel an, welcher Spieler am Zug ist und dass die Stellung eine Doppler-Entscheidung ist. Wenn die Doppler-Entscheidung eine Antwort auf ein Doppel ist (Annehmen/Aufgeben), wird der angebotene Dopplerwürfel in der Mitte des Bretts mit dem angebotenen Wert angezeigt.

Die Statusleiste ist von links nach rechts mit den folgenden Informationen aufgebaut:

  • die Befehlszeile, erreichbar durch Drücken der Taste LEERTASTE,

  • eine Informationsmeldung zu einer vom Benutzer ausgeführten Operation,

  • der Index der aktuellen Stellung, gefolgt von der Anzahl der Stellungen in der aktuellen Bibliothek (oder Zug-/Partie-Informationen beim Navigieren in einem Match).

Bemerkung

Bei Stellungen, die aus einer Suche des Benutzers stammen, entspricht die in der Statusleiste angegebene Anzahl der Stellungen der Anzahl der gefilterten Stellungen.

2.4. Ansichts-Reiter

Unter der Werkzeugleiste ermöglicht eine Reiterleiste, mit mehreren Ansichten parallel zu arbeiten. Jede Ansicht ist ein unabhängiger Arbeitsbereich, der seine eigene Positionsliste, den Index der aktuellen Position, die angezeigte Position, die Analyse und den ausgewählten Zug, das aktive Panel, den aktuellen Kommentar sowie den Navigationskontext in einem Match behält. So ist es zum Beispiel möglich, eine Suche in einer Ansicht offen zu halten, während man in einer anderen ein Match durchgeht.

  • Eine Ansicht erstellen: auf die Schaltfläche + der Reiterleiste klicken oder CTRL-T drücken. Die neue Ansicht startet als Kopie der aktuellen Ansicht.

  • Eine Ansicht schließen: auf das Kreuz des Reiters klicken oder CTRL-W drücken. Die letzte Ansicht kann nicht geschlossen werden.

  • Die Ansicht wechseln: auf einen Reiter klicken, CTRL-PageUp / CTRL-PageDown (oder UMSCHALT-J / UMSCHALT-K) drücken, um zur vorherigen / nächsten Ansicht zu wechseln, oder CTRL-1 bis CTRL-9, um direkt die n-te Ansicht zu erreichen.

  • Eine Ansicht umbenennen: auf den Reiter doppelklicken, den neuen Namen eingeben und mit EINGABE bestätigen.

Die Ansichten werden mit dem Sitzungszustand der Datenbank gespeichert und beim erneuten Öffnen wiederhergestellt.

2.5. Konfiguration

Le bouton de configuration (icône en forme de rouage) situé dans la barre d’outils, à gauche du bouton d’aide, ouvre la fenêtre de configuration de blunderDB. Elle est organisée en quatre onglets :

  • Oberfläche — Sprache, Anzeigeskalierung, Position des Panels;

  • Brettfarben — die Farben des Bretts;

  • Bearoff — la base de sortie two-sided étendue utilisée par le panneau Bearoff ;

  • Ausstelleridentität — der Schlüssel, mit dem Ihre Wasserzeichen signiert werden; beschrieben im Abschnitt Eine Datenbank weitergeben: Herkunft und Passwort.

Auf der Registerkarte Oberfläche kann die Sprache unter Englisch, Französisch, Deutsch, Italienisch, Spanisch, Finnisch, Japanisch, Griechisch und Russisch gewählt werden. Die gesamte Benutzeroberfläche (Werkzeugleiste, Panels, Meldungen, Hilfe) wird in die gewählte Sprache übersetzt. Die Sprachwahl wird gespeichert und über die Sitzungen hinweg beibehalten.

Le même onglet propose aussi le bouton Compacter la base, qui récupère l’espace disque laissé par les suppressions (matchs, tournois, purges) : la base de données ne rétrécit jamais toute seule quand on supprime des données, il faut demander explicitement ce compactage. L’opération peut prendre du temps sur une grosse base et nécessite, temporairement, environ deux fois sa taille en espace disque libre (blunderDB refuse de démarrer plutôt que de risquer un compactage interrompu) ; une confirmation est donc demandée avant de lancer l’opération. Le résultat — l’espace gagné, en mégaoctets — s’affiche ensuite dans la barre d’état. La même opération est disponible en ligne de commande via blunderdb vacuum (voir Befehlszeilenschnittstelle (CLI)).

Auf der Registerkarte Brettfarben lassen sich die Farben des Bretts anpassen. Jedes Element besitzt einen eigenen Farbwähler: der Hintergrund, der Rahmen, die hellen und dunklen Zungen, die Steine von Spieler 1 und Spieler 2, die Würfel, die Würfelaugen und der Dopplerwürfel. Die Schaltfläche Zurücksetzen stellt alle Standardfarben wieder her. Wie die Sprache bleiben auch die gewählten Farben von einer Sitzung zur nächsten erhalten.

L’onglet Bearoff gère la base two-sided qui étend le domaine exact du panneau Bearoff (voir Bearoff-Panel) au-delà de la base TS-06-06 embarquée dans l’exécutable. Il affiche le domaine actuellement actif (TS-06-06 ou TS-06-11 une fois téléchargée) et son origine, propose de lancer le téléchargement de la base étendue TS-06-11 avec une barre de progression, et reprend automatiquement un téléchargement interrompu au lieu de repartir de zéro (requêtes HTTP par plage). Une fois téléchargée, la base peut être supprimée — une confirmation est demandée avant toute suppression, la taille du fichier étant rappelée dans le message. L’onglet permet aussi de pointer vers un fichier .bd two-sided externe (par exemple une base générée soi-même) plutôt que d’utiliser le téléchargement intégré.

Das Konfigurationsfenster enthält außerdem Anzeigeeinstellungen für die Oberfläche. Ein Schieberegler für die Oberflächenskalierung ermöglicht es, alle Oberflächenelemente zu vergrößern oder zu verkleinern, was auf hochauflösenden Bildschirmen oder zur Verbesserung der Lesbarkeit nützlich ist. Ein Menü Panel-Position legt fest, wo die Panels (Suche, Matchs, Analyse) relativ zum Brett angezeigt werden: unten, seitlich oder automatisch (auf breiten Bildschirmen wird dann die seitliche Anordnung gewählt, um den verfügbaren Platz besser auszunutzen). Wie die anderen Einstellungen werden auch diese Festlegungen von einer Sitzung zur nächsten beibehalten.

2.6. Geführte Touren und Beispieldatenbank

Um den Einstieg zu erleichtern, bietet blunderDB geführte Touren durch die Oberfläche an. Der Katalog der Touren öffnet sich über die Symbolleiste oder mit dem Befehl tour (Alias tutorial). Es stehen vier Touren zur Verfügung: eine allgemeine Tour durch die Oberfläche sowie Touren zur Stellungssuche, zur Durchsicht der Matches und zur Durchsicht der Turniere. Jede Tour hebt Schritt für Schritt die betreffenden Elemente der Oberfläche hervor und kann jederzeit wiederholt werden. Beim ersten Start wird die allgemeine Tour automatisch angeboten.

Der Befehl demo lädt eine Beispieldatenbank (Matches, ein Turnier und Analysen), mit der sich die Funktionen des Werkzeugs erkunden lassen, ohne eigene Partien zu importieren. Die geführten Touren greifen auf diese Datenbank zurück, wenn keine Datenbank geöffnet ist.

2.8. Stellungen bearbeiten

Das Drücken der Taste TAB öffnet das Suchpanel und ermöglicht es, eine Stellung auf dem Brett zu bearbeiten, um sie der Datenbank hinzuzufügen oder eine zu suchende Stellungsstruktur zu definieren. Die Verteilung der Steine, des Dopplers, des Punktestands und des Zugrechts können mit der Maus geändert werden (siehe Eine Position bearbeiten).

Tipp

Siehe Tastenkürzel für die verfügbaren Tastenkürzel.

2.9. Die Befehlszeile

Die in die Statusleiste integrierte Befehlszeile ermöglicht es, alle in der grafischen Oberfläche verfügbaren Funktionen von blunderDB auszuführen: allgemeine Operationen auf der Datenbank, Stellungsnavigation, Anzeige der Analyse und/oder Kommentare, Suche nach Stellungen mittels Filtern … Nach einer ersten Einarbeitung in die Oberfläche empfiehlt es sich, allmählich die Befehlszeile zu verwenden, die eine leistungsfähige und flüssige Nutzung von blunderDB ermöglicht, insbesondere für die Funktionen zur Stellungssuche.

Um die Befehlszeile zu öffnen, drücken Sie die Taste LEERTASTE. Um eine Abfrage abzuschicken und die Befehlszeile zu schließen, drücken Sie die Taste EINGABE.

blunderDB führt die vom Benutzer gesendeten Abfragen aus, sofern sie gültig sind, und ändert gegebenenfalls sofort den Zustand der Datenbank. Es sind keine expliziten Speichervorgänge seitens des Benutzers erforderlich.

Tipp

Siehe Abschnitt 4 für die Liste der in der Befehlszeile verfügbaren Befehle.

2.10. Analyse-Panel

Das Panel Analyse (CTRL-L) zeigt die Analysedaten der aktuellen Stellung an, importiert aus eXtreme Gammon (XG), GNUbg oder BGBlitz. Es stellt die besten Alternativen (Steinzüge oder Doppler-Entscheidungen) mit ihren Equity-Werten und den entsprechenden Fehlern dar. Die Taste d schaltet zwischen der Analyse der Steinzüge und der Analyse des Dopplers um. Beim Navigieren in einem Match wird der tatsächlich gespielte Zug in der Liste der Alternativen hervorgehoben. Drücken Sie CTRL-L oder führen Sie den Befehl list aus, um das Panel ein- oder auszublenden.

2.11. Kommentare-Panel

Das Panel Kommentare (CTRL-P) zeigt die mit der aktuellen Stellung verknüpften Kommentare an, fügt sie hinzu und bearbeitet sie. Die aus XG-Dateien importierten Kommentare werden automatisch den entsprechenden Stellungen zugeordnet. Drücken Sie CTRL-P oder führen Sie den Befehl comment aus, um das Panel ein- oder auszublenden.

2.12. Such-Panel

Das Panel Suche (CTRL-F oder TAB) ermöglicht es, Stellungen nach frei kombinierbaren Kriterien zu filtern: Steinstruktur, Typ der Doppler-Entscheidung, Fehlergröße, Datum, Tags usw. Die Taste TAB öffnet gleichzeitig das Suchpanel und den Stellungseditor, sodass eine zu suchende Steinstruktur direkt auf dem Brett definiert werden kann.

Um eine Suche unter den aktuell gefilterten Stellungen zu verfeinern, verwenden Sie den Befehl ss gefolgt von Filtern (z. B.: ss nc, ss E>40). Das Suchpanel bietet für dieselbe Funktion auch ein Kontrollkästchen Search in current results.

Das Panel bietet eine explizite Steuerung des gesuchten Entscheidungstyps: Egal (kein Filter), Zug (Zugentscheidungen) oder Dopplung (Doppler-Entscheidungen). Wenn Dopplung ausgewählt ist, gibt eine zweite Liste den Untertyp an: Alle, Dopplung / Kein Doppel (der Spieler am Zug muss über das Doppeln entscheiden) oder Annehmen / Aufgeben (Antwort auf ein gegnerisches Doppel). Die Steuerung ist mit dem Brett synchronisiert: Ändert man die Würfel oder den Dopplerwürfel auf dem Brett, wird der Entscheidungstyp aktualisiert und umgekehrt. Im Modus Annehmen / Aufgeben wird der Dopplerwürfel mit dem angebotenen Wert in der Mitte des Bretts angezeigt; dieser Wert bleibt bearbeitbar.

Der Filter Markiert behält die Positionen, die Sie in der Ursprungssoftware der Partie markiert haben. Nur eXtreme Gammon erzeugt diese Information, die zugweise in der .xg-Datei gespeichert wird; blunderDB liest sie beim Import und behält sie bei. Eine markierte Dopplungsentscheidung ergibt zwei markierte Positionen, die Dopplung und das Annehmen/Aufgeben, da blunderDB in zwei Teile zerlegt, was die Quelldatei als eine einzige Entscheidung speichert.

Bemerkung

Die Markierung wirkt nicht rückwirkend: Bereits in der Datenbank vorhandene Partien tragen diese Information nicht, da sie nur in den Quelldateien existiert. Importieren Sie einfach die betreffende .xg-Datei erneut — der Import erkennt das Duplikat und fügt nichts außer den Markierungen hinzu, ohne vorhandene Kommentare oder Analysen anzutasten. Eine Markierung kann in blunderDB weder gesetzt noch entfernt werden: Für eine temporäre Arbeitsliste verwenden Sie besser eine Sammlung.

Der Filter Kommentar durchsucht die den Positionen zugeordneten Kommentare in drei sich ausschließenden Modi. enthält Text sucht ein oder mehrere Wörter im Kommentartext (Eingabefeld, Wörter durch ; getrennt, mindestens eines muss zutreffen); hat einen Kommentar behält jede Position mit einem Kommentar, unabhängig vom Inhalt; ohne Kommentar behält im Gegenteil die nicht kommentierten Positionen — nützlich in Kombination mit einem Fehler- oder Datumsfilter, um die Liste dessen zu erstellen, was noch zu kommentieren ist.

Bemerkung

Aus einer Partiedatei (XG, GNUbg) importierte Kommentare zählen als Kommentare: blunderDB speichert ihre Herkunft nicht und kann daher eine von Ihnen eingegebene Notiz nicht von einer aus der Quelldatei übernommenen unterscheiden. Außerdem sind Kommentare, die einer Partie oder einem Turnier zugeordnet sind, nicht betroffen: Sie kommentieren die Partie oder das Turnier, nicht deren Positionen.

Der Filter Matches & Turniere stützt sich auf einen gemeinsamen Auswahldialog (modales Fenster) anstelle der Eingabe numerischer Kennungen: zwei Kontrollkästchen-Listen, eine für Matches und eine für Turniere, jeweils per Text filterbar (Spieler, Datum, Ereignis für Matches; Name, Datum, Ort für Turniere), mit den Schaltflächen Alle / Keine, die nur auf die aktuell gefilterte Teilmenge wirken. Das Ankreuzen eines Turniers kreuzt automatisch dessen zugehörige Matches in der Matchliste an (und graut sie aus), wodurch sichtbar wird, dass ein Turnier der Gesamtheit seiner Matches entspricht.

Das Suchpanel enthält an seinem linken Rand drei Reiter: Suche (die Filter), Verlauf und Gespeichert. Der Reiter Verlauf listet die vergangenen Suchen mit ihrem Datum und ihrem Befehl auf: Ein Klick wählt eine Suche aus und zeigt die zugehörige Position auf dem Brett an, ein Doppelklick führt sie erneut aus. Jeder Eintrag kann in der Filterbibliothek gespeichert (Lesezeichen-Symbol, durch Angabe eines Filternamens) oder gelöscht werden. Der Reiter Gespeichert enthält die Filterbibliothek: Doppelklicken Sie auf einen gespeicherten Filter, um die entsprechende Suche erneut zu starten (siehe Anhang: Fortgeschrittene Nutzung der Filter). Der Befehl history (Alias hi) öffnet das Suchpanel.

Tipp

Siehe Abschnitt 4 für die Liste der verfügbaren Filter.

2.13. Sammlungen-Panel

Le panneau Collections (CTRL-B) permet de gérer des collections de positions. Les collections peuvent être créées, renommées et supprimées. Des positions peuvent y être ajoutées ou retirées (touche Suppr, confirmation demandée). Double-cliquer sur une collection pour parcourir ses positions avec les touches GAUCHE et DROITE. L’ordre des collections et des positions au sein des collections peut être modifié par glisser-déposer. Appuyer sur CTRL-B ou exécuter la commande collection pour afficher ou masquer le panneau.

2.14. Matches-Panel

Das Panel Matches (CTRL-Tab) listet die importierten Matches auf. Doppelklicken Sie auf ein Match (oder drücken Sie EINGABE), um durch seine Züge zu navigieren. Der Befehl m setzt die Navigation im zuletzt besuchten Match fort.

Der Benutzer kann:

  • die Züge eines Matches mit den Tasten LINKS und RECHTS durchblättern,

  • mit den Tasten PageUp und PageDown von einer Partie zur anderen wechseln,

  • die Analyse der Züge (Steine und Doppler) durch Drücken von CTRL-L anzeigen,

  • mit der Taste d zwischen der Analyse der Steinzüge und des Dopplers umschalten,

  • den tatsächlich gespielten Zug in der Analyse hervorgehoben sehen.

Die zuletzt besuchte Stellung in jedem Match wird gespeichert und automatisch wiederhergestellt. Drücken Sie CTRL-Tab oder führen Sie den Befehl match aus, um das Panel ein- oder auszublenden.

Jedes Match kann über die Schaltfläche ⬇ in der Matchliste oder die Schaltfläche .mat auf der Match-Karte als Jellyfish-Transkription .mat exportiert werden.

Die Schaltfläche Spieler zusammenführen in der Werkzeugleiste des Panels öffnet ein Fenster, das alle Spielernamen der Datenbank mit ihrer Anzahl an Matches auflistet: die Schreibvarianten desselben Spielers auswählen, den beizubehaltenden kanonischen Namen wählen und dann zusammenführen. Nützlich, um die Statistiken pro Spieler zu vereinheitlichen, wenn derselbe Spieler unter mehreren Namen erscheint.

Wenn ein Match geöffnet ist, erscheint über dem Brett eine Informationsleiste: Sie zeigt die beteiligten Spieler (Spieler 1 gegen Spieler 2) sowie den Kontext des Matches (Ereignis, Ort, Runde, Datum und Matchlänge, sofern diese Informationen verfügbar sind). Diese Leiste wird auch außerhalb des Match-Modus angezeigt: Wenn eine untersuchte Position (aus einer Suche, einer Sammlung oder einem direkten Zugriff) aus einem oder mehreren Matches stammt, gibt sie deren Herkunft an — das erste betroffene Match und gegebenenfalls ein Badge „+N“, das die übrigen beim Überfahren auflistet. Eine einzeln importierte Position, auf die kein Match verweist, zeigt nichts an.

Beim Öffnen einer Datenbank, die Matchs enthält, wird das Panel Matchs sofort angezeigt und die Durchsicht beginnt direkt bei der ersten Stellung, sodass Sie unmittelbar mit der Navigation beginnen können.

Bemerkung

Eine Datenbank kann jeweils nur von einem einzigen Fenster zum Schreiben geöffnet werden. Wenn Sie eine Datenbank öffnen, die bereits in einem anderen blunderDB-Fenster geöffnet ist, wird sie schreibgeschützt geöffnet: Navigation, Suche und Analyse bleiben möglich, aber jede Änderung ist deaktiviert und die Titelleiste zeigt „[schreibgeschützt]“ an.

Tipp

Siehe Tastenkürzel für die verfügbaren Tastenkürzel.

2.15. Turnier-Panel

Das Panel Turniere (CTRL-Y) ermöglicht es, Matches in Turnieren zu gruppieren, um eine organisierte Nachverfolgung und eine statistische Analyse pro Veranstaltung zu ermöglichen. Turniere können erstellt, umbenannt und gelöscht werden; Matches können ihnen zugeordnet werden. Die Statistiken des Stats-Panels können nach Turnier gefiltert werden. Drücken Sie CTRL-Y, um das Panel ein- oder auszublenden.

Die Spalte PR jedes Turniers zeigt den PR des Referenzspielers — also des Spielers, der in den meisten Partien des Turniers vorkommt (bei Gleichstand derjenige mit den meisten Entscheidungen). Der PR vermischt Ihr Spiel also nicht mit dem Ihrer Gegner: Bei Ihren eigenen Turnieren spiegelt er allein Ihre Leistung wider. Der Name des Referenzspielers erscheint als Tooltip, wenn Sie den Wert überfahren.

2.16. Stats-Panel

2.16.1. Einführung

Das Panel Stats ermöglicht es, das eigene Spielniveau zu analysieren und den Fortschritt im Zeitverlauf anhand der in die Datenbank importierten Stellungen zu verfolgen. Es berechnet und zeigt die Kennzahlen PR (Performance Rate) und MWC cost (Match Winning Chance cost) für alle Stellungen oder eine gefilterte Teilmenge an.

Das Stats-Panel ist besonders nützlich, um:

  • das eigene Niveau einzuordnen im Verhältnis zu den Referenzschwellen (world-class, Experte, fortgeschritten …) anhand des globalen PR;

  • den eigenen Fortschritt zu verfolgen Turnier für Turnier oder Match für Match anhand der Diagramme im Tab Progression;

  • die eigenen Schwachstellen zu erkennen: der Tab Fehler zeigt die Aufteilung zwischen Steinzügen und Doppler-Entscheidungen sowie die Verteilung der Fehlergrößen;

  • direkt zu den betreffenden Stellungen zu gelangen, indem man auf eine beliebige Kennzahl klickt (Drill-down).

2.16.2. Öffnen des Panels

Um das Stats-Panel zu öffnen:

  • Drücken Sie CTRL-D.

  • Geben Sie den Befehl :stats oder :st in die Befehlszeile ein.

Bemerkung

Das Panel wird bei jeder Änderung des Filters automatisch aktualisiert. Bei einem einfachen Umschalten PR ↔ MWC werden die Statistiken nicht neu berechnet: Beide Kennzahlen werden vom Backend gleichzeitig berechnet.

2.16.3. Filterleiste

Die Filterleiste am oberen Rand des Panels ermöglicht es, die Berechnung auf eine Teilmenge von Stellungen einzuschränken.

2.16.3.1. Spielerperspektive

Die Dropdown-Liste Spieler ermöglicht es, die Statistiken nach dem analysierten Spieler zu filtern. blunderDB wählt automatisch den Spieler aus, dessen Name am häufigsten in der Datenbank vorkommt — jederzeit änderbar.

Tipp

Ein Spielerwechsel führt nicht zu Datenverlust; es genügt, den vorherigen Spieler in der Liste erneut auszuwählen.

2.16.3.2. Verfügbare Filter

  • Turnier(e) — Beschränkung auf ein oder mehrere Turniere. Es können mehrere Turniere gleichzeitig ausgewählt werden.

  • Datum — Zeitspanne (Von … Bis). Wenn nur das Startdatum angegeben ist, werden die neueren Stellungen einbezogen.

  • Entscheidungstyp — Alle / Steinzüge / Doppler-Entscheidungen.

  • Matchlänge — Beschränkung auf bestimmte Matchlängen (1, 3, 5, 7, 9, 11, 13, 15, 21 Punkte). Es können mehrere Längen kombiniert werden.

Eine Schaltfläche Reset setzt alle Filter zurück (außer dem automatisch erkannten Spieler).

Bemerkung

Die Filter werden in der Konfiguration von blunderDB (config.yaml) gespeichert und beim nächsten Start wiederhergestellt.

2.16.4. Umschalter PR / MWC

Die Schaltfläche PR / MWC am oberen Rand des Panels schaltet die in allen Tabs angezeigte Kennzahl um.

PR (Performance Rate)

Misst die Spielqualität im Money-Game: Summe der Fehler in Tausendstelpunkten, geteilt durch die Anzahl der Entscheidungen. Unabhängig vom Matchstand.

Ungefähre Referenzschwellen:

Niveau

PR

World-class

< 3

Experte

3 – 5

Fortgeschritten

5 – 8

Mittelstufe

8 – 12

Anfänger

> 12

MWC cost (Match Winning Chance cost)

Kumulierte Matchgewinnwahrscheinlichkeit, die aufgrund der Fehler über den gesamten gefilterten Datensatz verloren geht. Berechnet anhand der in blunderDB eingebetteten MET Kazaross-XG2.

Vorsicht

Der MWC cost ist nicht anwendbar auf Money-Game-Stellungen (ohne Matcheinsatz). Diese Stellungen werden von der MWC-Berechnung ausgeschlossen. Die MWC-Werte hängen von der verwendeten MET ab; sie sind nicht direkt zwischen Programmen vergleichbar, die unterschiedliche METs verwenden.

Das Umschalten PR ↔ MWC erfolgt sofort: Es wird keine Neuberechnung im Backend durchgeführt.

2.16.5. Tab Dashboard

Der Tab Dashboard gibt eine zusammenfassende Übersicht über die Schlüsselkennzahlen.

2.16.5.1. Niveau-Karten

Drei Karten zeigen den PR (oder MWC) für:

  • All — alle Entscheidungen (Steine + Doppler);

  • Checker — nur Steinzüge;

  • Cube — nur Doppler-Entscheidungen.

Ein Klick auf eine Karte lädt die Stellungen der entsprechenden Teilmenge in das Analyse-Panel (Drill-down).

Bemerkung

Die Gesamtzahl der Entscheidungen wird beim Überfahren am unteren Rand jeder Karte angezeigt.

2.16.5.2. Gleitender PR über die letzten N Entscheidungen

Eine Zeile mit PR- (oder MWC-)Werten, die über die letzten N Entscheidungen berechnet werden (N = 5, 10, 50, 100, 250, 500, 1000), ermöglicht es, den jüngsten Trend zu messen. Die ausgegrauten Werte entsprechen einem N, das größer als die Anzahl der verfügbaren Entscheidungen ist.

Ein Klick auf einen Wert lädt die entsprechenden letzten N Stellungen.

2.16.5.3. Top-Blunder

Die Liste der 10 schlimmsten Fehler (oder MWC cost), sortiert nach absteigender Größe. Ein Klick auf eine Zeile lädt die betreffende Stellung in das Analyse-Panel.

2.16.6. Tab Progression

Der Tab Progression zeigt die Entwicklung des Niveaus im Zeitverlauf.

2.16.6.1. Liniendiagramm pro Turnier

Ein Liniendiagramm zeigt den PR (oder MWC) für jedes Turnier (X-Achse: Reihenfolge der Turniere, Y-Achse: Wert der Kennzahl). Farbige Bänder verdeutlichen die Niveauschwellen.

Ein Klick auf einen Punkt im Diagramm öffnet ein Kontextmenü mit zwei Optionen:

  • Open tournament — öffnet das Turnier im Turnier-Panel.

  • Open positions — lädt alle Stellungen des Turniers in das Analyse-Panel.

2.16.6.2. Streudiagramm pro Match

Ein Streudiagramm stellt jedes Match dar (X-Achse: Datum, Y-Achse: PR oder MWC). Die Größe des Punkts ist proportional zur Anzahl der Entscheidungen im Match.

Ein Klick auf einen Punkt öffnet ein Kontextmenü:

  • Open match — öffnet das Match im Matches-Panel.

  • Open positions — lädt alle Stellungen des Matches in das Analyse-Panel.

2.16.7. Tab Fehler

Der Tab Fehler schlüsselt die Fehlerquellen auf.

2.16.7.1. Aufteilung nach Doppler-Aktion

Ein Balkendiagramm zeigt den PR (oder MWC) für jeden Typ von Doppler-Entscheidung an: NoDouble, DoubleTake, DoublePass, TooGood. Jeder Balken gibt außerdem die Anzahl der Entscheidungen und die Blunder-Rate in einem Tooltip an.

Ein Klick auf einen Balken lädt die zu dieser Doppler-Aktion gehörenden Stellungen, nur die mit einem Fehler (Drill-down).

2.16.7.2. Direction des erreurs de videau

La répartition ci-dessus indique combien coûtent les décisions de videau ; ce tableau indique dans quel sens elles se trompent.

Une position de videau porte deux décisions prises par deux joueurs différents, présentées ici en deux lignes :

  • Offrir — le joueur qui tient le videau double ou ne double pas. Ses erreurs sont les doubles manqués (il fallait doubler) et les doubles prématurés (il ne fallait pas).

  • Répondre — le joueur à qui le videau est offert prend ou passe. Ses erreurs sont les passes à tort (une prise correcte a été passée) et les prises à tort (une passe correcte a été prise).

Les deux lignes restent séparées à dessein : un joueur peut parfaitement doubler tard et prendre large, et un indicateur unique appellerait cela « équilibré » en perdant les deux moitiés de l’information.

Chaque case affiche le nombre de décisions ; l’infobulle donne l’équité perdue cumulée. Cliquer sur une case charge les positions correspondantes. Une case à zéro n’est pas cliquable.

Bemerkung

Ce tableau compte des décisions, il ne porte pas de jugement. À partir de quel écart une tendance mérite d’être nommée dépend de l’effectif et d’un point de référence, qui ne sont pas des données du moteur.

2.16.7.3. Aufteilung Checker / Cube

Ein Vergleichsdiagramm stellt den PR der Steinzüge und der Doppler-Entscheidungen nebeneinander dar. Ein Klick auf einen Balken lädt die Stellungen der Teilmenge mit Fehler.

2.16.7.4. Histogramm der Fehlergrößen

Ein Histogramm verteilt die Fehler nach ihrer Größe in Tausendstelpunkten (Klassen: 0–5, 5–10, 10–25, 25–50, 50–100, ≥ 100). Ein Klick auf einen Balken lädt die Stellungen der Klasse.

2.16.8. Aggregationsregel

Wichtig

Der PR eines Turniers (oder einer beliebigen Teilmenge) wird nach der Summe/Summe-Regel berechnet — niemals als Durchschnitt der einzelnen Match-PRs.

Formel:

\[PR_{Turnier} = \frac{\sum_{i} \text{Fehler}_i}{\text{Gesamtzahl der Entscheidungen}}\]

Beispiel: ein Spieler bestreitet zwei Matches in einem Turnier —

  • Match A: 10 Entscheidungen, Gesamtfehler 50 mp → PR = 5,0

  • Match B: 90 Entscheidungen, Gesamtfehler 270 mp → PR = 3,0

Naiver Durchschnitt der PRs: (5,0 + 3,0) / 2 = 4,0 (falsch)

Summe/Summe-Regel: (50 + 270) / (10 + 90) = 320 / 100 = 3,2 (korrekt)

Die Summe/Summe-Regel ist die einzige, die mit unterschiedlichen Matchlängen korrekt umgeht (ein Match über 21 Punkte wiegt mehr als ein Match über 1 Punkt).

2.16.9. MWC: Einschränkungen

  • Der MWC cost wird anhand der MET Kazaross-XG2 berechnet, der De-facto-Referenztabelle im Wettkampf-Backgammon. Die Ergebnisse sind nicht direkt mit Programmen vergleichbar, die andere METs verwenden.

  • Money-Game-Stellungen (ohne Matchstand) werden von der MWC-Berechnung ausgeschlossen. Wenn Ihre Datenbank viele Money-Game-Stellungen enthält, kann der MWC cost unterschätzt oder nicht verfügbar sein.

  • Der MWC cost ist kumulativ über den gesamten gefilterten Datensatz — keine Kennzahl pro Entscheidung. Er misst die Gesamtauswirkung Ihrer Fehler auf Ihre Gewinnchancen.

2.17. Bearoff-Panel

Le panneau Bearoff (CTRL-E) calcule l’EPC (Effective Pip Count) d’une position de bearoff. Il est activé en appuyant sur CTRL-E, en cliquant sur l’onglet Bearoff dans le panneau inférieur, ou en exécutant la commande epc.

In diesem Panel bearbeitet der Benutzer die Position der Steine in den beiden Heimfeldern: Ein Klick auf die Punkte 1 bis 6 platziert Steine des unteren Spielers, ein Klick auf die Punkte 19 bis 24 platziert Steine des oberen Spielers (die Maustaste spielt keine Rolle).

Die Ergebnisse werden in Form zweier übereinander angeordneter Tabellen dargestellt:

  • oben eine Spielertabelle — eine Zeile pro Spieler (gekennzeichnet durch seinen Farbpunkt, der schwarze Spieler steht immer unten), eine Spalte pro Größe: EPC, Pip-Count, Wastage (Differenz zwischen EPC und Pip-Count), durchschnittliche Wurfzahl und Standardabweichung. Wenn beide Spieler Steine in ihrem Heimfeld haben, gibt eine Δ-Zeile die vorzeichenbehafteten Differenzen (unten − oben: negativ, wenn der schwarze Spieler vorne liegt) von EPC, Pips und Wastage an;

  • darunter, durch eine Linie getrennt, eine Rennen-/Würfel-Tabelle: zwei Spalten mit der Gewinnwahrscheinlichkeit (eine pro Spieler-Farbpunkt, Werte ohne das %-Zeichen) und die Money-Equities — unter jeder Entscheidung außer der besten steht in Klammern der Equity-Abstand zur besten Entscheidung. Die Entscheidung wird rechts neben der Tabelle angezeigt, mit dem Badge exakt/geschätzt. Der Spieler am Zug und die Position des Verdopplungswürfels werden direkt am Brett bearbeitet, wie im Bearbeitungsmodus: Ein Klick auf das Bearoff-/Score-Rechteck eines Spielers macht ihn zum Spieler am Zug; ein Klick auf den Würfel wechselt zyklisch zentriert → Besitz unten → Besitz oben (Rechtsklick in umgekehrter Richtung). Der Wert des Würfels bleibt fest — im Money-Game werden die Equities in Einheiten des aktuellen Würfels ausgedrückt, nur sein Besitzer zählt. Die Analyse wird sofort neu berechnet. Im geschätzten Regime öffnet der Link „Konfigurationseinstellungen anzeigen“ direkt den Reiter Bearoff der Konfiguration.

Das Kontrollkästchen Challenge bleibt oben rechts im Panel angeheftet.

Wenn die Stellung ein reines Bearoff ist (alle Steine beider Spieler in ihrem Heimfeld), zeigt die Rennen-Tabelle für den Spieler am Zug:

  • die Gewinnwahrscheinlichkeit,

  • im exakten Regime: die Money-Equities (Cubeless, ohne Doppeln, Doppeln/Take, Doppeln/Pass) und das Money-Würfel-Urteil (kein Doppeln, Doppeln/Take oder Doppeln/Pass),

  • im geschätzten Regime: nur die Gewinnwahrscheinlichkeit, zusammen mit ihrer Fehlermarge — das Würfel-Urteil wird dann bewusst nicht angezeigt.

Ein Badge zeigt das Regime an: exakt (Wert aus einer Two-Sided-Datenbank gelesen) oder geschätzt ± Marge. Siehe Methodik und Annahmen des Bearoff-Panels für die genaue Definition der beiden Regime und ihrer Annahmen.

Den exakten Bereich erweitern. Die integrierte Datenbank deckt 6 Steine pro Spieler ab. Zwei Wege, darüber hinauszugehen, im Reiter Bearoff der Konfiguration:

  • télécharger la base étendue TS-06-11 (1,2 Go, vérifiée par SHA-256, supprimable au même endroit après confirmation) : verdict exact jusqu’à 11 pions par joueur. Un téléchargement interrompu ou annulé reprend où il s’était arrêté (le fichier partiel est conservé et complété par requête HTTP Range) ;

  • eine beliebige Two-Sided-.bd-Datei von gnubg angeben. Die Datenbank mit dem größten Bereich hat automatisch Vorrang.

Challenge-Modus. Das Kontrollkästchen Challenge des Panels aktiviert einen Trainingsmodus: Bei jeder Änderung der Stellung werden die Werte der drei Zonen — die Zeile des unteren Spielers, die Zeile des oberen Spielers und die Rennen-Tabelle — verdeckt (ersetzt durch „···“); ein Klick auf eine Zone deckt nur diese Zone auf. Die Δ-Zeile erscheint erst, wenn beide Spielerzeilen aufgedeckt sind. So kann man trainieren, den EPC jeder Seite zu schätzen und sich dann zum Verdopplungswürfel zu äußern, bevor man nachprüft. Die Einstellung wird gespeichert.

Um das Bearoff-Panel zu schließen, drücken Sie CTRL-E oder wechseln Sie zu einem anderen Tab.

2.17.1. Methodik und Annahmen des Bearoff-Panels

Jeder vom Panel angezeigte Wert beruht auf präzisen Annahmen, die hier erschöpfend dargelegt werden.

Bereich. Das Panel behandelt nur das reine Bearoff: alle verbleibenden Steine beider Spieler in ihrem Heimfeld. Die Stellung wird vor dem Wurf bewertet; eventuell liegende Würfel werden ignoriert. Kontaktlose Rennen, bei denen Steine außerhalb des Heimfelds stehen, werden nicht behandelt.

EPC-Blöcke (immer exakt). EPC, durchschnittliche Wurfzahl und Standardabweichung stammen aus der exakten Verteilung der Anzahl der Würfe, die zum Abtragen aller Steine nötig sind, gelesen aus der One-Sided-Datenbank von GNUbg (6 Punkte, 15 Steine, integriert). EPC = durchschnittliche Würfe × 49/6 (49/6 ≈ 8,167 ist der exakte Durchschnitt der Pips pro Wurf, Päsche vierfach gezählt); Wastage = EPC − Pip-Count. Die einzige Idealisierung ist das optimale One-Sided-Spiel: Jeder Spieler minimiert seine eigenen Würfe und ignoriert den Gegner — das ist die Standarddefinition des EPC.

Gewinnwahrscheinlichkeit, exaktes Regime. Direktes Lesen aus der größten verfügbaren Two-Sided-Datenbank (integrierte TS-06-06, externe Datei oder heruntergeladene TS-06-11). Diese Datenbanken sind das Ergebnis einer vollständigen Rückwärtsanalyse unter optimalem Two-Sided-Spiel beider Seiten: keine zusätzliche Annahme, Fehler beschränkt auf die Quantisierung (< 0,002 %).

Gewinnwahrscheinlichkeit, geschätztes Regime. Außerhalb des Bereichs der Datenbank: Die Wahrscheinlichkeit wird durch Faltung der beiden One-Sided-Verteilungen ermittelt (der Spieler am Zug gewinnt, wenn seine Wurfzahl kleiner oder gleich der des Gegners ist) und anschließende Anwendung einer festen polynomialen Korrektur, offline gegen die TS-06-11-Datenbank kalibriert. Drei Annahmen:

  • Unabhängigkeit der beiden Abtragprozesse — im Rennen strukturell gegeben, ohne Kontakt gibt es keinerlei Interaktion;

  • optimales One-Sided-Spiel beider Seiten — das ist die Approximation: In Wirklichkeit weicht der zurückliegende Spieler ab, um auf Varianz zu spielen, und der Führende, um auf Sicherheit zu spielen. Der gemessene Effekt ist eine antisymmetrische Verzerrung (die Faltung übertreibt den Vorsprung des Führenden), die die Korrektur statistisch auffängt;

  • die Korrektur wurde auf dem Bereich des Orakels kalibriert und validiert (bis 11 Steine pro Spieler). Gemessener Restfehler: Standardabweichung 0,05 %, 99. Perzentil 0,17 %, beobachtetes Maximum 0,9 % (in Prozentpunkten der Gewinnwahrscheinlichkeit). Jenseits von 11 Steinen pro Spieler ist diese Schranke extrapoliert — die Tendenz ist monoton, aber kein Orakel bestätigt sie.

Equities und Würfel-Urteil (nur exaktes Regime). Die angezeigten Equities sind die des Money-Game ohne Jacoby, im Referenzrahmen der Bearoff-Literatur. Im Bereich ≤ 11 Steine pro Spieler sind Gammons unmöglich (jede Seite hat bereits mindestens 4 Steine abgetragen): Das ist keine Approximation. Das Urteil (kein Doppeln / Doppeln, Take / Doppeln, Pass) wird exakt aus den gespeicherten Equities rekonstruiert, nach der Regel von GNUbg, Zug für Zug gegen dessen Analyse validiert.

Bemerkung

Die Cubeful-Equities setzen ein optimales Spiel mit dem Verdopplungswürfel beider Seiten bis zum Ende voraus: Künftige Redoubles werden vollständig bewertet (vollständige Rückwärtsanalyse). In den sehr volatilen Rennen am Partieende frisst die Kaskade der Redoubles fast den gesamten Vorteil der Seite am Zug auf — die Equities „ohne Doppeln“ und „Doppeln/Take“ können dann nahe null liegen, wo eine Engine wie XG, deren Würfelmodell diese Kaskade nicht bewertet, Werte nahe dem Dead Cube anzeigt (zum Beispiel 2 Steine auf Punkt 3 gegen 2 Steine auf Punkt 2: 62 % Gewinn, exaktes D/T +0,006 gegenüber +0,475 bei XG). Die angezeigte Entscheidung hingegen stimmt mit der der Engines überein.

Warum wird das Urteil nie geschätzt? Die Cubeful-Equity ist ein Problem der Trajektorie (wann doppeln?), das keine statistische Zusammenfassung der Stellung erfasst: Das beste gemessene statische Modell lässt einen Restfehler (Standardabweichung 0,016 Equity, Maximum 0,20), der ausreicht, um alle knappen Entscheidungen umzukehren. Ebenso wurde die Umrechnung des Urteils auf den Matchstand über eine Match-Equity-Tabelle als unzureichend gemessen (12 % Abweichungen von der 2-ply-Analyse von GNUbg, mit echten Blunders). Da ein mit Nachdruck angezeigtes falsches Urteil schlimmer ist als gar kein Urteil, zeigt blunderDB das Urteil nur an, wenn es exakt ist — und nur für Money.

Bemerkung

Die Bearoff-Datenbanken sind unveränderliche mathematische Tabellen, die sich mit dem Werkzeug makebearoff von GNUbg neu erzeugen lassen.

2.18. Anki-Panel

Das Panel Anki (CTRL-K) ermöglicht es, Stellungen durch verteiltes Wiederholen mithilfe des FSRS-Algorithmus zu studieren. Der Benutzer kann Stapel aus Sammlungen oder Suchergebnissen erstellen.

Stapel erstellen: Klicken Sie auf New Deck, um einen Stapel aus einer Sammlung oder den aktuellen Suchergebnissen zu erstellen. Suchbasierte Stapel werden beim Aktivieren des Anki-Tabs automatisch synchronisiert.

Wiederholung: Wählen Sie einen Stapel aus und klicken Sie dann auf Study (oder doppelklicken Sie auf einen Stapel), um mit der Wiederholung der fälligen Karten zu beginnen. Jede Karte zeigt die entsprechende Stellung auf dem Brett an. Bewerten Sie Ihre Erinnerung mit den Tasten 1 (Nochmal), 2 (Schwierig), 3 (Gut) oder 4 (Einfach). Drücken Sie Esc, um anzuhalten und zur Stapelliste zurückzukehren.

Freies Üben (Cram): Die Schaltfläche Cram neben Study startet eine freie Übungssitzung: Es werden Ihnen zufällige Stellungen aus dem Deck angezeigt, unabhängig vom FSRS-Zeitplan. Dieser Modus verändert niemals den Plan der verteilten Wiederholung — ideal zum Aufwärmen vor einem Turnier oder zum intensiven Wiederholen eines thematischen Decks, ohne dessen Reihenfolge zu stören. Eine Cram-Plakette ersetzt den Kartenstatus, und eine Schaltfläche Weiter (Tasten 1 bis 4) blättert durch die Stellungen. Esc kehrt zur Liste zurück, ohne eine unterbrochene Sitzung zu speichern.

Anhalten/Fortsetzen: Sie können eine Wiederholungssitzung jederzeit mit Esc unterbrechen. Die Schaltfläche wechselt zu Resume und zeigt Ihren Fortschritt an. Klicken Sie darauf, um dort fortzufahren, wo Sie aufgehört haben.

Gestion des paquets : Utilisez les boutons d’action pour renommer, synchroniser, réinitialiser ou supprimer des paquets (confirmation demandée pour ces deux dernières actions). Les paramètres FSRS (rétention cible, intervalle maximum, aléa) peuvent être configurés par paquet dans les Paramètres (icône engrenage).

2.19. Metadaten-Panel

Das Panel Metadaten zeigt die allgemeinen Informationen der aktuellen Datenbank an: Name, Beschreibung, Anzahl der Stellungen, Anzahl der Matches und Partien, Schemaversion. Erreichbar über den Befehl meta.

Es zeigt außerdem, sofern vorhanden, die Herkunft der Datenbank an — siehe Eine Datenbank weitergeben: Herkunft und Passwort. Bei einer gewöhnlichen Datenbank erscheint dieser Abschnitt nicht.

2.20. Eine Datenbank weitergeben: Herkunft und Passwort

Wer als Lehrender eine Positionsdatenbank verteilt, hat zwei voneinander unabhängige Mechanismen zur Hand, beide optional und beide beim Export zu wählen: die Datei mit ihrer Herkunft zu kennzeichnen und sie mit einem Passwort zu schützen.

Bemerkung

Keiner von beiden verfolgt, was aus der Datei wird. blunderDB zeichnet auf der Empfängerseite nichts auf: Eine gekennzeichnete Datenbank zu öffnen ist genau wie jede andere zu öffnen, und nirgends wird festgehalten, wer sie wann geöffnet hat oder woher ihr Inhalt stammt.

2.20.1. Eine Datenbank mit ihrer Herkunft kennzeichnen

Das Exportfenster kommt mit einer einzigen Ansicht aus: dem Formular und einer Fortschrittsanzeige, die sich während des Schreibens darüberlegt. Es schließt sich nach Abschluss von selbst, und das Ergebnis erscheint in der Statusleiste.

Drei Punkte verdienen Beachtung:

  • Der Export umfasst die aktuell angezeigten Positionen, nicht die gesamte Datenbank. Nach einer Suche werden nur die Treffer exportiert — das Fenster weist oben darauf hin.

  • Eine Sammlung, deren Positionen nicht alle in der Auswahl enthalten sind, kommt unvollständig an. Die Liste zeigt deshalb für jede Sammlung den abgedeckten Anteil („12/40“) und hebt ihn rot hervor, wenn er unvollständig ist.

  • Turniere lassen sich nur zusammen mit den Partien exportieren: ohne sie gibt es die Verknüpfung Turnier–Partie nicht, und das Turnier käme leer an. Das Kästchen bleibt deaktiviert, solange „Partien einschließen“ nicht angehakt ist.

Die Felder Benutzer, Beschreibung und Datum beschreiben die erzeugte Datei; sie sind aus der Quelldatenbank vorausgefüllt. Das Kästchen Meine gespeicherten Filter steht für sich: Es exportiert keine Inhalte, sondern Ihre eigenen gespeicherten Suchen, die in der Datenbank eines anderen nutzlos sind.

Ein Häkchen bei Diese Datei mit ihrer Herkunft kennzeichnen blendet zwei Felder ein:

  • Herkunft — was diese Datei ist und woher sie kommt, in Ihren eigenen Worten: „Unterricht von Jean Dupont — 12. März 2026“. Dieses Feld ist verpflichtend: Solange es leer ist, bleibt die Export-Schaltfläche inaktiv.

  • Hinweis, optional — Nutzungsbedingungen, eine Kontaktadresse, die Bitte, die Datei nicht weiterzugeben.

Die Kennzeichnung wird mit Ihrer Ausstelleridentität signiert. Sie ist damit unverfälschbar und nicht nachahmbar: Niemand kann sie verändern oder eine in Ihrem Namen erzeugen. Sie ist dagegen nicht unlöschbar — die verteilte Datei ist eine gewöhnliche SQLite-Datenbank, und blunderDB ist freie Software. Sie verhindert nichts: Sie sagt, woher die Datei kommt.

2.20.2. Ausstelleridentität

Die Kennzeichnungen werden mit Ihrer Ausstelleridentität signiert, die beim ersten Kennzeichnen einer Datei von selbst angelegt wird; es ist nichts einzurichten. Sie gehört zu einer Person und nicht zu einer Datenbank: Alle Ihre Dateien tragen denselben öffentlichen Fingerabdruck der Form A3F1-9C24-7B05-E1D8.

Sie können diesen Fingerabdruck Ihren Empfängern mitteilen, damit sie prüfen können, dass eine Datei tatsächlich von Ihnen stammt. Die Identität lässt sich als einzelne Datei (Endung .bdbid) von einem Rechner auf den anderen mitnehmen, auf Wunsch durch eine Passphrase geschützt. Mit dieser Datei kann in Ihrem Namen signiert werden: Geben Sie sie nicht weiter.

In den Einstellungen (Zahnradsymbol in der Werkzeugleiste) zeigt die Registerkarte Ausstelleridentität Ihren Namen und Ihren Fingerabdruck an und bietet Identität speichern…, Identität laden… und Neu erzeugen… an.

Warnung

Neu erzeugen widerruft nichts. Ein Wasserzeichen enthält den öffentlichen Schlüssel, mit dem es signiert wurde: Es lässt sich daher für immer aus sich selbst heraus prüfen. Ist Ihre Identitätsdatei abhandengekommen, kann derjenige, der sie besitzt, weiterhin unter Ihrem alten Fingerabdruck signieren, und diese Kennzeichnungen bleiben gültig.

Was Sie nach einem solchen Verlust schützt, ist keine Software: Es ist, Ihren neuen Fingerabdruck zu veröffentlichen und den alten gegenüber Ihren Empfängern für ungültig zu erklären.

Das Neuerzeugen überschreibt den aktuellen Schlüssel; blunderDB bietet an, ihn vor dem Ersetzen zu speichern.

2.20.3. Eine Datenbank mit einem Passwort schützen

Das Passwort wird verdeckt eingegeben, hier wie beim Öffnen einer geschützten Datei; das Augensymbol zeigt es an, solange es gedrückt gehalten wird, und verdeckt es wieder, sobald man loslässt.

Ein Häkchen bei Diese Datei mit einem Passwort schützen erzeugt eine Datei mit der Endung .dbx — auch dann, wenn Sie im Speichern-Dialog einen Namen auf .db gewählt hatten, denn dieser Dialog öffnet sich, bevor nach dem Passwort gefragt wird. Zum Öffnen verwenden Sie das gewohnte Öffnen einer Datenbank: Der Auswahldialog akzeptiert sowohl .db als auch .dbx. blunderDB fragt dann nach dem Passwort und legt daneben eine gewöhnliche Datenbank an; danach wird nichts mehr abgefragt.

Das Fenster bietet an, die geschützte Datei nach dem Öffnen zu löschen: Andernfalls behalten Sie denselben Inhalt unter zwei Namen. Das Kästchen ist standardmäßig nicht angehakt — die geschützte Datei bleibt Ihnen erhalten, wenn Sie sie weitergeben wollen — und gelöscht wird erst nach einem erfolgreichen Öffnen.

Warnung

Das Passwort schützt die Datei auf dem Transportweg, nicht die Datenbank. Es hindert Dritte daran, eine Datei zu öffnen, die in einem Download-Ordner liegt oder als versehentlich weitergeleiteter Anhang ankommt. Vor demjenigen, dem Sie das Passwort gegeben haben, schützt es nicht.

Das Passwort wird bei jedem Öffnen geprüft, auch wenn die Datei auf diesem Rechner schon einmal geöffnet wurde.

Technisch wird die Datenbank mit AES-256 im GCM-Modus verschlüsselt, mit einem Schlüssel, der per Argon2id (64 MiB Speicher, 3 Durchläufe, 4 Threads) aus dem Passwort abgeleitet wird, und einem zufälligen, für jede Datei eigenen Salt. Der GCM-Modus authentifiziert das Ganze: Ein falsches Passwort wird als solches erkannt, ebenso jede Veränderung der verschlüsselten Datei — man erhält nie stillschweigend eine beschädigte Datenbank.

Der Kopf der geschützten Datei bleibt unverschlüsselt: Ihre Herkunft ist auch ohne Passwort lesbar.

2.20.4. Die Herkunft einer Datei lesen

Öffnen Sie in der Anwendung die Datei und blenden Sie das Panel Metadaten ein (Befehl meta). Am Kopf des Panels erscheint schreibgeschützt ein Abschnitt Herkunft, der angibt, was eingetragen wurde, von wem, wann, und wie es um die Signatur steht:

  • „✓ Signatur geprüft — von Ihnen gekennzeichnet“: Die Datei trägt Ihre Kennzeichnung, unversehrt;

  • „✓ Signatur geprüft“: Die Kennzeichnung ist unversehrt und stammt von einem anderen Schlüssel — vergleichen Sie ihren Fingerabdruck mit dem, den der Ersteller Ihnen mitgeteilt hat;

  • „⚠ Signatur ungültig“: Das Dokument wurde verändert oder gefälscht.

Bei einer gewöhnlichen Datenbank erscheint dieser Abschnitt nicht.

Auf der Kommandozeile zeigt blunderdb info --db datei.db die Herkunft und den Zustand der Signatur an, ohne jemals in die Datei zu schreiben. Der Befehl funktioniert auch bei einer geschützten Datei, ohne das Passwort. Siehe CLI_USAGE.md für die Optionen --watermark und --password von export sowie für identity und open.