View Issue Details

IDProjectCategoryView StatusLast Update
0001558File formatsFeaturepublic2021-02-06 06:31
Reporterpetebachant Assigned To 
PrioritynormalSeverityminorReproducibilityhave not tried
Status newResolutionopen 
Target Version0.20 
Summary0001558: Save CAD data as text (JSON) for version control
DescriptionThis may be too drastic of a change, but it would be really great to be able to use Git, or some other text-based version control tool with CAD data.
TagsNo tags attached.
FreeCAD Information



2014-05-19 21:02

reporter   ~0004702

I just found out that the FreeCAD format is actually a compressed archive containing XML files. Maybe an option to load/save uncompressed would suffice.


2014-05-22 01:33

manager   ~0004720

Revision control is a long-term goal of the FreeCAD developers, see


2014-05-22 07:17

developer   ~0004723

We save zip files, which contain different type of data.
What you could do is to extract the FCStd file to a directory and add the whole directory to your version control.

Putting everything into one text based file, (XML, JSON...) makes not much sense if we had to embed our BREP files.

We could try to use OCAF to get an XML representation of shapes.


2014-09-22 13:24

developer   ~0005145

It seems that OCAF XML just includes she Shapes as CDATA


2018-04-28 02:48

administrator   ~0011216



2019-08-11 05:57

reporter   ~0013410

Last edited: 2019-08-11 17:03

Version control with git in a gitlab or github project repo would be a great feature to improve open hardware projects team members collaboration.

The most usefull feature would be to be able to see live versions & branches of the different parts designed in a project by the different project members.

That's a feature Onshape has implemented and a short demo is available there:


2022-03-03 13:55

administrator   ~0016420

This ticket has been migrated to GitHub as issue 5585.

Issue History

Date Modified Username Field Change
2014-05-19 20:04 petebachant New Issue
2014-05-19 21:02 petebachant Note Added: 0004702
2014-05-22 01:33 normandc Note Added: 0004720
2014-05-22 07:17 shoogen Note Added: 0004723
2014-09-22 13:24 shoogen Note Added: 0005145
2017-01-16 10:19 Kunda1 Project FreeCAD => File formats
2018-04-28 02:48 Kunda1 Note Added: 0011216
2019-08-11 05:57 freelibre Note Added: 0013410
2019-08-11 17:03 freelibre Note Edited: 0013410
2021-02-06 06:31 abdullah Target Version => 0.20