·DotMapper
No image loaded
Scroll ↓ to compare with source photo
T 0:00.00 / DUR 0:00.00 FPS— RES—
Captured 0

## Match Setup

Getting the pitch size and team colours right here means landmark positions and player classification will be accurate. You can still change these later in the sidebar.

### Pitch Size

Width (long axis, m) Height (short axis, m)

### Teams

Team A
Team B
Per team Referee colour

## Confirm Team Colours

Now that you can see the match, confirm each team's jersey colour and the referee's kit. You can still change these later in step 2, but getting them right here means detection classifies every queued frame correctly from the start.

### Teams

Team A
Team B
Referee colour

## Start a New Session?

Clears the current video/image, landmarks, players, and diagram work, and returns to the picker. Exported PDFs and GIFs are never touched.

Keep Saved Frames leaves this video's captured frames on disk, so reloading the same video later restores your tray and mapping. Delete Saved Frames wipes them for a truly fresh start.

## DotMapper License

The free trial maps one frame per session. Quit and reopen DotMapper to map a different frame — or buy a license for unlimited frames and activate it below.

DotMapper is in trial mode: every feature works, limited to one processed frame per launch, and exported PDFs carry a small footer note. A license key removes both limits — buy DotMapper and your key arrives by email.

### License key

This Mac is licensed — unlimited frames, no watermark. Thanks for supporting DotMapper!

Licensed to ·

## DotMapper — how it works

Three workflows, easiest first. Start with a single photo to get the feel; use video for richer output.

### Workflow 1 · Single still photo ≈ 2 min

The simplest way to produce a dot map. Best when you only need to capture one moment of a play.

1. Load Image in the toolbar, pick your photo.
2. 01 Landmarks — confirm the pitch size at top of the sidebar, then mark 4+ known field points (corners, halfway-line intersections, penalty-box corners, centre spot). Click Map the Field.
3. 02 Players — auto-detected dots appear. Drag any that landed wrong, Right-click to remove false positives, and click Start Adding Players for any the detector missed (including the ball — switch Add Player As to Ball). Adjust team colours in the Match Settings panel.
4. 03 Diagram — stacked view: interactive top-down pitch on top, source photo underneath for comparison. Drag any dot to fine-tune its field position. Pick the attacking direction, then Export PDF.

Output: letter-size PDF at ~/Documents/DotMapper/.

### Workflow 2 · Multiple stills from one video ≈ 5–10 min

You want several standalone dot maps from the same match — e.g. one per goal, corner, or set-piece — but they don't need to animate together. Calibration carries forward so you only mark landmarks once.

1. Load Video in the toolbar. The scrubber panel opens.
2. Scrub to a moment you care about → Capture Frame (grabs one still). Repeat for each moment. Each grab appears as a thumbnail in the Captured strip.
3. Click Process Queue → to load the first captured frame. Run Workflow 1 on it (landmarks → map → players → diagram → Export PDF).
4. Use the toolbar's ‹ 1/N › arrows to move to the next frame. With INHERIT on (default), landmarks and homography carry forward — you just confirm and move on. Export each as its own PDF.

Tip: Video Frames button reopens the scrubber any time you want to grab more clips without losing your work. Progress is saved automatically per video.

### Workflow 3 · Animated 3-clip sequence ≈ 10–15 min

A short animated GIF showing player movement across a play. Most involved — you manually map each of the 3 frames — but produces a shareable motion asset.

1. Load Video, scrub to the start of the play you want to animate.
2. Click Capture Sequence ▶▶ — pulls 3 frames spaced 2 seconds apart (a 4-second window). Precise, server-side decoded from the source FPS.
3. Process Queue → opens the first frame. Calibrate it (landmarks → Map the Field), then place / confirm player dots for the initial formation. Labels auto-assign: Team A 1–11, Team B A–L (no I), Ref R.
4. Click the › arrow (or Next). The next frame loads with all your previous players carried over as draggable dots with amber halos; a faint B&W overlay of the previous frame shows each player's prior position for context. Drag each dot to where the player is now — the halo clears as you confirm. Labels stay stable.
5. Repeat for frame 3. When you've mapped all 3, click Export Sequence ▶ in the toolbar. Output is an animated GIF with eased motion between frames and a 2.5 s hold on the final formation — ready to share.

Mid-session? Quit any time. Everything saves to ~/Pictures/DotMapper/<video>/. Reload the same video to resume exactly where you left.

### Keyboard & interaction

- Scroll zoom · Drag background to pan · F fit
- Shift+click (Players step) quick-adds a player
- Right-click any dot / landmark to remove
- Esc cancels an armed landmark or add-player mode

⚽

## Don't forget the ball!

No ball has been placed on the photo yet. Switch "Add Player As" to "Ball" and click where the ball is — or continue to the diagram without one.

Processing image...