Downloadable tools · Mac · Windows · Linux
Teacher utilities
Command-line tools for preparing lesson materials. Download the pre-built binary for your computer — no programming knowledge required to run them, though they do require using a Terminal or Command Prompt.
These are command-line tools — they run in a Terminal (Mac/Linux) or Command Prompt (Windows). If that's not familiar territory, the pre-built lesson materials in the Lesson Materials section may be all you need.
Everyday teacher tools
PDF Handouts pdf-handouts
Assemble class handouts from multiple PDFs and add your class name, date, and page numbers in one step.
Merge several PDF sections into a single handout
Add title, class name, presenter name, and date to every page
Automatic page numbers — "Page 3 of 14"
Smart date expressions — "next tuesday" fills in the right date automatically
Bridge Wrangler bridge-wrangler
Process and transform PBN deal files — rotate hands for the hot seat, convert to PDF, filter by criteria, and more.
Rotate deals so a specific seat is always in the hot seat
Convert PBN files directly to printable PDF
Replicate boards into sets for multi-table play
Filter deals by any tag or pattern
Convert PBN to LIN format for BBO
For creating your own materials
Dealer3 dealer3
Generate bridge hands to a precise specification. A Rust rewrite that supersedes both the original Dealer and Dealer2 — drop-in compatible with existing scripts, with added multi-threading for fast generation of large sets.
Generate hands matching specific HCP ranges, suit lengths, or distributions
Drop-in replacement for Dealer and Dealer2 — existing scripts work unchanged
Multi-threaded generation for large deal sets — significantly faster than the originals
Predeal specific cards to specific seats for constrained scenarios
CSV output for analysis pipelines; PBN output for direct use in other tools
Bridge Solver bridge-solver
Double-dummy analysis for any bridge deal. A Rust rewrite based on the Bo Haglund double-dummy solver — the same algorithm used by most bridge software worldwide.
Find the optimal result on any deal with double-dummy analysis
Verify par contracts when preparing lesson materials
Used internally by bridge-wrangler's analyze command
Example: preparing a class handout
# Assemble handout from multiple PDFs,
# add class name, presenter, date and page numbers
$ pdf-handouts build
"1. NT Ladder Intro.pdf"
"2. Practice Sheet.pdf"
"3. Exercises.pdf"
-o "Handout.pdf"
--title "Bridge Class Handout"
--footer-left "Senior Center"
--footer-center "Presented by: Rick Wilson"
--footer-right "Page [page] of [pages]|[date]"
--date "next tuesday"
"2. Practice Sheet.pdf"
"3. Exercises.pdf"
-o "Handout.pdf"
--title "Bridge Class Handout"
--footer-left "Senior Center"
--footer-center "Presented by: Rick Wilson"
--footer-right "Page [page] of [pages]|[date]"
--date "next tuesday"
Merging 3 PDFs... done
Adding headers and footers... done
✓ Written to Handout.pdf (14 pages)
# Rotate deals so South is always declarer
$ bridge-wrangler rotate-deals
lesson.pbn
--seat south
--role declarer
-o lesson-south.pbn
--seat south
--role declarer
-o lesson-south.pbn
Processing 20 deals... done
✓ Written to lesson-south.pbn
# Generate 40 hands with 5-card major, 15-17 HCP
$ dealer3 major_open.dl
-p 40
-f pbn
-R 0 # auto-detect threads
-f pbn
-R 0 # auto-detect threads
Generating with 10 threads...
✓ 40 deals written to major_open.pbn