kinemotion 0.18.2__py3-none-any.whl → 0.20.0__py3-none-any.whl

kinemotion/core/video_io.py

@@ -2,6 +2,7 @@
 
 import json
 import subprocess
+import warnings
 
 import cv2
 import numpy as np
@@ -147,8 +148,17 @@ class VideoProcessor:
             # Extract rotation from side_data_list (common for iPhone videos)
             self.rotation = self._extract_rotation_from_stream(stream)
 
-        except (subprocess.TimeoutExpired, FileNotFoundError, json.JSONDecodeError):
-            # If ffprobe fails, keep original dimensions (square pixels)
+        except FileNotFoundError:
+            # ffprobe not found - warn user about reduced functionality
+            warnings.warn(
+                "ffprobe not found. Video rotation and aspect ratio metadata will be "
+                "ignored. This may cause issues with mobile/rotated videos. "
+                "Install FFmpeg for full video support: https://ffmpeg.org/download.html",
+                UserWarning,
+                stacklevel=2,
+            )
+        except (subprocess.TimeoutExpired, json.JSONDecodeError):
+            # If ffprobe fails for other reasons, silently continue with defaults
             pass
 
     def read_frame(self) -> np.ndarray | None:

{kinemotion-0.18.2.dist-info → kinemotion-0.20.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.18.2
+Version: 0.20.0
 Summary: Video-based kinematic analysis for athletic performance
 Project-URL: Homepage, https://github.com/feniix/kinemotion
 Project-URL: Repository, https://github.com/feniix/kinemotion
@@ -30,13 +30,18 @@ Description-Content-Type: text/markdown
 # Kinemotion
 
 [![PyPI version](https://img.shields.io/pypi/v/kinemotion.svg)](https://pypi.org/project/kinemotion/)
+[![Python Version](https://img.shields.io/pypi/pyversions/kinemotion.svg)](https://pypi.org/project/kinemotion/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
-[![Type checked with pyright](https://img.shields.io/badge/type%20checked-pyright-blue.svg)](https://github.com/microsoft/pyright)
+
+[![Tests](https://github.com/feniix/kinemotion/workflows/Test%20%26%20Quality/badge.svg)](https://github.com/feniix/kinemotion/actions)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=feniix_kinemotion&metric=alert_status)](https://sonarcloud.io/summary/overall?id=feniix_kinemotion)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=feniix_kinemotion&metric=coverage)](https://sonarcloud.io/summary/overall?id=feniix_kinemotion)
+
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=feniix_kinemotion&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=feniix_kinemotion)
+[![Type checked with pyright](https://img.shields.io/badge/type%20checked-pyright-blue.svg)](https://github.com/microsoft/pyright)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
 
-A video-based kinematic analysis tool for athletic performance. Analyzes vertical jump videos to estimate key performance metrics using MediaPipe pose tracking and advanced kinematics.
+> A video-based kinematic analysis tool for athletic performance. Analyzes vertical jump videos to estimate key performance metrics using MediaPipe pose tracking and advanced kinematics.
 
 **Supported jump types:**
 
@@ -88,27 +93,70 @@ For clinical, research, or performance assessment requiring validated accuracy,
 
 ## Setup
 
-### Prerequisites
+### System Requirements
+
+**All Platforms:**
+
+- Python 3.10, 3.11, or 3.12
+
+**Platform-Specific:**
+
+#### Windows
 
-- [asdf](https://asdf-vm.com/) version manager
-- asdf plugins for Python and uv
+No additional system dependencies required.
 
-### Installation
+**Recommended for mobile video support:**
 
-1. **Install asdf plugins** (if not already installed):
+- [FFmpeg](https://ffmpeg.org/download.html) - Download and add to PATH
+
+#### macOS
+
+No additional system dependencies required.
+
+**Recommended for mobile video support:**
+
+```bash
+brew install ffmpeg
+```
+
+#### Linux (Ubuntu/Debian)
+
+**Recommended system libraries:**
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+    libgl1-mesa-glx \
+    libglib2.0-0 \
+    ffmpeg
+```
+
+**Note:** `ffmpeg` provides the `ffprobe` tool for video metadata extraction (rotation, aspect ratio). Kinemotion works without it, but mobile/rotated videos may not process correctly. A warning will be shown if `ffprobe` is not available.
+
+### Installation Methods
+
+#### From PyPI (Recommended)
+
+```bash
+pip install kinemotion
+```
+
+#### From Source (Development)
+
+**Step 1:** Install asdf plugins (if not already installed):
 
 ```bash
 asdf plugin add python
 asdf plugin add uv
 ```
 
-1. **Install versions specified in `.tool-versions`**:
+**Step 2:** Install versions specified in `.tool-versions`:
 
 ```bash
 asdf install
 ```
 
-1. **Install project dependencies using uv**:
+**Step 3:** Install project dependencies using uv:
 
 ```bash
 uv sync
@@ -120,7 +168,7 @@ This will install all dependencies and make the `kinemotion` command available.
 
 Kinemotion supports two jump types with intelligent auto-tuning that automatically optimizes parameters based on video characteristics.
 
-### Drop Jump Analysis
+### Analyzing Drop Jumps
 
 Analyzes reactive strength and ground contact time:
 
@@ -129,7 +177,7 @@ Analyzes reactive strength and ground contact time:
 kinemotion dropjump-analyze video.mp4
 ```
 
-### Counter Movement Jump (CMJ) Analysis
+### Analyzing CMJ
 
 Analyzes jump height and biomechanics:
 

{kinemotion-0.18.2.dist-info → kinemotion-0.20.0.dist-info}/RECORD

@@ -14,15 +14,15 @@ kinemotion/core/debug_overlay_utils.py,sha256=TyUb5okv5qw8oeaX3jsUO_kpwf1NnaHEAO
 kinemotion/core/filtering.py,sha256=f-m-aA59e4WqE6u-9MA51wssu7rI-Y_7n1cG8IWdeRQ,11241
 kinemotion/core/pose.py,sha256=ztemdZ_ysVVK3gbXabm8qS_dr1VfJX9KZjmcO-Z-iNE,8532
 kinemotion/core/smoothing.py,sha256=C9GK3PAN16RpqJw2UWeVslSTJZEvALeVADjtnJnSF88,14240
-kinemotion/core/video_io.py,sha256=kH5FYPx3y3lFZ3ybdgxaZfKPdHJ37eqxSeAaZjyQnJk,6817
+kinemotion/core/video_io.py,sha256=0bJTheYidEqxGP5Y2dSO2x6sbOrnBDBu2TEiV8gT23A,7285
 kinemotion/dropjump/__init__.py,sha256=yc1XiZ9vfo5h_n7PKVSiX2TTgaIfGL7Y7SkQtiDZj_E,838
 kinemotion/dropjump/analysis.py,sha256=xx5NWy6s0eb9BEyO_FByY1Ahunaoh3TyaTAxjlPrvxg,27153
 kinemotion/dropjump/cli.py,sha256=J2F8ij-UcybY7YjK_bncQZiHNzrgS3Y7uTBkNo7y_L4,21328
 kinemotion/dropjump/debug_overlay.py,sha256=LkPw6ucb7beoYWS4L-Lvjs1KLCm5wAWDAfiznUeV2IQ,5668
 kinemotion/dropjump/kinematics.py,sha256=txDxpDti3VJVctWGbe3aIrlIx83UY8-ynzlX01TOvTA,15577
 kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.18.2.dist-info/METADATA,sha256=BfM1zCiT2AJ-wThyR7WDL1RwFO6t4Lj71K7C_tSLiIA,18986
-kinemotion-0.18.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-kinemotion-0.18.2.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.18.2.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.18.2.dist-info/RECORD,,
+kinemotion-0.20.0.dist-info/METADATA,sha256=z3hxeml55ljQHkty3vxiahTkMA9pnN1CgwMefmJWBp0,20249
+kinemotion-0.20.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+kinemotion-0.20.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.20.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.20.0.dist-info/RECORD,,