📝 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

We're in the process of switching over to the alpha phase of this project (v0.1.0 and on) , which use full refactor code written with help from a professional experienced software architect.

Until the new code stabilizes, you may have more luck using the pre-alpha code (e.g. v0.0.54)

Note: This will install the latest/last version from the pre-alpha phase of this project, frozen at release tag v0.0.54 here

Open an Anaconda-enabled command prompt or powershell window and enter the following commands:

1. Create a Python3.7 Anaconda environment

conda create -n freemocap-env python=3.7

2. Activate that newly created environment

conda activate freemocap-env

3. Install freemocap (version 0.0.54) from PyPi using pip

pip install freemocap==0.0.54

BUG FIX - Update mediapipe with: pip install mediapipe --upgrade

That should be it!

tl;dr- Activate the freemocap Python environment and run the following lines of code (either in a script or in a console)

import freemocap
freemocap.RunMe()

But COOL KIDS will install Blender (blender.org and generate an awesome .blend file animation by setting useBlender=True:

import freemocap
freemocap.RunMe(useBlender=True)

👉 For additional, more detailed instructions (including methods to re-process recorded sessions), refer to the OLD_README.md document) 👈

NOTES

• no promises here, friends. Work in progress lol 😂
• Personally, I run the gui through PyCharm, but its easier to write instructions on how to run from an anaconda prompt

1. Install Anaconda
   • https://anaconda.org
2. Install git
   • https://git-scm.com/book/en/v2/Getting-Started-Installing-Git (just use the defaults)
3. (OPTIONAL) Install Blender - https://blender.org

1. Open anaconda enabled terminal

2. Create a python=3.9 environment

conda create -n freemocap-gui python=3.9

3. Activate that environment:

conda activate freemocap-gui

4. Clone the repository (i.e. download the code from github. It'll show up in the current working directory of your terminal session)

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

5. Navigate into that newly cloned/downloaded freemocap folder with:

cd freemocap

6. Install the dependencies listed in the requirements.txt file:

pip install -r requirements.txt

7. Run the GUI by running the src/gui/main/main.py file by entering this command into the terminal:

python src/gui/main/main.py

8. Hopefully a GUI popped up! There are no docs on usage yet, so just click and see what you can figure out 😂

After you've done the easy install instructions, you'll be able to run our repo commands

1. Run the "setup" command to set up your environment

task setup

2. Run the tests to ensure that everything works appropriate

task test

Please read our contribution doc: CONTRIBUTING.md

Create a new binary on your local system by running the below comand

task installer

Navigate to the /dist/ directory and you'll see the new FreeMoCap Binary there.

• Jon Matthis
• Endurance Idehen

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