We have instructions on installing FreeMoCap in our Installation Guide, but sometimes things don't go as smoothly as planned. This guide will help you work through common problems encountered while installing the software, and hopefully get FreeMoCap running in no time. At the bottom of the page is a list of common error messages you may see during installation, along with common solutions.
If you're still having problems installing FreeMoCap after troubleshooting with the tips below, reach out to us on our Discord to ask for more help.
Use a New Environment¶
Different python projects have different dendencies, and often those dependencies can clash with each other. If you have any installation problem, our first advice is to try installing and running FreeMoCap in a new, dedicated environment. There's many options for creating and managing environments in Python - we recommend Poetry and Conda.
Check your Python Version¶
Currently, FreeMoCap works on Python versions 3.9 through 3.11. We recommend using the most recent compatible version of Python. If installing FreeMoCap in a 3.11 environment doesn't work for you, then try it with a different python version and see if that helps.
Check your FreeMoCap Version¶
FreeMoCap is under active development, and we try to address bugs as quickly as we can. It is always best to install the latest version of the software. If a prior installation isn't working, you can update versions by running
pip install freemocap --upgrade.
When pip begins installing the software, it will print which version it is installing. You can compare that to the most recent version listed on PyPi to make sure it is up to date.
Common Error Messages¶
Command "freemocap" not recognized¶
- On some python installations, you may need to type
python -m freemocapinstead of just
freemocapto launch the gui.