Skip to main content

A FreeCAD addon and a CLI tool to manage tool libraries

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

btl-0.9.5.tar.gz (305.1 kB view details)

Uploaded Source

Built Distribution

btl-0.9.5-py3-none-any.whl (338.1 kB view details)

Uploaded Python 3

File details

Details for the file btl-0.9.5.tar.gz.

File metadata

  • Download URL: btl-0.9.5.tar.gz
  • Upload date:
  • Size: 305.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for btl-0.9.5.tar.gz
Algorithm Hash digest
SHA256 749411a779715ab11cf3ab9117c85f526e96585634ff3786f170ccd73000014f
MD5 90424a1c36b48a6f844822428e50c94a
BLAKE2b-256 1b693caf1fc1d1a2aa99fa181d0cc5f64c2c00c9d2410dd605dc0340e9d775b8

See more details on using hashes here.

File details

Details for the file btl-0.9.5-py3-none-any.whl.

File metadata

  • Download URL: btl-0.9.5-py3-none-any.whl
  • Upload date:
  • Size: 338.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for btl-0.9.5-py3-none-any.whl
Algorithm Hash digest
SHA256 7208596111f4db2f14700b604b699806dbb68ea759d548e1349bf5cea7bdadfd
MD5 a71befbb73d106c443332b62f5b70f6d
BLAKE2b-256 45b86a12326bc7228abf4d326eae6cbd447e7deeb01773c295466ea959e863b5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page