Skip to content

A FreeCAD addon and command line tool for managing tool libraries

License

Notifications You must be signed in to change notification settings

knipknap/better-tool-library

Repository files navigation

Better Tool Library (BTL)

Better Tool Library (BTL) is a FreeCAD addon (plugin) that replaces the built-in tool library for the CAM (previously known as the 'Path') workbench. It also provides a standalone tool if you want to use your library outside of FreeCAD.

Warning

I advise you make a backup of your tool library. I guarantee for nothing, there may be bugs.

Feature Comparison

Feature Better Tool Library FreeCAD internal library
Modern UI X -
Provides a shape browser X -
Tool search X -
Powerful Feeds & Speeds calculator X -
Tool sketch for supported shapes X -
Use outside of FreeCAD X -
Provides built-in common shapes X -
Store tool notes and additional info X -
Auto-generates tool icons X -
Can be used with no document open X -
CLI tool for import/export X -
Read BTL files X X
Write BTL files X Deletes BTL extra data!¹
Import Fusion 360 tool library X -
Import from Camotics X -
Export to Camotics X X
Export to LinuxCNC X X

¹ The original FreeCAD CAM workbench tool editor deletes any unknown attributes from the tool when editing it. So if you use BTL to save BTL-only tool information like Supplier or Description, and then uninstall BTL and edit that tool with the FreeCAD tool editor again, the information will be erased.

Screenshots

Library Editor Shape Browser Tool Editor Feeds & Speeds

Installation

Prerequisites

  • Better Tool Library (BTL) is compatible with any FreeCAD version greater than or equal to version 0.19.
  • If you installed FreeCAD from source, you may also need to install the Python requirements. If you are using the Appimage this step is not necessary, as BTL has no requirements that are not already included in the Appimage.

Installation via the FreeCAD addon manager

  • Start FreeCAD
  • Open the Addon Manager via Tools -> Addon manager
  • Search for Better Tool Library and click on it
  • Press Install
  • You should see a prompt to restart FreeCAD, choose to restart

To run it, start FreeCAD and simply open the CAM workbench.
There should be a new icon at the end of the toolbar:

Toolbar

Installation in standalone mode

To use BTL via standalone (=outside of FreeCAD), you will have to install it using setuptools.

pip install btl

Instructions for running BTL that way are here.

Instructions

Some instructions can be found here:

Links