Python BVH Inspector

A lightweight Python tool for inspecting BVH(BioVision Hierarchy) motion capture files.

Features

• Full animation playback control
• Extract skeletal hierarchy information
• Extract T-pose information
• Extract world position & rotation for every joint in all frames

Getting Started

1. Install Dependencies

This project uses uv for managing Python environments.
Install it globally if you haven't:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Clone and Run

git clone https://github.com/xorespesp/py-bvh-inspector.git
cd py-bvh-inspector
uv run src/main.py /path/to/your/file.bvh