Skip to content

gbroques/ose-3d-printer-workbench

Repository files navigation

OSE 3D Printer Workbench

Build Status Documentation Status Coverage Status FreeCAD Addon Manager Status

A FreeCAD workbench for designing 3D printers by Open Source Ecology for Distributive Enterprise.

Main Toolbar

Main Menu

Installation

  1. Identify where you need to manually download and install the workbench.
    • Common locations for various operating systems can be found on "Installing more workbenches" in the FreeCAD wiki.
    • You can also execute FreeCAD.getUserAppDataDir() within the Python console in FreeCAD for this location. Workbenches will always go into the Mod directory in the user's application data directory.
  2. Download the workbench as a ZIP archive and extract, or use command-line git to clone the repository into the correct location (e.g. ~/.FreeCAD/Mod/ose-3d-printer-workbench)
  3. Follow step 2 for ose-workbench-core by downloading or cloning into the same directory (e.g. ~/.FreeCAD/Mod/ose-workbench-core).

Additionally, there are installation walk-through videos on YouTube featuring instructions with and without the command-line:

Documentation

Documentation is hosted at the following URL:

https://ose-3d-printer-workbench.readthedocs.io/en/latest/

Contributing

See Contributing Guidelines.

License

Licensed under the GNU Lesser General Public License, version 2.1 or LGPL v2.1. See LICENSE for details.

This is the same license as FreeCAD to ensure this code could potentially be incorporated into future FreeCAD modules or FreeCAD source itself.

Limitations

  • Attaching axes to rotated frame is not supported.

Supported FreeCAD Versions

This workbench supports FreeCAD 19.

FreeCAD 16 - 18

If you'd like to use this workbench with an older version of FreeCAD like 16, 17, or 18, then you can checkout v0.1.0 of the workbench.

After cloning the repository, from within the repository, run:

git checkout v0.1.0