The Bricklayer install software bundles an IDE, a set of graphics libraries, and web viewer. This provides a self-contained environment for constructing Bricklayer programs and viewing the results of their execution.

Download and open the Bricklayer dmg file.  If you have administrator privileges and wish to install the Bricklayer client for all users on the computer, simply drag the Bricklayer application to the Applications folder link shown in the dmg window.  Otherwise, drag the bricklayer application to a directory of your choosing.  After placing the Bricklayer application in a directory, you may drag the Bricklayer application into the dock.

In addition to its native web viewing capabilities, the Bricklayer graphics library also ties seamlessly to various third-party display tools (see the Bricklayer documentation for more details). The two primary third-party display tools are LEGO Digital Designer (LDD) and LDraw.

Bricklayer programs have a “dot-bl” extension (e.g., A Bricklayer program can be run by opening it using the Bricklayer IDE (aka Bricklayer) and then clicking on the run button.

Validating that an Install is Working

To validate that your installation is successful, do the following:

  1. Download the following zipped Bricklayer program to any folder you like: Test Program.
  2. Navigate to that location and unzip the file. The result is a file named
  3. Open the file in the Bricklayer app.
  4. Click on the Run button at the bottom of the Bricklayer window.
  5. LEGO Digital Designer (or LDraw) should open automatically and display the artifact

NOTE: To execute properly, Bricklayer programs must have a “bl” extension (e.g.,