freemocap 1.8.2

A free and open source markerless motion capture system for everyone 💀✨

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

[!NOTE] For detailed installation instructions, see our official documentation's Installation page

0. Create a a Python 3.10 through 3.12 environment (python3.12 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! See the Beginner Tutorials on our official docs for detailed instructions.

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 environment management) and enter the following commands:

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

conda create -n freemocap-env python=3.11

2. Activate that newly created environment

conda activate freemocap-env

3. Clone the repository

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

4. Navigate into the newly cloned/downloaded freemocap folder

cd freemocap

5. Install the package via the pyproject.toml file

pip install -e .

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

python -m freemocap

A GUI should pop up!

---

Documentation

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

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