Nothing is displayed

  • Make sure the sketch uploads successfully to the Teensy 3
  • Check the soldering on the SmartMatrix Shield


"No SD card" message

  • Make sure the microSD card is inserted in the reader, and is formatted properly
  • Check your soldering on the Teensy headers, (plus expansion connector and SD card adapter if you used a Teensy 3.2)
    • Check the wires, make sure none are loose or connected to the wrong pins
  • Try another microSD card


"No gifs directory" message

  • Make sure there is a directory called "gifs" in the root of the microSD card
  • Make sure the card is formatted properly


"Empty gifs directory" message

  • Make sure all files are named in 8.3 format, and are placed in the /gifs/directory on the microSD card


Other GIFs are playing, but my custom gif isn't playing

  • Check the name, make sure it is in 8.3 format
  • Try removing all other .gif files from the /gifs/ directory, leaving just the GIF you want to test
  • Make sure the size is exactly 32x32 pixels (or the size you set for your display)
  • Make sure the file plays on a computer. You can open the GIF with a web browser if you don't have any other programs to play it back.
  • If your file plays on the computer but not on the display, please let us know by opening an Issue on GitHub with your GIF attached so we can troubleshoot.

This guide was first published on Oct 16, 2014. It was last updated on Mar 08, 2024.

This page (Troubleshooting) was last updated on Mar 08, 2024.

Text editor powered by tinymce.