# SaveUtils – FreeCAD Workbench Addon

![SaveUtils Example in the FreeCAD File menu](https://jefftml.s3.amazonaws.com/thumbs/SaveUtilsExample1.png)

[SaveUtils](https://github.com/jefe317/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