Docs › Command line › tools
tools
Read a tool library from Fusion 360, Vectric or NativeCAM, report what came across, and optionally save it as a NativeCAM library. Tool vendors publish their bits in these formats.
Synopsis
nativecam-cli tools <library.tools | library.json | library.vtdb> [-o out.json]
Libraries
| Format | Files |
|---|---|
| Fusion 360 | .tools (the zipped library Fusion exports) or .json |
| Vectric (VCarve, Aspire) | .vtdb tool databases. Vectric's older .tool files aren't supported. |
| NativeCAM | .json, as the app saves its tool library |
- Flat, ball, bull nose, V-bit, engraving, surfacing and drill bits are imported. Tapered ball nose, form, dovetail, roundover and thread bits are skipped, with a count for each reason. Holders and other non-cutting items are left out.
- Values a library leaves out (Vectric files have no cutting or shank lengths) are read from the bit's name where possible, otherwise filled conservatively and noted in the tool's notes, marked ⚠ in the app.
Output
$ nativecam-cli tools shop-tools.json -o tools.json
Fusion 360 tool library: 3 tools, 1 skipped
Ball Nose: 1
End Mill: 1
V-Bit: 1
skipped 1: tapered ball nose (not supported yet)
estimated: cutting length for 0, feed rate for 2, some value for 3
Wrote 3 tools to tools.json
- The first line gives the format, the tools imported and the number skipped.
- Then the count of each tool type, and each reason tools were skipped.
- estimated counts the tools whose cutting length or feed rate was filled in, and those where any value came from conservative defaults. Check those tools before cutting.
The example library is a small Fusion 360 JSON file written for these docs: three bits with one feed preset, a tapered ball nose and a holder.
Options
| Option | Description |
|---|---|
-o <path> | Save the imported tools as a NativeCAM library, numbered T1, T2, … in the order they were read. Without it, the command only reports. |
To use the bits in the app, import the library there with Tool Library ▸ ⋯ ▸ Import Tools…, which lets you search, filter and tick the ones you want. The app's own library lives in ~/Library/Application Support/NativeCAM/tools.json; don't overwrite it with -o.
Exit status
0 when the library was read (and written). 1 when the file is missing or can't be imported, or the output can't be written.