**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.
- **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, Updating, and Restoring the Installer
The installer has a handful of management command that can be run in a terminal by using the path to the executable as the start of the command (referred to below as `{EXECUTABLE_PATH}`). On Mac, you need to add `/Contents/MacOS/freemocap_app` to the `freemocap.app` path to get the below commands to work.
To delete the installed version of FreeMoCap, you can run `{EXECUTABLE_PATH} self remove`. This will delete all of the data associated with the executable (but not your `freemocap_data` folder), and then you can manually delete the executable or app.
To update the installed version of FreeMoCap, you can run `{EXECUTABLE_PATH} self update`. This will update to the latest release of FreeMoCap.
If you have installed FreeMoCap through the installer but it will not successfully run, something may have happened during the installation process. You can try running `{EXECUTABLE_PATH} self restore`, which will delete the associated installation files and reinstall them. Ensure you give enough time for the installer to fully download when restoring.