Thursday, July 18, 2024
Google search engine
HomeUncategorizedVersioning FreeCAD Files with Git

Versioning FreeCAD Files with Git

FreeCAD and git

I’ve been working a lot with FreeCAD since I got my 3D printer. It’s
been a mostly excellent experience, but I’ve run a couple issues.

Between the MacOS and Linux version of FreeCAD (both 0.19, maybe
different builds?), and transferring files between machines using
Nextcloud, a project that I’d been working on for a couple days became
broken to the point where I could no longer modify the sketches,
rendering it useless.

This has led me to find out how I can manage these files through
version control like git.

It would seem that FreeCAD files are nothing more than zip files
containing text documents, which should make this rather easy.

Unfortunately there isn’t a standard process to git control a
zipped folder, though I have come across a couple methods which
when used together, result in an adequate solution.

The main component of this workaround is a great little script called
zippey, which allows git to efficiently store zip files using
something called a filter attribute.

The second isn’t as much a tool as it is a snippet from a blog post
about diffing zip files using the diff attribute. By combining both
these methods we can arrive at a pretty good method of handling
FreeCAD save data.

The first step is to download the zippy python program. Since I
keep all source repositories under ~/src in directories based on
the website and user who created them, I’ll be cloning it to

Then I configure my ~/.gitconfig to so that the diff and filter
attribute settings are used globally. I’ll also setup a global git
attributes file so that I don’t need to set the association with
.FCStd files in each repo individually.

I add the following lines to my ~/.gitconfig.

[diff "zip"]
textconv = unzip -c -a
    attributesfile = ~/.gitattributes
[filter "zippey"]
    smudge = /home/dante/src/ d
    clean = /home/dante/src/ e

Then I create a ~/.gitattributes file with the following content.

*.FCStd filter=zippey
*.FCStd diff=zip

With this, git should be now be able to effectively diff and store
proper deltas when FreeCAD files are modified.

Keep in mind you need to redo this process on each computer you
plan on using this with, otherwise the files git produces won’t
make any sense.

Read More



Please enter your comment!
Please enter your name here

- Advertisment -
Google search engine

Most Popular

Recent Comments