Skip to main content

Better Tool Library (BTL)

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

Warning If you decide to switch back from BTL to the FreeCAD internal tool library, you may lose any extra information that was entered using Better Tool Library, like tool notes and hardness.

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 dimension sketch for built-in tools X -
Can be used standalone 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 -
Provides CLI tool for import/export X -
Read BTL files X X
Write BTL files X Deletes BTL extra data!
Import from Camotics X -
Export to Camotics X X
Export to LinuxCNC X X

Screenshots

Library Editor Shape Browser Tool Editor Feeds & Speeds

Installation

Prerequisites

Better Tool Library (BTL) is compatible with FreeCAD 0.19 and 0.21.

Installation via the FreeCAD addon manager

  • Open FreeCAD
  • Open the Addon Manager via Tools -> Addon manager
  • Search for Better Tool Library
  • Click it
  • Click Install

To run it, just open the Path workbench and there should be a new icon at the end of the toolbar:

Toolbar

Installation in standalone mode

To use via standalone, you will have to install BTL via setuptools.

pip install btl

Alternative installation for the development version:

git clone https://github.com/knipknap/better-tool-library.git

To run the UI, you need to point qbtl to your FreeCAD directories:

export PYTHONPATH=/usr/share/freecad/Ext/:/usr/lib/freecad/lib/
qbtl path/to/your/toollibrary/

CLI tool

Better Tool Library also comes with a CLI tool. After installation via setuptools (see above), you can use it as shown below.

Show the command line syntax

btl --help
btl -f camotics create --help

Print the whole library

btl fctooldir/ show all

(default for -f is freecad, so it can be omitted in that case)

Adding a tool to an existing library

btl fctooldir/ create tool endmill

Converting from FreeCAD to Camotics tool table

btl fctooldir/ export -f camotics camoticstooldir/

Converting from FreeCAD to LinuxCNC tool table

btl fctooldir/ export -f linuxcnc linuxcnc.tbl

Converting from Camotics to FreeCAD tool table

btl -f camotics camtest/ export -f freecad fctooldir/

Links

Metadata

Release files for btl 0.9.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for btl 0.9.9
File Size Uploaded
btl-0.9.9.tar.gz 333.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for btl 0.9.9
File Interpreter ABI Platform
btl-0.9.9-py3-none-any.whl Python 3 none any Details

Total release size: 707.4 kB

Release files / btl-0.9.9.tar.gz

Download URL btl-0.9.9.tar.gz
Size 333.1 kB
Tags Source
SHA-256 checksum
How to use checksums
899cb1b153d862cbbc23927bfb50211745d9bdf1513cd33946b6f9f525e13b3e
BLAKE2b-256 checksum
How to use checksums
348ffbd3c4c2bf71aa8bbb66b9144df127d3cc8c4c9a57352892d5bb3b06eb38
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.5

Release files / btl-0.9.9-py3-none-any.whl

Download URL btl-0.9.9-py3-none-any.whl
Size 374.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3094682250205e0e068e9c319af176db6fcceeb65c25684a514be1af08cc4a62
BLAKE2b-256 checksum
How to use checksums
2d1854fc536598f1f43168490cd9e778e6865061c2058102623249e36af62681
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.5

Release history Release notifications | RSS feed

This release

0.9.9 This release

2 release files

0.9.5

2 release files

0.9.4

1 release file

0.9.3

1 release file

0.9.2

1 release file

0.9.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page