splitsmith 0.2.0__tar.gz → 0.3.0__tar.gz

splitsmith-0.3.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+## [0.3.0](https://github.com/mandakan/splitsmith/compare/v0.2.1...v0.3.0) (2026-05-25)
+
+
+### Features
+
+* **beep-review:** single home for beep work; trim audit page ([#399](https://github.com/mandakan/splitsmith/issues/399)) ([9ecf999](https://github.com/mandakan/splitsmith/commit/9ecf9998f94edeb5420e3a982f97ae4edb2114f0))
+* **brand:** hero + og:image, new tagline, audit shortcut hints ([#401](https://github.com/mandakan/splitsmith/issues/401)) ([40aa55a](https://github.com/mandakan/splitsmith/commit/40aa55ac56da0e9c81ae373554b9dc8816f4b2e0))
+
+## [0.2.1](https://github.com/mandakan/splitsmith/compare/v0.2.0...v0.2.1) (2026-05-24)
+
+
+### Bug Fixes
+
+* **docs:** use absolute GitHub URLs for README images on PyPI ([#398](https://github.com/mandakan/splitsmith/issues/398)) ([de435a6](https://github.com/mandakan/splitsmith/commit/de435a6981b0532f05c159a73da86a9d107bf6af))
+
+## 0.2.0 (2026-05-24)
+
+First public release.
+
+Extract IPSC shot splits from head-mounted camera footage. Detect shots
+via a 3-voter ensemble (envelope onset / CLAP / GBDT-with-PANN), produce
+a CSV of splits, and emit an FCPXML timeline with per-shot markers and
+optional overlay clips for Final Cut Pro.
+
+Install:
+
+```
+uv tool install splitsmith
+```
+
+After install, run `splitsmith fetch-models` to pre-download the ~440 MB
+of ONNX detection artifacts (otherwise they download on first detection).

{splitsmith-0.2.0 → splitsmith-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: splitsmith
-Version: 0.2.0
+Version: 0.3.0
 Summary: Extract IPSC shot splits from head-mounted camera footage
 Author: Mathias Axell
 License: MIT
@@ -29,9 +29,14 @@ Description-Content-Type: text/markdown
 
 # splitsmith
 
+[![PyPI version](https://img.shields.io/pypi/v/splitsmith.svg)](https://pypi.org/project/splitsmith/)
+[![Python versions](https://img.shields.io/pypi/pyversions/splitsmith.svg)](https://pypi.org/project/splitsmith/)
+[![License](https://img.shields.io/pypi/l/splitsmith.svg)](https://github.com/mandakan/splitsmith/blob/main/LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/mandakan/splitsmith/ci.yml?branch=main&label=ci)](https://github.com/mandakan/splitsmith/actions/workflows/ci.yml)
+
 Extract per-shot split times from head-mounted camera footage of IPSC matches and generate Final Cut Pro timelines with per-shot markers.
 
-![audit view](docs/screenshots/audit.png)
+![Splitsmith -- Detect. Coach. Cut.](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/hero.png)
 
 Built to do two things from a single stage video: get per-shot splits for analysis and coaching, and prepare frame-marked clips for match-footage review. Your head-mounted cam (Insta360 Go 3S in this case) already captures audio of every shot; the RO's timer only records your total stage time, so the splits live in the video and nowhere else. Splitsmith extracts them and turns them into a CSV plus an FCPXML timeline with per-shot markers you can step through in Final Cut Pro.
 
@@ -42,30 +47,24 @@ Built to do two things from a single stage video: get per-shot splits for analys
 
 | | |
 |---|---|
-| ![ingest](docs/screenshots/ingest.png) | **Ingest.** Drop a folder of GoPro clips; the engine auto-matches them to stages by file timestamp. |
-| ![beep review](docs/screenshots/beep-review.png) | **Beep review.** Auto-snap to the start beep on each stage; low-confidence detections land in a HITL queue. |
-| ![audit](docs/screenshots/audit.png) | **Audit.** Waveform + per-shot markers from the 3-voter ensemble. Click a marker to inspect votes; drag to fine-tune. |
-| ![compare](docs/screenshots/compare.png) | **Compare.** Multi-shooter grid, all beep-aligned to t=0. Audio from one shooter, video tiles for everyone else. |
-| ![export](docs/screenshots/export.png) | **Export.** Per-stage or whole-match FCPXML. Open in Final Cut Pro, M / Shift+M to navigate markers. |
+| ![ingest](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/ingest.png) | **Ingest.** Drop a folder of GoPro clips; the engine auto-matches them to stages by file timestamp. |
+| ![beep review](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/beep-review.png) | **Beep review.** Auto-snap to the start beep on each stage; low-confidence detections land in a HITL queue. |
+| ![audit](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/audit.png) | **Audit.** Waveform + per-shot markers from the 3-voter ensemble. Click a marker to inspect votes; drag to fine-tune. |
+| ![compare](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/compare.png) | **Compare.** Multi-shooter grid, all beep-aligned to t=0. Audio from one shooter, video tiles for everyone else. |
+| ![export](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/export.png) | **Export.** Per-stage or whole-match FCPXML. Open in Final Cut Pro, M / Shift+M to navigate markers. |
 
-> Screenshots regenerate from a live `splitsmith ui` via `scripts/capture_screenshots.py`. See [issue tracking the local run](#regenerating-screenshots) below.
+> Screenshots regenerate from a live `splitsmith ui` via `scripts/capture_screenshots.py`. See [Regenerating screenshots](#regenerating-screenshots) below.
 
 ## Quickstart
 
-> The slim wheel install (`uv tool install splitsmith`) is the target end-user path once the wheel is published to PyPI -- the engine work is done (#377), publishing is the next step. Until then, install from source as described below.
-
-You need: `uv`, `ffmpeg`/`ffprobe` on PATH, and (for source checkouts) Node 20 + `pnpm` to build the SPA. See [Install](#install) for OS-specific package commands.
+You need: `uv` and `ffmpeg`/`ffprobe` on PATH. See [Install](#install) for OS-specific package commands.
 
 ```bash
-# Install from source (today's recommended path)
-git clone https://github.com/mandakan/splitsmith.git
-cd splitsmith
-uv sync                                          # slim runtime deps only (~100 MB)
-(cd src/splitsmith/ui_static && pnpm install && pnpm build)
-uv run splitsmith fetch-models                   # ~440 MB ONNX artifacts; one-time
+uv tool install splitsmith                       # slim runtime, ~100 MB
+splitsmith fetch-models                          # ~440 MB ONNX artifacts; one-time
 
 # Bring your own head-cam clip and stage time (or use any IPSC video at hand)
-uv run splitsmith single \
+splitsmith single \
     --video path/to/your_stage.mp4 \
     --time 14.74 \
     --output ./demo_analysis \
@@ -79,7 +78,7 @@ cat ./demo_analysis/stage3_per-told-me-to-do-it_report.txt
 For the full ingest -> audit -> export workflow with persistent project state, use the UI:
 
 ```bash
-uv run splitsmith ui --project ~/matches/your-match
+splitsmith ui --project ~/matches/your-match
 ```
 
 The repo ships a real Stage 3 audio sample at `tests/fixtures/stage-shots-tallmilan-2026-stage3-s97dcec94.wav` (Tallmilan 2026, 14.74s, 14 audited shots) plus its sibling JSON with ground-truth shot times. The companion source MP4 is gitignored -- bring your own video to exercise the full ingest pipeline.
@@ -105,17 +104,17 @@ The repo ships a real Stage 3 audio sample at `tests/fixtures/stage-shots-tallmi
 
   `splitsmith ui` checks for both on first launch and prints a copy-pasteable install hint if they're missing.
 
-### Option 1: slim wheel (end users, ~100 MB) -- pending first PyPI release
-
-The shipped install will be `uv tool install splitsmith` once the first release-please release lands on `main` (see [Releases](#releases) below). Detection models (~440 MB total) download from `models.splitsmith.app` on first detection -- pre-fetch with `splitsmith fetch-models`. No torch, transformers, or panns_inference in the install.
+### Option 1: slim wheel (end users, ~100 MB)
 
 ```bash
-uv tool install splitsmith                       # available after the first 0.x.y release; see Option 2 below until then
+uv tool install splitsmith                       # from PyPI
 splitsmith fetch-models                          # pre-fetch ONNX artifacts (optional)
 splitsmith ui --project ~/matches/your-match
 ```
 
-### Option 2: from source (today's recommended path; required for contributors)
+Detection models (~440 MB total) download from `models.splitsmith.app` on first detection -- pre-fetch with `splitsmith fetch-models`. No torch, transformers, or panns_inference in the install.
+
+### Option 2: from source (required for contributors)
 
 ```bash
 git clone https://github.com/mandakan/splitsmith.git

{splitsmith-0.2.0 → splitsmith-0.3.0}/README.md

@@ -1,8 +1,13 @@
 # splitsmith
 
+[![PyPI version](https://img.shields.io/pypi/v/splitsmith.svg)](https://pypi.org/project/splitsmith/)
+[![Python versions](https://img.shields.io/pypi/pyversions/splitsmith.svg)](https://pypi.org/project/splitsmith/)
+[![License](https://img.shields.io/pypi/l/splitsmith.svg)](https://github.com/mandakan/splitsmith/blob/main/LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/mandakan/splitsmith/ci.yml?branch=main&label=ci)](https://github.com/mandakan/splitsmith/actions/workflows/ci.yml)
+
 Extract per-shot split times from head-mounted camera footage of IPSC matches and generate Final Cut Pro timelines with per-shot markers.
 
-![audit view](docs/screenshots/audit.png)
+![Splitsmith -- Detect. Coach. Cut.](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/hero.png)
 
 Built to do two things from a single stage video: get per-shot splits for analysis and coaching, and prepare frame-marked clips for match-footage review. Your head-mounted cam (Insta360 Go 3S in this case) already captures audio of every shot; the RO's timer only records your total stage time, so the splits live in the video and nowhere else. Splitsmith extracts them and turns them into a CSV plus an FCPXML timeline with per-shot markers you can step through in Final Cut Pro.
 
@@ -13,30 +18,24 @@ Built to do two things from a single stage video: get per-shot splits for analys
 
 | | |
 |---|---|
-| ![ingest](docs/screenshots/ingest.png) | **Ingest.** Drop a folder of GoPro clips; the engine auto-matches them to stages by file timestamp. |
-| ![beep review](docs/screenshots/beep-review.png) | **Beep review.** Auto-snap to the start beep on each stage; low-confidence detections land in a HITL queue. |
-| ![audit](docs/screenshots/audit.png) | **Audit.** Waveform + per-shot markers from the 3-voter ensemble. Click a marker to inspect votes; drag to fine-tune. |
-| ![compare](docs/screenshots/compare.png) | **Compare.** Multi-shooter grid, all beep-aligned to t=0. Audio from one shooter, video tiles for everyone else. |
-| ![export](docs/screenshots/export.png) | **Export.** Per-stage or whole-match FCPXML. Open in Final Cut Pro, M / Shift+M to navigate markers. |
+| ![ingest](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/ingest.png) | **Ingest.** Drop a folder of GoPro clips; the engine auto-matches them to stages by file timestamp. |
+| ![beep review](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/beep-review.png) | **Beep review.** Auto-snap to the start beep on each stage; low-confidence detections land in a HITL queue. |
+| ![audit](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/audit.png) | **Audit.** Waveform + per-shot markers from the 3-voter ensemble. Click a marker to inspect votes; drag to fine-tune. |
+| ![compare](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/compare.png) | **Compare.** Multi-shooter grid, all beep-aligned to t=0. Audio from one shooter, video tiles for everyone else. |
+| ![export](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/export.png) | **Export.** Per-stage or whole-match FCPXML. Open in Final Cut Pro, M / Shift+M to navigate markers. |
 
-> Screenshots regenerate from a live `splitsmith ui` via `scripts/capture_screenshots.py`. See [issue tracking the local run](#regenerating-screenshots) below.
+> Screenshots regenerate from a live `splitsmith ui` via `scripts/capture_screenshots.py`. See [Regenerating screenshots](#regenerating-screenshots) below.
 
 ## Quickstart
 
-> The slim wheel install (`uv tool install splitsmith`) is the target end-user path once the wheel is published to PyPI -- the engine work is done (#377), publishing is the next step. Until then, install from source as described below.
-
-You need: `uv`, `ffmpeg`/`ffprobe` on PATH, and (for source checkouts) Node 20 + `pnpm` to build the SPA. See [Install](#install) for OS-specific package commands.
+You need: `uv` and `ffmpeg`/`ffprobe` on PATH. See [Install](#install) for OS-specific package commands.
 
 ```bash
-# Install from source (today's recommended path)
-git clone https://github.com/mandakan/splitsmith.git
-cd splitsmith
-uv sync                                          # slim runtime deps only (~100 MB)
-(cd src/splitsmith/ui_static && pnpm install && pnpm build)
-uv run splitsmith fetch-models                   # ~440 MB ONNX artifacts; one-time
+uv tool install splitsmith                       # slim runtime, ~100 MB
+splitsmith fetch-models                          # ~440 MB ONNX artifacts; one-time
 
 # Bring your own head-cam clip and stage time (or use any IPSC video at hand)
-uv run splitsmith single \
+splitsmith single \
     --video path/to/your_stage.mp4 \
     --time 14.74 \
     --output ./demo_analysis \
@@ -50,7 +49,7 @@ cat ./demo_analysis/stage3_per-told-me-to-do-it_report.txt
 For the full ingest -> audit -> export workflow with persistent project state, use the UI:
 
 ```bash
-uv run splitsmith ui --project ~/matches/your-match
+splitsmith ui --project ~/matches/your-match
 ```
 
 The repo ships a real Stage 3 audio sample at `tests/fixtures/stage-shots-tallmilan-2026-stage3-s97dcec94.wav` (Tallmilan 2026, 14.74s, 14 audited shots) plus its sibling JSON with ground-truth shot times. The companion source MP4 is gitignored -- bring your own video to exercise the full ingest pipeline.
@@ -76,17 +75,17 @@ The repo ships a real Stage 3 audio sample at `tests/fixtures/stage-shots-tallmi
 
   `splitsmith ui` checks for both on first launch and prints a copy-pasteable install hint if they're missing.
 
-### Option 1: slim wheel (end users, ~100 MB) -- pending first PyPI release
-
-The shipped install will be `uv tool install splitsmith` once the first release-please release lands on `main` (see [Releases](#releases) below). Detection models (~440 MB total) download from `models.splitsmith.app` on first detection -- pre-fetch with `splitsmith fetch-models`. No torch, transformers, or panns_inference in the install.
+### Option 1: slim wheel (end users, ~100 MB)
 
 ```bash
-uv tool install splitsmith                       # available after the first 0.x.y release; see Option 2 below until then
+uv tool install splitsmith                       # from PyPI
 splitsmith fetch-models                          # pre-fetch ONNX artifacts (optional)
 splitsmith ui --project ~/matches/your-match
 ```
 
-### Option 2: from source (today's recommended path; required for contributors)
+Detection models (~440 MB total) download from `models.splitsmith.app` on first detection -- pre-fetch with `splitsmith fetch-models`. No torch, transformers, or panns_inference in the install.
+
+### Option 2: from source (required for contributors)
 
 ```bash
 git clone https://github.com/mandakan/splitsmith.git

{splitsmith-0.2.0 → splitsmith-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "splitsmith"
-version = "0.2.0"
+version = "0.3.0"
 description = "Extract IPSC shot splits from head-mounted camera footage"
 readme = "README.md"
 requires-python = ">=3.11"

{splitsmith-0.2.0 → splitsmith-0.3.0}/src/splitsmith/__init__.py

@@ -1,3 +1,3 @@
 """splitsmith: extract IPSC shot splits from head-mounted camera footage."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{splitsmith-0.2.0 → splitsmith-0.3.0}/src/splitsmith/config.py

@@ -328,8 +328,7 @@ class ShotRefineConfig(BaseModel):
     method: Literal["envelope", "aic"] = "envelope"
     # Half-width of the audio window scanned around each approximate time.
     # 200 ms covers reverb-anchored cases where the candidate generator
-    # placed its rise foot 100-200 ms after the true onset (see
-    # PRECISION_LIMITS.md section 4a).
+    # placed its rise foot 100-200 ms after the true onset.
     search_half_window_ms: float = 200.0
     # Reject refinements whose confidence falls below this threshold and
     # keep the original timestamp instead. 0.0 = always accept.
@@ -338,7 +337,7 @@ class ShotRefineConfig(BaseModel):
     # least this much louder than the local-position peak. Small ratios
     # (< 2.0) mean the original was already on a peak; tight rise-foot
     # adjustment is used instead. Mirrors the same heuristic as the
-    # candidate-time reverb-chain re-anchor (PRECISION_LIMITS section 4a).
+    # candidate-time reverb-chain re-anchor.
     reanchor_ratio: float = 2.0
     # AIC-only: bandpass before AIC. Muzzle-blast energy concentrates above
     # ~500 Hz; bandpassing reduces wind/handling noise that can mask the

{splitsmith-0.2.0 → splitsmith-0.3.0}/src/splitsmith/fcpxml_gen.py

@@ -1,6 +1,6 @@
 """Generate Final Cut Pro XML timelines (FCPXML 1.10).
 
-v1 scope (per FIRST_PROMPT.md, fcpxml is intentionally minimal):
+v1 scope (intentionally minimal):
 - One asset (the trimmed video) + one sequence at the source frame rate.
 - V1 = ref-clip of the trimmed video.
 - One ``<marker>`` per shot, frame-aligned, with a descriptive name that

{splitsmith-0.2.0 → splitsmith-0.3.0}/src/splitsmith/ui/__init__.py

@@ -1,8 +1,7 @@
 """Production UI package for splitsmith.
 
 The UI is a localhost SPA driven by a FastAPI backend that orchestrates the
-existing engine modules unchanged. See docs/PRODUCTION_UI.md and issue #11
-for the v1 contract.
+existing engine modules unchanged.
 
 Sub-packages:
 - ``project``: Pydantic models for the on-disk match-project layout

{splitsmith-0.2.0 → splitsmith-0.3.0}/src/splitsmith/ui/server.py

@@ -1059,7 +1059,7 @@ class BeepQueueItem(BaseModel):
     beep_time: float | None
     beep_confidence: float | None
     beep_reviewed: bool
-    status: Literal["missing", "low_confidence", "unreviewed"]
+    status: Literal["missing", "low_confidence", "unreviewed", "confirmed"]
     alt_candidates: list[BeepQueueAltCandidate]
     # Auto-computed cross-align suggestion for secondaries lives on the
     # shooter's other videos; the SPA fetches them lazily if needed.
@@ -7257,16 +7257,21 @@ def create_app(
     # ----------------------------------------------------------------------
 
     @app.get("/api/match/beep-queue", response_model=BeepQueueResponse)
-    def get_beep_queue() -> BeepQueueResponse:
+    def get_beep_queue(include_confirmed: bool = Query(default=False)) -> BeepQueueResponse:
         """Pending beep items across every shooter in the bound match.
 
-        Surfaces three states per primary video:
+        Surfaces three pending states per primary video:
           - ``missing``: detector hasn't run or didn't find a beep
           - ``low_confidence``: detector found one but below the project's
             auto-trust threshold
           - ``unreviewed``: detector found one above threshold but the
             user hasn't yet listened + approved
 
+        When ``include_confirmed`` is true the response also includes
+        items whose beep has been reviewed, with ``status="confirmed"``.
+        The SPA uses this for the "Show confirmed" toggle so the user
+        can revisit a settled beep without having to clear-and-redo it.
+
         Items are grouped by stage; per-stage shot detection is gated on
         every shooter's primary in that stage being ``beep_reviewed``.
         """
@@ -7320,12 +7325,15 @@ def create_app(
                 elif primary.beep_reviewed:
                     grp.confirmed += 1
                     total_confirmed += 1
-                    continue
+                    if not include_confirmed:
+                        continue
+                    status = "confirmed"
                 elif primary.beep_confidence is not None and primary.beep_confidence < threshold:
                     status = "low_confidence"
                 else:
                     status = "unreviewed"
-                total_pending += 1
+                if status != "confirmed":
+                    total_pending += 1
                 alts = [
                     BeepQueueAltCandidate(
                         time=cand.time,

{splitsmith-0.2.0 → splitsmith-0.3.0}/src/splitsmith/ui_static/src/components/AuditControls.tsx

@@ -12,6 +12,7 @@ import { Maximize2, Minus, Plus } from "lucide-react";
 
 import { MarkerGlyph, type MarkerKind } from "@/components/MarkerGlyph";
 import { Button } from "@/components/ui/button";
+import { modKeyLabel } from "@/lib/platform";
 import { cn } from "@/lib/utils";
 
 export interface MarkerFilters {
@@ -152,6 +153,7 @@ export function ZoomControls({ zoom, onZoomChange, className }: ZoomControlsProp
     const next = base / ZOOM_STEP;
     onZoomChange(next <= MIN_ZOOM ? null : next);
   };
+  const mod = modKeyLabel();
 
   return (
     <div className={cn("inline-flex items-center gap-1", className)} role="group" aria-label="Zoom">
@@ -159,8 +161,8 @@ export function ZoomControls({ zoom, onZoomChange, className }: ZoomControlsProp
         size="sm"
         variant="ghost"
         onClick={zoomOut}
-        aria-label="Zoom out (Cmd+3)"
-        title="Zoom out (Cmd+3)"
+        aria-label={`Zoom out (${mod}+3)`}
+        title={`Zoom out (${mod}+3)`}
       >
         <Minus className="size-3" />
       </Button>
@@ -168,8 +170,8 @@ export function ZoomControls({ zoom, onZoomChange, className }: ZoomControlsProp
         size="sm"
         variant="ghost"
         onClick={() => onZoomChange(null)}
-        aria-label="Fit waveform (Cmd+2)"
-        title="Fit waveform (Cmd+2)"
+        aria-label={`Fit waveform (${mod}+2)`}
+        title={`Fit waveform (${mod}+2)`}
         aria-pressed={zoom == null}
       >
         <Maximize2 className="size-3" />
@@ -178,8 +180,8 @@ export function ZoomControls({ zoom, onZoomChange, className }: ZoomControlsProp
         size="sm"
         variant="ghost"
         onClick={zoomIn}
-        aria-label="Zoom in (Cmd+1)"
-        title="Zoom in (Cmd+1)"
+        aria-label={`Zoom in (${mod}+1)`}
+        title={`Zoom in (${mod}+1)`}
       >
         <Plus className="size-3" />
       </Button>