Release 1.6.2

Bump version to 1.6.2, add changelog entry, and update docs/releases.md. This
release is the audit/cleanup pass: pose() falls back to OpenPose when MediaPipe
isn't installed; fixes method-shadowing, blend()/grid() argument bugs, and
docstring/quickstart errors; adds MgVideo/MgAudio repr, duration/n_frames
properties, and MgImage/MgFigure .save(); plus expanded documentation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: alexarje

CHANGELOG.md

@@ -9,6 +9,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.6.2] – 2026-06-27
+
+### Fixed
+- `pose()` defaults to the MediaPipe backend (the optional `[pose]` extra). On installs without
+  MediaPipe it now **falls back to the OpenPose `body_25` backend** (with a clear message) instead
+  of raising, so `pose()` works out of the box. (This also fixes the CI test jobs.)
+- Several result attributes shadowed their own methods on the instance, so a second call failed:
+  `tempo_similarity`, `phase_synchrony`, `structure_comparison`, `body_audio_coupling`,
+  `dynamics_coupling` (now stored as `*_figure`) and the warp result (now `self.warp_video`).
+- `blend()` ignored its `filename` argument (it always read `self.filename`).
+- `grid()` ignored its `target_name` argument (it always wrote `<input>_grid.png`).
+- Corrected stale `overwrite` docstrings (now default `True`), documented the previously
+  undocumented `convert` parameter on `directograms`/`impacts`/`history_cv2`, and fixed several
+  quickstart errors (invalid `scale=` example; `_motiondata.csv`/`_descriptors.csv`/`.avi` names).
+
+### Added
+- Informative `repr` for `MgVideo` (frames, fps, size, audio) and `MgAudio`.
+- `MgVideo.duration` (seconds) and `MgVideo.n_frames` properties, and `MgAudio.duration` — clearing
+  up the `length` footgun (frame count for video vs seconds for audio).
+- `MgImage.save(path)` and `MgFigure.save(path)` to copy/save a result to a chosen location.
+- Documentation: an optional-dependency/extras matrix, core-class conveniences, a "Which method
+  should I use?" disambiguation table, and `pose_center()`/`pose_distance()` with examples + images.
+
+---
+
 ## [1.6.1] – 2026-06-27
 
 ### Added
@@ -386,7 +411,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-[Unreleased]: https://github.com/fourMs/MGT-python/compare/v1.6.1...HEAD
+[Unreleased]: https://github.com/fourMs/MGT-python/compare/v1.6.2...HEAD
+[1.6.2]: https://github.com/fourMs/MGT-python/compare/v1.6.1...v1.6.2
 [1.6.1]: https://github.com/fourMs/MGT-python/compare/v1.6.0...v1.6.1
 [1.6.0]: https://github.com/fourMs/MGT-python/compare/v1.5.0...v1.6.0
 [1.5.0]: https://github.com/fourMs/MGT-python/compare/v1.4.9...v1.5.0

docs/releases.md

@@ -1,6 +1,6 @@
 # Release Notes
 
-The current stable release is **MGT-python 1.6.1**.
+The current stable release is **MGT-python 1.6.2**.
 
 Install or upgrade from PyPI:
 
@@ -16,6 +16,15 @@ which is the single source of truth for release notes.
 
 ## Recent highlights
 
+### 1.6.2
+
+- `pose()` falls back to OpenPose when MediaPipe isn't installed (works out of the box).
+- Fixed method-shadowing (audio–movement reports / warp), `blend()`/`grid()` ignoring their
+  filename/target arguments, and several docstring/quickstart errors.
+- Informative `repr` for `MgVideo`/`MgAudio`; new `duration`/`n_frames` properties and
+  `MgImage.save()`/`MgFigure.save()`.
+- New docs: optional-extras matrix, core-class conveniences, and a "which method?" table.
+
 ### 1.6.1
 
 - `pose_center()` (centre on the global centroid) and `pose_distance()` (per-marker cumulative

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "musicalgestures"
-version = "1.6.1"
+version = "1.6.2"
 description = "Musical Gestures Toolbox for Python"
 readme = "README.md"
 license = {text = "GPL-3.0-or-later"}