OpenSCAD User Manual/Libraries

Library Locations

OpenSCAD places built-in libraries in a system-wide or bundled location. For user-supplied libraries, there are two options:

1. Use the built-in user library path:
   • Windows: My Documents\OpenSCAD\libraries
   • Linux: $HOME/.local/share/OpenSCAD/libraries
   • Mac OS X: $HOME/Documents/OpenSCAD/libraries
2. Put your libraries anywhere and define the OPENSCADPATH environment variable to point to the library folder. OPENSCADPATH can contain multiple paths in case you have library collections in more than one place.

Built-in Libraries

OpenSCAD bundles the MCAD library.

Old content: Library Links

Here is a collection of shape/part libraries that you can use in your OpenSCAD design. (see the include and use command)

Shapes by Catarina Mota

Contains the following modules:

(Included in the MCAD distro, see below)

(All these modules are 3D shapes despite some of them having 2D names)

• box(width, height, depth);
• roundedBox(width, height, depth, factor);
• cone(height, radius);
• oval(width, height, depth);
• tube(height, radius, wall);
• ovalTube(width, height, depth, wall);
• hexagon(height, depth);
• octagon(height, depth);
• dodecagon(height, depth);
• hexagram(height, depth);
• rightTriangle(adjacent, opposite, depth);
• equiTriangle(side, depth);
• 12ptStar(height, depth);

Shapes by Giles Bathgate

2D

• triangle(radius)
• reg_polygon(sides,radius)
• pentagon(radius)
• hexagon(radius)
• heptagon(radius)
• octagon(radius)
• nonagon(radius)
• decagon(radius)
• hendecagon(radius)
• dodecagon(radius)

3D

• cone(height, radius, center = false)
• oval_prism(height, rx, ry, center = false)
• oval_tube(height, rx, ry, wall, center = false)
• cylinder_tube(height, radius, wall, center = false)
• tubify(radius,wall) Tubifies any regular prism
• triangle_prism(height,radius)
• triangle_tube(height,radius,wall)
• pentagon_prism(height,radius)
• pentagon_tube(height,radius,wall)
• hexagon_prism(height,radius)
• heptagon_prism(height,radius)
• octagon_prism(height,radius)
• nonagon_prism(height,radius)
• decagon_prism(height,radius)
• hendecagon_prism(height,radius)
• dodecagon_prism(height,radius)
• torus(outerRadius, innerRadius)
• triangle_pyramid(radius)
• square_pyramid(width,height,depth)

Metric Fasteners by Giles Bathgate

All dimensions are proportional to the dia, so for example cap_bolt(3,15) will produce a M3 cap bolt with a 15mm threaded section.

• cap_bolt(dia,len)
• csk_bolt(dia,len)
• washer(dia)
• flat_nut(dia)
• bolt(dia,len)
• cylinder_chamfer(r1,r2)
• chamfer(len,r)

MCAD library

(Originally from github.com/D1plo1d/MCAD)

(The following is taken from the README, follow the link for the latest version)

Currently Provided Tools:

• involute_gears.scad (http://www.thingiverse.com/thing:3575):
  • gear()
  • bevel_gear()
  • bevel_gear_pair()

• gears.scad (Old version):
  • gear(number_of_teeth, circular_pitch OR diametrical_pitch, pressure_angle OPTIONAL, clearance OPTIONAL)

• motors.scad:
  • stepper_motor_mount(nema_standard, slide_distance OPTIONAL, mochup OPTIONAL)

Other tools (alpha quality):

• nuts_and_bolts.scad: for creating metric and imperial bolt/nut holes
• bearing.scad: standard/custom bearings
• screw.cad: screws and augers
• materials.scad: color definitions for different materials

Utils:

• math.scad: general math functions
• constants.scad: mathematical constants
• curves.scad: mathematical functions defining curves
• units.scad: easy metric units
• utilities: geometric functions and misc. useful stuff

ISO-standard screw threads

Metric and inch dimensions - ISO-standard thread profiles, for both external threads (bolt) and internal threads (nut) -- the clearances are slightly different between the two.

OpenSCAD Pinball Parts library

A set of pinball parts models for pinball design work. Includes models for 3d printing of the parts, 3d descriptions of mount holes for CNC drilling and 2d descriptions of parts footprint.

• popbumpers
• standup targets
• flippers
• lane guides
• plunger & launch lane
• drop targets
• posts
• studs
• vertical up kicker