Freemocap

Latest version: v1.2.2

Safety actively analyzes 641872 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

1.2.0

**Highlights**
- **`freemocap_data` folder is now configurable:** You can set any folder location to use as your freemocap_data folder, and it will be remembered across sessions
- **Blender executable path is remembered across sessions:** Once you set a Blender executable path, it will now be remembered across sessions. If the automatic finder doesn't work, you will only need to manually find the path once, instead of having to reset it every session.
- **Deprecated legacy Blender export methods:** We have deprecated the "alpha megascript" blender methods, so the "ajc27_freemocap_blender_addon" is now the only option.
- **Enable Rigify automatically:** Now rigify is enabled automatically during the Blender export, removing a confusing barrier for first time users.
- **Improved sample data calibration:** We have updated the calibration file for both the sample and test data, so the output is higher quality.
- **Expose YOLO crop parameters:** Users can now set parameters for the YOLO crop preprocessing step, allowing for finer grained control of preprocessing.


**Full Changelog**
* Add YOLO Crop Parameters to Parameter Tree by philipqueen in https://github.com/freemocap/freemocap/pull/567
* Patch: Fix link in welcome screen by philipqueen in https://github.com/freemocap/freemocap/pull/568
* get rid of blender 4 exclusion by aaroncherian in https://github.com/freemocap/freemocap/pull/566
* Catch blender errors by philipqueen in https://github.com/freemocap/freemocap/pull/569
* removing estimate segment lengths by aaroncherian in https://github.com/freemocap/freemocap/pull/571
* Aaron/remove legacy blender code by aaroncherian in https://github.com/freemocap/freemocap/pull/572
* Updating status checker by philipqueen in https://github.com/freemocap/freemocap/pull/574
* Update sample and test data by philipqueen in https://github.com/freemocap/freemocap/pull/576
* User Settable Freemocap_data Path by philipqueen in https://github.com/freemocap/freemocap/pull/562
* Update Subrepos by philipqueen in https://github.com/freemocap/freemocap/pull/570
* Patch: check for OSerror when accessing drives by philipqueen in https://github.com/freemocap/freemocap/pull/582
* Add Charuco Board SVG to Assets by philipqueen in https://github.com/freemocap/freemocap/pull/583


[**Detailed Changelog**: https://github.com/freemocap/freemocap/compare/v1.1.1...v1.2.0](https://github.com/freemocap/freemocap/compare/v1.1.1...v1.2.0)

**Updating with Pip**
To update the installation with pip, run `pip install freemocap --upgrade`.

**Installing with Dedicated Installer**
- We are trying out [PyApp](https://docs.pyapp.info/en/latest/) as a method to create a non-CLI based installer
- Please note that this is our first time bundling installers, so there will likely be issues when trying to install and run them. You can always download FreeMoCap from PyPI following our [installation instructions](https://freemocap.github.io/documentation/installation.html). Some general and platform-specific notes about the installers are listed below:

‼️General Notes Before Using the Installer Executable:
- This is not an endgame solution, but it should be functional enough for the time being
- The first time you open the [PyApp](executable, it will install the necessary environment to run FreeMoCap.
- This means that **an internet connection is required the first time you open FreeMoCap with the executable**, but from then on, you can run it without internet connection.
- Please note that the installation process will require **roughly 3GB of available space**
- NOTE: This will take roughly 5-10 mins to install with no indication of installation. Please wait patiently :)
- As the installers are still experimental they will likely be flagged by your OS security settings

Platform-Specific Notes:

- **Windows:**
The FreeMoCap installers do not work on Windows 11 yet. We're currently working towards getting the software approved by Windows as virus free, but it will take some time.

- **Mac:**
The single installer should work on both Intel and Apple Silicon Macs.
To run the app, you will need to open the zip file and you will see the app, which you can drag to the Applications folder. The first time you open the app, it will tell you it is from an unidentified developer and ask if you would like to move it to the trash. Close out of that window, right click the app, click `Open`, and choose to open the file. Once you have done this once, you can open the app as normal in the future. For more information, see the [official Apple documentation](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac).

Deleting your FreeMoCap download, if necessary
To delete a version of FreeMoCap downloaded through an installer, you must delete both the executable/app file, and the PyApp file found in the path below. You can either delete the entire `freemocap` folder, or specific versions inside the folder.

| Platform | Path |
| ---- | ---- |
| macOS | `~/Library/Application Support/pyapp` |
| Windows | `%USERPROFILE%\AppData\Local\pyapp` |
| Unix | `$XDG_DATA_HOME/pyapp` (the [XDG_DATA_HOME](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables) environment variable default is `~/.local/share`) |

1.1.0

**Processing Pipeline Updates**
- **YOLO Cropping**: We've integrated a new pre-processing feature that utilizes YOLO cropping to significantly reduce false positives during tracking, especially enhancing the performance when using wide-angle cameras. See [YOLO Cropping](https://freemocap.github.io/documentation/yolo-cropping.html) in our docs for more info.

- **Reprojection Error Filtering**: We've added new post-processing step to filter and reprocess points with significant reprojection error. See [Reprojection Error Filtering](https://freemocap.github.io/documentation/reprojection-filtering.html) in our docs for more info.

- **More Multiprocessing Control**: Previously, the multiprocessing feature (i.e. how many videos you're processing simultaneously) automatically started a process for each video in a recording, which was essentially an all-or-nothing approach. This default setting limited users with less powerful hardware from leveraging multiprocessing. We've introduced a customizable option that enables users to specify the exact number of processes they want to use when processing a recording - which should allow more users to take advantage of it. See [Multiprocessing](https://freemocap.github.io/documentation/multiprocessing.html) in our docs for more info.

- **GUI Updates**: We've improved progress updates in the GUI, so it should be more apparent when processes are running. We've also updated our error handling and reporting throughout the program.

**New Installation Methods**
- We are trying out [PyApp](https://docs.pyapp.info/en/latest/) as a method to create a non-CLI based installer
- Please note that this is our first time bundling installers, so there will likely be issues when trying to install and run them. You can always download FreeMoCap from PyPI following our [installation instructions](https://freemocap.github.io/documentation/installation.html). Some general and platform-specific notes about the installers are listed below:

‼️General Notes Before Using the Installer Executable:
- This is and endgame solution, but it should be functional enough for the time being
- The first time you open the [PyApp](executable, it will install the necessary environment to run FreeMoCap.
- This means that **an internet connection is required the first time you open FreeMoCap with the executable**, but from then on, you can run it without internet connection.
- Please note that the installation process will require **roughly 3GB of available space**
- NOTE: This will take roughly 5-10 mins to install with no indication of installation. Please wait patiently :)
- As the installers are still experimental they will likely be flagged by your OS security settings

Platform-Specific Notes:

- **Windows:**
The FreeMoCap installers do not work on Windows 11 yet. We're currently working towards getting the software approved by Windows as virus free, but it will take some time.

- **Mac:**
The single installer should work on both Intel and Apple Silicon Macs.
To run the app, you will need to open the zip file and you will see the app, which you can drag to the Applications folder. The first time you open the app, it will tell you it is from an unidentified developer and ask if you would like to move it to the trash. Close out of that window, right click the app, click `Open`, and choose to open the file. Once you have done this once, you can open the app as normal in the future. For more information, see the [official Apple documentation](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac).

Deleting your FreeMoCap download, if necessary
To delete a version of FreeMoCap downloaded through an installer, you must delete both the executable/app file, and the PyApp file found in the path below. You can either delete the entire `freemocap` folder, or specific versions inside the folder.

| Platform | Path |
| ---- | ---- |
| macOS | `~/Library/Application Support/pyapp` |
| Windows | `%USERPROFILE%\AppData\Local\pyapp` |
| Unix | `$XDG_DATA_HOME/pyapp` (the [XDG_DATA_HOME](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables) environment variable default is `~/.local/share`) |

1.0.25

There's all sorts of number bigger than 1 💫



---
What's Changed
* Jon/full refactor by jonmatthis in https://github.com/freemocap/freemocap/pull/332
* super basic update of readme to run refactored GUI by jonmatthis in https://github.com/freemocap/freemocap/pull/336
* redirect old entry points by jonmatthis in https://github.com/freemocap/freemocap/pull/338
* Jon/add pypi action by jonmatthis in https://github.com/freemocap/freemocap/pull/339
* Trent/choose your blender by trentwirth in https://github.com/freemocap/freemocap/pull/341
* added color to selected tab by trentwirth in https://github.com/freemocap/freemocap/pull/344
* Trent/color restyling by trentwirth in https://github.com/freemocap/freemocap/pull/347
* Fix blender executable path input on mac by philipqueen in https://github.com/freemocap/freemocap/pull/345
* Add mediapipe silicon support by philipqueen in https://github.com/freemocap/freemocap/pull/351
* Trent/single camera 2 by trentwirth in https://github.com/freemocap/freemocap/pull/342
* Improve case handling with video files by philipqueen in https://github.com/freemocap/freemocap/pull/350
* need to grab JUST x and y for 3D triangulation by trentwirth in https://github.com/freemocap/freemocap/pull/354
* Trent/tab reorg by trentwirth in https://github.com/freemocap/freemocap/pull/355
* Trent/better pipedream pings by trentwirth in https://github.com/freemocap/freemocap/pull/356
* Add privacy policy link by philipqueen in https://github.com/freemocap/freemocap/pull/357
* Color contrast improvements by philipqueen in https://github.com/freemocap/freemocap/pull/361
* Add help and support menus by philipqueen in https://github.com/freemocap/freemocap/pull/359
* hot fix - crashing on post-process when a marker has no data by jonmatthis in https://github.com/freemocap/freemocap/pull/363
* Aaron/batch processing by aaroncherian in https://github.com/freemocap/freemocap/pull/371
* Working parameter tree by philipqueen in https://github.com/freemocap/freemocap/pull/366
* Auto find blender path on mac by philipqueen in https://github.com/freemocap/freemocap/pull/369
* hotfix crash when checking status of non-existent folders by jonmatthis in https://github.com/freemocap/freemocap/pull/372
* disable repojection error filter (for now by jonmatthis in https://github.com/freemocap/freemocap/pull/373
* Headless Calibration by philipqueen in https://github.com/freemocap/freemocap/pull/377
* Philip/recoloring by philipqueen in https://github.com/freemocap/freemocap/pull/374
* End to end testing by philipqueen in https://github.com/freemocap/freemocap/pull/375
* Material colors styling by philipqueen in https://github.com/freemocap/freemocap/pull/400
* Automate end to end testing by philipqueen in https://github.com/freemocap/freemocap/pull/401
* Update README.md by jonmatthis in https://github.com/freemocap/freemocap/pull/403
* Jon/vss2023 by jonmatthis in https://github.com/freemocap/freemocap/pull/407
* Patch: papermill in headless processing by philipqueen in https://github.com/freemocap/freemocap/pull/410
* Error catching in headless processing by philipqueen in https://github.com/freemocap/freemocap/pull/408
* Update latest rc version in pip install instructions by philipqueen in https://github.com/freemocap/freemocap/pull/406
* Save parameter state by philipqueen in https://github.com/freemocap/freemocap/pull/404
* HOT FIX: fix JSON not found error by philipqueen in https://github.com/freemocap/freemocap/pull/433
* improve save_dictionary_to_json to pathlib native syntax by newturok in https://github.com/freemocap/freemocap/pull/432
* Aaron/postprocessing improvements by aaroncherian in https://github.com/freemocap/freemocap/pull/431
* Pin dependency versions by philipqueen in https://github.com/freemocap/freemocap/pull/440
* Test across versions with nox by philipqueen in https://github.com/freemocap/freemocap/pull/429
* Jon/recording data package by jonmatthis in https://github.com/freemocap/freemocap/pull/422
* Jon/log colors by jonmatthis in https://github.com/freemocap/freemocap/pull/443
* Change README to always install latest pip pre release by philipqueen in https://github.com/freemocap/freemocap/pull/441
* Fix Pydantic Errors by CypressJack in https://github.com/freemocap/freemocap/pull/439
* PATCH: Change freemocap_main back to main by philipqueen in https://github.com/freemocap/freemocap/pull/446
* Tweaks to Blender output by jonmatthis in https://github.com/freemocap/freemocap/pull/445
* adding postprocessing improvements by aaroncherian in https://github.com/freemocap/freemocap/pull/437
* unpin mediapipe by jonmatthis in https://github.com/freemocap/freemocap/pull/449
* Create CODE_OF_CONDUCT.md by philipqueen in https://github.com/freemocap/freemocap/pull/451
* Save gui state by philipqueen in https://github.com/freemocap/freemocap/pull/421
* Find linux executable by philipqueen in https://github.com/freemocap/freemocap/pull/442
* Load sample data button by philipqueen in https://github.com/freemocap/freemocap/pull/420
* Add option to synchronize videos on import by philipqueen in https://github.com/freemocap/freemocap/pull/379
* Console Log Fix by philipqueen in https://github.com/freemocap/freemocap/pull/434
* Remove final Darkmode Bugs by philipqueen in https://github.com/freemocap/freemocap/pull/452
* Lint everything with Black by philipqueen in https://github.com/freemocap/freemocap/pull/453
* Add notes about testing in CONTRIBUTING.md by philipqueen in https://github.com/freemocap/freemocap/pull/447
* PATCH: thresholding error by philipqueen in https://github.com/freemocap/freemocap/pull/459
* Generate Jupyter Notebook w/o papermill by philipqueen in https://github.com/freemocap/freemocap/pull/456
* Flake 8 adoption by philipqueen in https://github.com/freemocap/freemocap/pull/455
* Geometry unit testing by philipqueen in https://github.com/freemocap/freemocap/pull/457
* Welcome screen by philipqueen in https://github.com/freemocap/freemocap/pull/460
* PATCH: fix batch processing error by philipqueen in https://github.com/freemocap/freemocap/pull/464
* Jon/make multiprocessing optional by jonmatthis in https://github.com/freemocap/freemocap/pull/470
* Fix calibration toml finding by philipqueen in https://github.com/freemocap/freemocap/pull/471
* add `feedback` and `donation` link, check for new version by jonmatthis in https://github.com/freemocap/freemocap/pull/472
* Update opencv version to 4.8 by philipqueen in https://github.com/freemocap/freemocap/pull/473
* fix broken privacy policy link by trentwirth in https://github.com/freemocap/freemocap/pull/476
* Don't run linting with nox version testing by philipqueen in https://github.com/freemocap/freemocap/pull/480
* Jon/update home widget by jonmatthis in https://github.com/freemocap/freemocap/pull/479
* Patch breaking changes in skelly_synchronize by philipqueen in https://github.com/freemocap/freemocap/pull/482
* PATCH: offline failure by philipqueen in https://github.com/freemocap/freemocap/pull/492
* Philip + Trent: window sizing by philipqueen in https://github.com/freemocap/freemocap/pull/489
* AJC Blender output and numerous other things by jonmatthis in https://github.com/freemocap/freemocap/pull/497

New Contributors
* newturok made their first contribution in https://github.com/freemocap/freemocap/pull/432
* CypressJack made their first contribution in https://github.com/freemocap/freemocap/pull/439

**Full Changelog**: https://github.com/freemocap/freemocap/compare/v0.1.0...v1.0.25

1.0.0rc

There's all sorts of number after '1' ✨

0.1.0

Freezing the "Alpha GUI" code in preparation to merge branch: `jon/full-refactor` onto main.

Install dependencies with `pip install -r requirements.txt`
To launch the GUI with this version of the code - run `src/gui/main/main.py`

What's Changed (Auto-generated changelog from clicking the "Generate release notes" button)

* Jon/orchestrated pipeline by jonmatthis in https://github.com/freemocap/freemocap/pull/136
* Jon/alpha pipeline by endurance in https://github.com/freemocap/freemocap/pull/183
* DELETE ALL THE THINGS by endurance in https://github.com/freemocap/freemocap/pull/184
* Update READ.me with screen recording of install by kileyhartigan in https://github.com/freemocap/freemocap/pull/43
* Multiple typo/spelling/grammar fixes. by follower in https://github.com/freemocap/freemocap/pull/83
* Endurance/162 GitHub actions ci testing by endurance in https://github.com/freemocap/freemocap/pull/185
* Pyinstaller + Readme Refactor by endurance in https://github.com/freemocap/freemocap/pull/187
* Use Black to format all of `src` and add Contribution Guidelines by endurance in https://github.com/freemocap/freemocap/pull/188
* Update README.md by jonmatthis in https://github.com/freemocap/freemocap/pull/189
* quick-n-dirty user survey before twitch stream by jonmatthis in https://github.com/freemocap/freemocap/pull/190
* pin freemocap version to `v0.0.54` by jonmatthis in https://github.com/freemocap/freemocap/pull/193
* Start building Knowledge Base with `mkdocs` by jonmatthis in https://github.com/freemocap/freemocap/pull/212
* Update `readme` to include installation and basic useage instructions for `v0.0.54` version by jonmatthis in https://github.com/freemocap/freemocap/pull/194
* Jon/remove matplotlib issue 208 by jonmatthis in https://github.com/freemocap/freemocap/pull/214
* Jon/gui/lets make a working pipeline by jonmatthis in https://github.com/freemocap/freemocap/pull/221
* Correct use_saved_calibration parameter by philipqueen in https://github.com/freemocap/freemocap/pull/226
* Jon/gui/threads in cams by jonmatthis in https://github.com/freemocap/freemocap/pull/228
* Aaron/bugfixing 0902 by aaroncherian in https://github.com/freemocap/freemocap/pull/230
* Jon/blender path stuff by jonmatthis in https://github.com/freemocap/freemocap/pull/232
* Jon/npy to csv ipynb by jonmatthis in https://github.com/freemocap/freemocap/pull/234
* Jon/visualize mocap data by jonmatthis in https://github.com/freemocap/freemocap/pull/236
* Trent/pipedream pings by trentwirth in https://github.com/freemocap/freemocap/pull/238
* Jon/clean up gui by jonmatthis in https://github.com/freemocap/freemocap/pull/239
* Jon/camera windows by jonmatthis in https://github.com/freemocap/freemocap/pull/242
* update readme by jonmatthis in https://github.com/freemocap/freemocap/pull/243
* Jon/sesh setup screen by jonmatthis in https://github.com/freemocap/freemocap/pull/244
* Jon/sesh setup screen by jonmatthis in https://github.com/freemocap/freemocap/pull/245
* Jon/timestamp diagnostic plots by jonmatthis in https://github.com/freemocap/freemocap/pull/246
* Jon/load external videos by jonmatthis in https://github.com/freemocap/freemocap/pull/248
* add start of PR guidelines by jonmatthis in https://github.com/freemocap/freemocap/pull/253
* Jon/convert to csv by jonmatthis in https://github.com/freemocap/freemocap/pull/254
* Add Zenodo DOI badge by jonmatthis in https://github.com/freemocap/freemocap/pull/265
* add Discord server badge by jonmatthis in https://github.com/freemocap/freemocap/pull/266
* Jon/post process data by jonmatthis in https://github.com/freemocap/freemocap/pull/249
* Jon/manually align skeleton by jonmatthis in https://github.com/freemocap/freemocap/pull/270
* Run through while making the 'process from recorded videos' how to by jonmatthis in https://github.com/freemocap/freemocap/pull/271
* simple fixes I forgot to push in the last commit lol by jonmatthis in https://github.com/freemocap/freemocap/pull/272
* add - how to process external vids with GUI by jonmatthis in https://github.com/freemocap/freemocap/pull/273
* fix typo in readme URL by jonmatthis in https://github.com/freemocap/freemocap/pull/274
* Jon/clean up some stuff by jonmatthis in https://github.com/freemocap/freemocap/pull/275
* Update requirements.txt by jonmatthis in https://github.com/freemocap/freemocap/pull/277
* add extra logs to camera detection by jonmatthis in https://github.com/freemocap/freemocap/pull/278
* add check camera connections script by jonmatthis in https://github.com/freemocap/freemocap/pull/279
* add `opencv-contrib-python==4.6.0.66` by jonmatthis in https://github.com/freemocap/freemocap/pull/287
* Fix links to GitHub flow in CONTRIBUTING.md by philipqueen in https://github.com/freemocap/freemocap/pull/293

New Contributors
* kileyhartigan made their first contribution in https://github.com/freemocap/freemocap/pull/43
* follower made their first contribution in https://github.com/freemocap/freemocap/pull/83

**Full Changelog**: https://github.com/freemocap/freemocap/compare/v0.0.54...v0.1.0

0.0.54

This is the Freemocap Pre-Alpha Release to create raw 3d skeletons from USB connected webcams

Here is the relevant README for this version of `freemocap v0.0.54`:
https://github.com/freemocap/freemocap/blob/main/OLD_README.md

Links

Releases

© 2024 Safety CLI Cybersecurity Inc. All Rights Reserved.