FreeCAD is a Free (as in Libre) multiplatform Open Source Parametric 3D CAD software.
Homebrew is a MacOSX Package Manager.
The primary and frequent use case for this formula is for developers to conveniently install all the required FreeCAD dependencies to support FreeCAD development.
NOTE: If you are looking for the current macOS builds, please download the latest build from GitHub
Alternatively there are versions of FreeCAD & friends built using conda, there are a weekly releases published here
Install homebrew
Developers may find it convenient to simply install the pre-requisites prior to cloning the FreeCAD repo for development builds.
brew tap freecad/freecad
brew install --only-dependencies freecadBy default, freecad is installed as a binary to be launched from a CLI. To also create a .app bundle use --with-macos-app.
brew tap freecad/freecad
brew install freecad -vbrew install --HEAD freecadThe Travis CI system uses this freecad formula to build and test FreeCAD every time a change is made to the FreeCAD/FreeCAD repo meaning that the formula is very well tested itself.
Submitting PR's for this repo can go along way, that's not to say it's an easy task. Following the below guidelines will help all that use this repo.
- when submitting a PR, rebase all commits into a single commit
homebrew test-bot currently will fail ❌ to publish a bottle if a PR contains more than one commit. A quick solution is to rebase, and squash all unneeded commits thus making the brew test-bot happy. learn more
- when submitting a PR that is updating or adding a new formula file, only add or change one formula file in a PR.
brew test-bot will fail if a PR contains two distinct formula files being edited and will be unable to publish the bottles for the edited formula.
- looking at how upstream homebrew-core manages PRs, each PR only edits one formula file at a time.
Not all PR's require running through the CI, one example would be updating this README file.
If a PR does not update a formula file within this repo then within the PR description,
and in the commit message add the following [no ci] allowing the PR to be merged into
the repo without running CI checks.
For maintainers of this repo, I have setup this repo using self-hosted runners for macOS Mojave, Catalina, and Big Sur (Intel only) versions of macOS. These self-hosted runners all run on a late macbook pro 2013 model that runs archlinux allowing the virtual machines to be started and stopped thanks to qemu+kvm.
Self-hosted runners will disappear from a repo on GitHub if they are not used within 30 days. However, a new self-hosted runner can be readded to this repo using github's web based UI. After the runner is added and labeled properly than the runner can pick up the job, and the status of the job can be viewed from the actions tab at the top of the repo.
I've had to readd macos vm's several times due to inactivity, but isn't an issue as the self-hosted runner picks up where it left off. More information about this nuance can be provided upon request.
Recently a CI action has been created to check the online status of the self-hosted runners. An email will be sent to the maintainer designated in the github action.
A great resource for learning how other Operating Systems (GNU+Linux distros) assemble the dependencies for freecad can be seen at repology.org
Creating patch files for formula contained within this repo can be a difficult task, so the below steps aim to aid in the creation of patch files.
When freecad 0.20.1 was released it did not have support for python 3.11 however a consolidated commit has been made that should allow the 0.20.1 release to build and run against python 3.11
the below video demonstrates how I created a patch file for python 3.11 support
make.patch.file.mp4
- publish bottles for older versions of macos ie.
mojave& high sierra, there is an active discussion about the topic here
See GitHub Issues
Sam Nelson originally developed the freecad homebrew recipe repo circa April 2014 and transferred it to the FreeCAD organization in October 2016.