omdl  v0.6.1
OpenSCAD Mechanical Design Library
Installing

Table of Contents

Prerequisites

First install openscad-amu. A build script exists for Linux and Cygwin (pull requests for macos are welcome). If wget is not available, here is a downloadable link to the bootstrap script.

If the last step below reports the tool version, then the install likely completed successfully and the temporary directory may be removed as desired. Dependent on your operating system, file system, and/or user credentials, the install may or may not require elevated privileges as indicated by sudo: 

  $ mkdir tmp && cd tmp

  $ wget https://raw.githubusercontent.com/royasutton/openscad-amu/master/snapshots/bootstrap.{bash,conf} .
  $ chmod +x bootstrap.bash

  $ sudo ./bootstrap.bash --yes --install

  $ openscad-seam -v -V

More information can be found in the GitHib amu repository, where the source is maintained, and at amu on Thingiverse.

omdl

Now omdl can be compiled, verified, and installed. First download the source from the GitHub omdl repository, select the branch version, and start the install as follows:

  $ git clone https://github.com/royasutton/omdl.git
  $ cd omdl
  $ git checkout v0.6.1

  $ make scopes_exclude="manifest" all
  $ make install

By default, some things are not built, as controlled by the design flow variable scopes_exclude. To build everything, use the following:

  $ make list-scopes_exclude

  $ make scopes_exclude="" all

Now the library should have been installed to the OpenSCAD built-in library location along with the documentation that can be views with a web browser. Multiple versions can be installed simultaneously.

Have a look in:

  • Linux: $HOME/.local/share/OpenSCAD/libraries
  • Windows: My Documents\OpenSCAD\libraries

You may include the desired library component from your project as follows, replacing the version number as needed:

  include <omdl-v0.6/shapes/shapes2de.scad>;
  include <omdl-v0.6/shapes/shapes3d.scad>;
  ...

Snapshots

Library source release snapshots are periodically made available in the repository and at omdl on Thingiverse.