OpenSCAD User Manual

OpenSCAD is an open source application for modelling and animating Solid CAD objects in three dimensions.

It is offered as free software and is available for several platforms.

OpenSCAD provides a functional descriptive language that may be used to numerically describe a 3D object using primitive shapes assembled and combined using 3D boolean operations. It is well suited to Computer-aided design tasks that will lead to production using CNC machining or 3D Printing processes.

OpenSCAD is not an interactive modelling tool in the way that Blender or AutoCAD apps are. Rather it uses a compiler to generate a run-time process to draw the 3D shapes specified by the instructions in an OpenSCAD file. Its user interface does offer a feature rich editing panel for the .scad programs currently loaded, an on-screen preview, a rendering engine to produce images, and a limited animation function.

OpenSCAD renders in two modes, Preview and Render.

Preview uses OpenCSG and OpenGL to perform fast, frame buffer based rendering for the on-screen preview. This is a clever way of painting pixels without the effort of generating the mesh that a more rigorous rendering engine would want. There are some known issues with artifacts in preview rendering but they can be bypassed by doing a "full render" of the model.

The CGAL geometry engine is used to generate an accurate, polygonal mesh from the model that is then rendered into an image and displayed.

More recently development versions have replaced CGAL with Manifold for rendering.

OpenSCAD is available via the common distribution methods as listed on the downloads page.

Information about OpenSCAD development is available on GitHub.

The ways to participate in the community include the mailing list, and chatting on IRC.

Suggestions for features, feedback and bug reports may be written using GitHub Issues, but please read the preferred Way of Work before submitting.

These pages were originally created as part of the OpenSCAD User Manual, now in the process of being restructured.

1. First Steps
2. The OpenSCAD User Interface
3. Input Devices
4. Customizer
5. Animation
6. Rendering
7. Export
8. Paths
9. Using an external Editor with OpenSCAD
10. Integration with other applications
11. Using OpenSCAD in a command line environment

1. Language Introduction
2. Values and Data Types
3. Names of variables, functions etc.
4. Expressions
5. Flow of Control
6. 3D Modelling
7. 2D Modelling
8. Importing Geometry
9. Animation
10. Debugging
11. External Libraries

This section is about experimental features in developmentand thus only available in development snapshot versions.

The status of particular fixes and features may be seen in the GitHub project. Look for :

• branches
• pull-requests
• releases
• issues
• Project repository Readme.

Libraries

Example Projects

Strandbeest

Strandbeest

Hello There

Hello There

Notes on Building OpenSCAD from Sources

Choose your Platform:

• Linux/UNIX
• Cross-compiling for Windows - on Linux - on Mac OS X
• Building on Windows (Outdated)
• Building on Windows (New)
• Building on Mac OS X

Frequently Asked Questions

Tips and Tricks

A guided introduction to using OpenSCAD and to the OpenSCAD language is available in the OpenSCAD Tutorial.

Fablab Lannion (France) edited a nice French-language interactive tutorial that you might appreciate.

1. Command Glossary - Very short name and syntax reference
2. Frequently Asked Questions
3. Tips and Tricks

A guided introduction to using OpenSCAD and to the OpenSCAD language is available in the OpenSCAD Tutorial.

For Teachers: a basic 25-slide presentation from 2014 is available under GNUFDL to walk your students through the process of using OpenSCAD here.

A "cheat sheet" is a useful quick reference for the OpenSCAD language, with each item linking back to this Wikibook.

A list of books can be found here.

Periodically the two manuals below get cleaned up or have major transitions. Consider archiving the manuals prior to starting a major update.

This can be done for the two 'printable version' links below to the Internet Archive

• 2018-04-25 The OpenSCAD User Manual - Print Version & The OpenSCAD Language - Print Version
• 2019-07-22 The OpenSCAD User Manual Which includes links to the archives of the above two printed versions (as of this date).

The Wayback Machine no longer has a free user requested site archive, so below is just the two 'printable version' manuals

• 2020-12-11 The OpenSCAD User Manual - Print Version & The OpenSCAD Language - Print Version

Language Reference (old)