SaveUtils – FreeCAD Workbench Addon

SaveUtils adds two convenience commands to FreeCAD's File menu:

| Command | What it does | |---|---| | Save As with Timestamp | Saves a copy as <basename>-YYYYMMDD-HHMMSS.FCStd | | Save As Increment | Saves a copy as <basename>-01.FCStd, …-02.FCStd, etc. |

Both commands switch FreeCAD to the newly saved file so you keep working in it.

Behavior details

Save As with Timestamp

• Pattern appended: -YYYYMMDD-HHMMSS.FCStd
• If the current filename already ends with this pattern it is replaced, not doubled.

design-20240101-120000.FCStd → design-20240315-093045.FCStd

• Unsaved document: a file-picker dialog asks for a base filename first.

Save As Increment

• Pattern appended: -NN.FCStd (always zero-padded to 2 digits).
• If the filename already ends with -N.FCStd or -NN.FCStd the number is incremented:

design-03.FCStd → design-04.FCStd design-8.FCStd → design-09.FCStd

• Unsaved document: a file-picker dialog asks for a base filename first.

Installation

Manual

Add this repository to your Addon Custom Repositories

1. In FreeCAD, go to Edit > Preferences > Addon Manager.
2. Under Costom Repositories, click the green plus button to Add https://github.com/jefe317/SaveUtils/ with the branch main.
3. Click Apply, close the Preferences window.
4. In Tools > Addon Manager, you can now search for "SaveUtils" and install it via the Install button.
5. Restart FreeCAD.

The two items appear near the top of File → Save As with Timestamp / Save As Increment.

Via Addon Manager

If this repo is listed in a custom addon source, you can install it through Tools > Addon Manager > Search for SaveUtils > Install.

Requirements

• FreeCAD 0.20 or later
• PySide2 (bundled with FreeCAD)

License

GPL v3