splitsmith 0.2.0__tar.gz → 0.2.1__tar.gz

{splitsmith-0.2.0 → splitsmith-0.2.1}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: splitsmith
-Version: 0.2.0
+Version: 0.2.1
 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)
+![audit view](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/audit.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.2.1}/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)
+![audit view](https://raw.githubusercontent.com/mandakan/splitsmith/main/docs/screenshots/audit.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.2.1}/pyproject.toml

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

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

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

{splitsmith-0.2.0 → splitsmith-0.2.1}/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.2.1}/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.2.1}/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