JolliCube (8x8x8 LED Cube) With MD_Cubo Library





Introduction: JolliCube (8x8x8 LED Cube) With MD_Cubo Library

So far, we have only built 3 LED cubes. Our first cube is a 4x4x4 LED cube and though we managed to successfully complete it without too much difficulty, we did not find much excitement and satisfaction experimenting with it.

Next, we designed, created and built our second cube, an 8x8x8 LED cube driven using the awesome MAX7219 ICs almost a year ago. You may check out our instructable on jolliCube if you are interested.

The main objective of creating jolliCube is to encourage electronics hobbyist looking into building their first LED cube to take a leap of faith to build a larger cube instead of building a small 4x4x4 or 5x5x5 LED cube.

Though building an 8x8x8 cube requires a lot more effort and patience, it is very much more exciting to experiment with it. We are sure that all electronics hobbyists who are able to successfully complete an 8x8x8 LED cube will feel an indescribable sense of satisfaction like we do if that is their first LED cube.

We built our third LED cube which is another 8x8x8 jolliCube but in a different LED color (orange) recently just to refresh ourselves on our building process. We will be using this cube for this instructable.

We are very encouraged to know that quite a handful of electronics hobbyists have successfully built their jolliCubes. However, once a while we received requests for more animation effects for jolliCube. We understand that it is not an easy task to create new and interesting animation effects for LED cubes. Some may be able to search online for animation effect codes designed for other LED cubes and adapt them for use on jolliCube, however, not all are able to do so.

We are proud of creating the jolliCube hardware but without the software to drive jolliCube would have rendered it useless. For this instructable, we will be introducing the MD_Cubo software library created by Marco Colli to drive jolliCube.

Marco Colli is very well regarded and have contributed very much to the Arduino community. One of his popular contributions is the awesome Parola library to drive LED matrix displays. We have used his Parola library for two of our instructables. You may check them out at and

The MD_Cubo library comes with some new and interesting animation effects which we did not have in our earlier jolliCube instructable. Here, we will showcase some of the animation effects from the MD_Cubo library example with some additional interesting animation effects we adapted from codes found online which were written for some other LED cubes.

You may view the following jolliCube with MD_Cubo library Demo YouTube video to see what we will be building here.

Step 1: Building JolliCube

First, you will need to have jolliCube before we proceed later to load our demo program to run the animations. If you have already build jolliCube, you may like to proceed to the next step.

If you are interested in building jolliCube, you may check out our instructable at

Go through the following steps in that instructable to build the hardware for jolliCube:

Step 1: Design of jolliCube - Arrangement of LEDs

Step 2: Design of jolliCube - Electronic control circuit

Step 3: Build the jigs

Step 4: Assembly Part 1 - Build 8 layers of 8x8 LED Matrix

Step 5: Assembly Part 2 - Complete the LED Cube with control circuit

Step 6: Test jolliCube

The following are the two jolliCube assembly YouTube videos:

Step 2: JolliCube With MD_Cubo Library Demo Program Code

Though our jolliCube is not designed to work with any particular microcontroller, we will be using the popular Arduino board in this instructable to drive it via SPI using only 3 signal lines.

The demo program code for the LED Cube used here is based largely on the demo example that comes with the MD_Cubo library created by Marco Colli with a few additional interesting animation effect codes we found online.

For this project, you will need to install the MD_Cubo library from

The jolliCube MD_Cubo Demo V1.0 example can be downloaded here.

Upload the demo program to your Arduino Nano/Uno. Then connect it to jolliCube. See the picture above for the connection of the Arduino Nano/Uno to jolliCube.

Power up jolliCube via your Arduino Nano/Uno. Any USB port/adapter which is able to supply at least 500mA should be suitable.

If your jolliCube build is good, you may sit back and Enjoy the Show!

Step 3: Building the Enclosure

You will want to protect your investment after putting in all these hours building the 8x8x8 LED Cube by building an enclosure for it.

We will not delve into the detail on how we build our enclosure here. We are fortunate to find 6 x 8-inch clear acrylic sheets (2mm thick) at one of our local Art Shop which is just the right size to make a protective case for our LED Cube. We just need to shorten the length of each acrylic sheet using the simple scrape and break method which is fast and produces acceptably nice edges. We also found acrylic glue which is a solvent for ‘welding’ acrylic at the Art Shop. Using a syringe, we glued the acrylic sheets together to form the protective case. We also designed a simple base for our enclosure and have it 3D printed out. You may want to check out our STL file for 3D printing of our base below.

Click here to download our jolliCube base STL file for 3D printing.

We found a 6 x 6 x 6 inches clear acrylic box display case at which looks suitable for our LED cube. You may like to check it out if you are looking for a more professional and ready-made protective case instead of building it yourself.

Step 4: What's Next?

We hope you like the animation effects we have for jolliCube here with a BIG thanks to Marco Colli for contributing the wonderful Md_Cubo library.

You may explore to add more animation effects for jolliCube, maybe add useful functions to make jolliCube display date and time or make jolliCube react to music. Let your creative juice flow and think of new ideas for jolliCube.

Did you happen to see our instructable in which we split jolliCube into two parts and re-arrange it to create a stereo audio spectrum visualizer? If you are interested, you may check it out here.

Below is the YouTube video of our audio spectrum visualizer.



    • Oil Contest

      Oil Contest
    • Planter Challenge

      Planter Challenge
    • Woodworking Contest

      Woodworking Contest

    We have a be nice policy.
    Please be positive and constructive.




    Hey there, i got a lil problem

    i uploaded the demo code to the arduino, hooked it on, and nothing...

    i accidently shorted out load and clk for a second, and it started glowing, but nothing more...

    also tried the orinal code from the jollicube instructables platform,
    but exactly the same, when clk and load touch, it glows, but also not

    1 reply

    Are you using the jolliCube kit set for your project or did you build it yourself?

    Can anyone merge the animations ftom MD_Cubo library and from the previous instructable

    I need a program which has all the animations from both the codes combined in one.

    The previous code works fine for me but this demo code of MD_cubo doest work. can anyone solve. the error is as follows

    Arduino: 1.6.13 (Windows 10), Board: "Arduino/Genuino Uno"

    G:\MD_Cubo-1.1\MD_Cubo-1.1\examples\jolliCube_MD_Cubo_Demo_V1_0\jolliCube_MD_Cubo_Demo_V1_0.ino:10:21: fatal error: MD_Cubo.h: No such file or directory

    #include <MD_Cubo.h>


    compilation terminated.

    exit status 1

    Error compiling for board Arduino/Genuino Uno.

    This report would have more information with

    "Show verbose output during compilation"

    option enabled in File -> Preferences.

    I also tried to copy and place the files which were in src foder to the folder where the code is. As it contained MD_Cubo.h file still no luck and shows same error. help please.

    1 reply

    Got it to work. paste all files of src in the folder of code you want to upload and need to replace the #include<MD_Cubo.h> with #include"MD_Cubo.h"

    hi I finally got around to building it and the test code works fine but I can't get any other code to work is it because I'm using an aduino uno instead of the nano the aduino program just gives me an error

    4 replies

    Great. The Arduino Uno and Nano are very much the same except for the form factor so this should not be the issue.

    What are the errors you are getting?

    Acually I figured it out, I was just using the wrong code but I just noticed that there is one led that stays lit all the time, what could be causing that?

    Did you managed to resolve the issue whereby one led seems to stay lit all the time? Is this happening while running the Test program? How many 8x8 matrix layers have you completed?

    unfortunately no I haven't been able to resolve it and all eight of the layers are build and working perfectly except for that one and it does it during the test program and the demo program. I'm thinking it might be one of the MAX7219 ICs.

    can u send me a bare board layout?

    I like the simple design using a serial interface and IC's that directly drive the LED's. It limits the number of wires enormously. Thanks for this instructable.


    And furthermore, they advertise for products including FAKE chips (MAX7219). It's obvious when you look at their pictures and compare them to the pictures of genuine and fake chips (such as can be seen here: )

    Too bad that such practices are not being banned from Instructables....


    Well spotted!

    Where to get the pcb?? I am looking forward to make this as my college project!!

    2 replies

    It is available only as a basic kit set at

    Hiya Nick, what's the difference between this MD version and the old blue led version? Because I'm using ide 1.0.6 which I used for the blue led version with no problems. But the MD version will not upload it just comes up with errors. if I use ide 1.6.10 it uploads with no problems and now the blue led version won't upload. Any ideas what the problem might be?

    Very nice instructable and work on making it easy for us to build one.
    What are the orange/warm yellow LEDs you used? What specs do I need to follow if I want to choose my own LEDS (dimensions, voltage etc.)?