Skip to content

Indigo 2025.2 Documentation

Welcome to the Indigo 2025.2 Documentation pages. We've separated the docs into multiple areas, each focusing on some different part of Indigo 2025.2.

Indigo User Documents

This section contains links to documents that apply to the base Indigo product. It's the starting point if you're new to Indigo. We highly recommend starting with the Getting Started guide then progressing on to the other documents.

  1. Getting Started <- Start here!
  2. Concept Overview - What are Devices, Triggers, Schedules, Action Groups, Control Pages, and Variables?
  3. Tour the Indigo Mac Client User Interface
  4. Indigo supports 3 interfaces, which can be active simultaneously (using Insteon and Z-Wave at the same time)
    1. If you have Z-Wave® devices, read through the Managing Your Z-Wave Network document. Also, our Z-Wave wiki article discusses, in general terms, what Z-Wave is and how it works.
    2. If you have Insteon devices, read through the Managing Your Insteon Network document. For some background on Insteon links, we have put together a separate page that discusses Insteon Scenes. We highly recommend that you read through that page as it will give you a better understanding of what links are and how they work.
    3. The Virtual Devices Interface provides several different devices that help you integrate Z-Wave, Insteon, and 3rd party devices together and even create your own devices.
  5. The Indigo Web Server documentation will help you take advantage of everything the web server has to offer.
  6. The Reflector documentation will help you activate and manage your reflector.
  7. Managing Plugins - the Getting Started guide has a section on managing 3rd party plugins, but we think it's important enough to point out here at the top level of the documentation.
  8. Other Indigo Clients
  9. Upgrading or Moving the Indigo Software

Other Help Pages

There are other help documents available below and from the purple question mark icon (?) in the UI for the less frequently used dialogs in Indigo.

Indigo Plugin Documents

Indigo ships with many plugins to offer greater functionality. This section contains links to the documentation for each plugin that ships with Indigo.

  • Airfoil Pro - allows users to fully control Airfoil 5 and later to direct audio output.
  • Alexa - make Indigo devices available for control via Alexa-capable devices.
  • Email+ - allows users to integrate with email services.
  • EasyDAQ Relay Card - enables Indigo to directly control the EasyDAQ USB relay cards.
  • Global Property Manager - gives users the ability to add custom properties to any Indigo object.
  • NOAA Weather - makes weather data from the U.S. National Oceanic and Atmospheric Administration available for use in Indigo.
  • SQL Logger - a replacement for the built-in SQL logging functionality of previous versions. More robust and useful.
  • Timers and Pesters - this plugin provides a more direct mechanism to create simple timer objects. It also provides a flexible reminder/notification mechanism called a pester.

Indigo How-To Wiki

Need step-by-step instructions on setting up specific home automation tasks? Or have a question about using a particular device/module with Indigo? Take a look at our Indigo How-To Wiki.

Technical Documents

We provide several powerful, yet easy to use ways to extend Indigo. We support a Python-based API that allows 3rd parties to integrate devices, events, and actions natively into Indigo without sacrificing speed and stability of the core server. This section provides links to all the documentation needed to develop scripts and plugins for Indigo.

About Python IOM API v3.x and Indigo 2025.2

with API v3.0 and later, we have switched to Python 3. Plugins and scripts -- both embedded and external -- run in Python 3 only. The Indigo Plugin Store highlights the legacy plugins that will not work with Indigo 2025.2. See the API release notes for v3.0 for details. See Python Packages for a list of the additional Python packages that are installed with the Indigo 2025.2 installer.

If any of the API tables or functionality in the documentation don't have a version number you can assume that the feature is available in API version 1.0 and later.

We have several APIs for plugin development, Indigo scripting, and integrating with other platforms/services.

Want to add your plugin to the Plugin Store? It's simple: review the Plugin Store Submission Guidelines and then add it from your Indigo Account.

A note about version numbers

As we've revised the Python IOM API and added features, we've incremented the API version number. The API version number takes the form of X.Y - where X is the major version and Y is the minor. We will increment the minor version any time we implement new functionality (but old functionality remains the same). We will only increment the major version if we implement a change in the API that will break backwards compatibility. See the Api Version Chart to see which API versions were released in which Indigo version. Also, the HTTP and WebSocket APIs have versioning built-in to their respective URLs: /v2/api, so if we make any breaking changes in the future, we will bump that version number.

Z-Wave® is a registered trademark of Silicon Labs. Indigo's support of Z-Wave hardware is neither endorsed nor certified by Silicon Labs.