Installing a Library on Mac OSX

Follow these steps to install a library in Mac OSX.

Close the Arduino IDE

First make sure that all instances of the Arduino IDE are closed. The IDE only scans for libraries at startup. It will not see your new library as long as any instance of the IDE is open!

Download the Zip File

Make sure to select a released version of the library.  Some library repositories are still in development, and may contain unreleased or untested code.  The "Releases" button takes you to the tested and released versions.

  1. Click the "Releases" button on the Github repository page to find the released version of the library.
  2. Then download the zip file.

Find it in the Downloads Folder

OSX will automatically open the zip file there.

Drag it to your Libraries Folder

Open your sketchbook Libraries folder and drag the master folder from Downloads into it.

Give it a Legal Name

The IDE will not recognize folders with dashes in the name. So you must rename the Github Master Folder. Underscores are OK!

Re-start the IDE

Restart the Arduino IDE and verify that the library appears in the File->Examples menu.

Load one of the library examples to test.

Verify that it Compiles

Click the check-mark icon in the upper left and verify that the example sketch compiles without errors.
This guide was first published on Feb 16, 2013. It was last updated on Feb 16, 2013. This page (Installing a Library on Mac OSX) was last updated on Jul 16, 2019.