runrazor 0.1.2__tar.gz

runrazor-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ken Walker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

runrazor-0.1.2/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: runrazor
+Version: 0.1.2
+Summary: RunRazor: movement-analysis tools for stationary-camera footage
+Author: Ken Walker
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Environment :: Console
+Requires-Dist: gpxpy>=1.6.2
+Requires-Dist: numpy>=2.0
+Requires-Dist: scipy>=1.13
+Requires-Dist: matplotlib>=3.9
+Requires-Dist: click>=8.1
+Requires-Dist: pyside6>=6.8
+Requires-Dist: pyopengl>=3.1.7
+Requires-Dist: python-mpv>=1.0.8
+Requires-Dist: opencv-python>=4.9
+Requires-Dist: click-option-group>=0.5.9
+Requires-Dist: markdown>=3.6
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# RunRazor
+
+Tools for movement analysis from stationary-camera footage.
+
+If you film yourself or someone else repeating a course past a fixed camera -- hill repeats, sprints, drills -- RunRazor turns that raw footage into usable clips. It uses the subject's GPS track to find each pass automatically, can crop and follow the subject so they stay framed, and lets you compare runs side by side or export the cuts straight to a video editor.
+
+| Command | What it does |
+| --- | --- |
+| `runrazor` | The main app: automatically cut a video using the subject's GPS track, review and tune the cut points, reframe, and export (see `rrdocs runrazor`) |
+| `rrreframe` | Crop and follow a moving subject automatically so they stay framed (see `rrdocs reframe`) |
+| `rrcompare` | Play two runs side by side, lined up in time, to compare them (see `rrdocs compare`) |
+| `rrtag` | Mark matching points in two runs by hand so `rrcompare` can line them up (see `rrdocs compare`) |
+| `rrdocs` | Open the bundled documentation in your browser |
+
+## Environment
+
+- Python 3.12
+- `ffmpeg` and `ffprobe` on PATH (used for probing and cutting video)
+- `libmpv` installed on the system for GUI video playback (the GUI still launches without it; see `rrdocs runrazor`)
+
+## Install
+
+```
+pip install runrazor
+```
+
+Documentation is bundled with the package; run `rrdocs` to open it in your browser (`rrdocs reframe` opens a specific page).
+
+## RunRazor
+
+The GUI ties it all together: load a video and GPS track, review and tune the cut points against the footage, reframe, and export.
+
+```
+runrazor
+```
+
+See `rrdocs runrazor` for all options, hotkeys, time format, libmpv setup, and examples.
+
+
+## Reframe
+
+Automatic subject tracking and reframing pipeline.  Crops video from a stationary camera to follow a moving subject.  You can use this without the RunRazor segmentation.
+
+```
+rrreframe input.mp4
+```
+
+You may get reasonable results without any additional arguments. 
+
+See `rrdocs reframe` for fine-tuning, deshake, horizon correction, 360 video input, interactive pinning, profile mode, and cache options.
+
+## Split-screen comparison
+
+Side-by-side comparison of two ski runs (or one run against its own mirror), phase-locked turn-by-turn. It runs on Reframe outputs: each clip's trajectory sidecar (written by default) drives automatic turn-apex detection, and one clip plays at native speed while the other is retimed per turn segment to stay in sync.
+
+```
+rrreframe runA.mp4 --output a.mp4
+rrreframe runB.mp4 --output b.mp4
+rrcompare a.mp4 b.mp4 -o compare.mp4
+```
+
+The alignment is written to an editable JSON sidecar that you can hand-tweak and re-render. To compare against an external clip that was never reframed (or to fix wrong auto-detected turns), tag its apexes with `rrtag clip.mp4`. See `rrdocs compare` for turn pairing, mirroring, pane fit, retiming, manual tagging, and the alignment JSON.

runrazor-0.1.2/README.md

@@ -0,0 +1,62 @@
+# RunRazor
+
+Tools for movement analysis from stationary-camera footage.
+
+If you film yourself or someone else repeating a course past a fixed camera -- hill repeats, sprints, drills -- RunRazor turns that raw footage into usable clips. It uses the subject's GPS track to find each pass automatically, can crop and follow the subject so they stay framed, and lets you compare runs side by side or export the cuts straight to a video editor.
+
+| Command | What it does |
+| --- | --- |
+| `runrazor` | The main app: automatically cut a video using the subject's GPS track, review and tune the cut points, reframe, and export (see `rrdocs runrazor`) |
+| `rrreframe` | Crop and follow a moving subject automatically so they stay framed (see `rrdocs reframe`) |
+| `rrcompare` | Play two runs side by side, lined up in time, to compare them (see `rrdocs compare`) |
+| `rrtag` | Mark matching points in two runs by hand so `rrcompare` can line them up (see `rrdocs compare`) |
+| `rrdocs` | Open the bundled documentation in your browser |
+
+## Environment
+
+- Python 3.12
+- `ffmpeg` and `ffprobe` on PATH (used for probing and cutting video)
+- `libmpv` installed on the system for GUI video playback (the GUI still launches without it; see `rrdocs runrazor`)
+
+## Install
+
+```
+pip install runrazor
+```
+
+Documentation is bundled with the package; run `rrdocs` to open it in your browser (`rrdocs reframe` opens a specific page).
+
+## RunRazor
+
+The GUI ties it all together: load a video and GPS track, review and tune the cut points against the footage, reframe, and export.
+
+```
+runrazor
+```
+
+See `rrdocs runrazor` for all options, hotkeys, time format, libmpv setup, and examples.
+
+
+## Reframe
+
+Automatic subject tracking and reframing pipeline.  Crops video from a stationary camera to follow a moving subject.  You can use this without the RunRazor segmentation.
+
+```
+rrreframe input.mp4
+```
+
+You may get reasonable results without any additional arguments. 
+
+See `rrdocs reframe` for fine-tuning, deshake, horizon correction, 360 video input, interactive pinning, profile mode, and cache options.
+
+## Split-screen comparison
+
+Side-by-side comparison of two ski runs (or one run against its own mirror), phase-locked turn-by-turn. It runs on Reframe outputs: each clip's trajectory sidecar (written by default) drives automatic turn-apex detection, and one clip plays at native speed while the other is retimed per turn segment to stay in sync.
+
+```
+rrreframe runA.mp4 --output a.mp4
+rrreframe runB.mp4 --output b.mp4
+rrcompare a.mp4 b.mp4 -o compare.mp4
+```
+
+The alignment is written to an editable JSON sidecar that you can hand-tweak and re-render. To compare against an external clip that was never reframed (or to fix wrong auto-detected turns), tag its apexes with `rrtag clip.mp4`. See `rrdocs compare` for turn pairing, mirroring, pane fit, retiming, manual tagging, and the alignment JSON.

runrazor-0.1.2/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "runrazor"
+version = "0.1.2"
+description = "RunRazor: movement-analysis tools for stationary-camera footage"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Ken Walker" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video",
+    "Environment :: Console",
+]
+dependencies = [
+    "gpxpy>=1.6.2",
+    "numpy>=2.0",
+    "scipy>=1.13",
+    "matplotlib>=3.9",
+    "click>=8.1",
+    "PySide6>=6.8",
+    "PyOpenGL>=3.1.7",
+    "python-mpv>=1.0.8",
+    "opencv-python>=4.9",
+    "click-option-group>=0.5.9",
+    "markdown>=3.6",
+]
+
+[project.scripts]
+runrazor = "runrazor.app.cli:main"
+rr = "runrazor.app.cli:main"
+rrreframe = "runrazor.reframe.reframe:main"
+rrcompare = "runrazor.compare.cli:main"
+rrtag = "runrazor.compare.tag:main"
+rrdocs = "runrazor.app.docs:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.4",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.8,<0.12.0"]
+build-backend = "uv_build"

runrazor-0.1.2/src/runrazor/__init__.py

@@ -0,0 +1,17 @@
+"""RunRazor package.
+
+Kept import-light on purpose: importing ``runrazor`` (or any submodule) must not
+eagerly pull in the CLI/GUI/domain layer, so the base <- reframe <- compare <- app
+layering holds. Entry points reference module paths (e.g. ``runrazor.app.cli:main``)
+directly.
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("runrazor")
+except PackageNotFoundError:  # running from a source tree without install metadata
+    __version__ = "0.0.0+unknown"
+
+del version, PackageNotFoundError
+

runrazor-0.1.2/src/runrazor/app/__init__.py

@@ -0,0 +1,5 @@
+"""App layer: GPX/segmentation domain, export pipeline, CLI, and GUI.
+
+Top of the dependency graph (base <- reframe <- compare <- app). Modules here may
+import from base, reframe, and compare.
+"""