freemocap

The FreeMoCap Project

A free-and-open-source, hardware-and-software-agnostic, minimal-cost, research-grade, motion capture system and platform for decentralized scientific research, education, and training

https://user-images.githubusercontent.com/15314521/192062522-2a8d9305-f181-4869-a4b9-1aa068e094c9.mp4

--

QUICKSTART

0. Create a a Python 3.10 through 3.12 environment (python3.11 recommended)¶

1. Install software via pip:

pip install freemocap

2. Launch the GUI by entering the command:

freemocap

3. A GUI should pop up that looks like this:

4. Have fun! It might break! Work in Progress lol

5. Join the Discord and let us know how it went!

---

Install/run from source code (i.e. the code in this repo)

Open an Anaconda-enabled command prompt (or your preferred method of environmnet management) and enter the following commands:

1. Create a Python environment (Recommended version is python3.11)

conda create -n freemocap-env python=3.11

1. Activate that newly created environment

conda activate freemocap-env

1. Clone the repository

git clone https://github.com/freemocap/freemocap

1. Navigate into the newly cloned/downloaded freemocap folder

cd freemocap

1. Install the package via the pyproject.toml file

pip install -e .

1. Launch the GUI (via the freemocap.__main__.py entry point)

python -m freemocap

A GUI should pop up!

---

Documentation

Our documenation is hosted at: https://freemocap.github.io/documentation/index_md.html

That site is built using writerside from this repository: https://github.com/freemocap/documentation

---

Contribution Guidelines

Please read our contribution doc: CONTRIBUTING.md

Related

Maintainers

• Jon Matthis
• Endurance Idehen

License

This project is licensed under the APGL License - see the LICENSE file for details.

If the AGPL does not work for your needs, we are happy to discuss terms to license this software to you with a different agreement at a price point that increases exponentially as you move spiritually away from the AGPL