Skip to main content

Convert .bvh files (Biovision Hierarchy) to DeepMimic format.

Project description

BvhToMimic [WIP] Build Status PyPI version


The DeepMimic project currently offers no way to import custom reference motions. This is shown in DeepMimic issue #23. This project aims to transfer animation data from .BVH files into DeepMimic motion files. Motion files can then be used to train DeepMimic skills. Many thanks to user SleepingFox88 for starting off the project. Original repository can be found here. This repository currently works well with this database.


pip install bvhtodeepmimic
pip3 install bvhtodeepmimic

Will install the library together with the requirements. Currently works with python 3.6 or 3.7


Create a BvhConverter object:

from bvhtomimic import BvhConverter
converter = BvhConverter("./Settings/settings.json")

Generate the DeepMimic text from a .bvh file:

converter.convertBvhFile("pathToBvhFile", loop=False)

Or write directly to file:

converter.writeDeepMimicFile(pathToBvhFile, outputPath)

Or use the example script that will convert all .bvh files located in ./InputBvh/ into Mimic Motion files, located in ./OutputMimic/ .



(GIF has been generated using this mocap file from this database.)


Watch more videos of recorded conversions here.

Creating a settings file

Currently joints in .bvh files have to be manually assigned by name to the corresponding joints in the DeepMimic humanoid model. This is done by assigning the .bvh model's bone names to the corresponding joint properties in ./Settings/settings.json. On top of the joint assignments, this file should also include settings to change the scale by which the .bvh file should be transformed, and the joints used to identify the root rotation of the model.

Related Projects

List of related projects


This code has been developed within the ACRO research group.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for bvhtodeepmimic, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size bvhtodeepmimic-0.0.5.tar.gz (6.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page