Indigo User Guide

Welcome to the Indigo 2025.2 User Guide — everything you need to set up, use, and maintain Indigo, no programming required.

New to Indigo?

Start with the Getting Started guide, which walks you through installing Indigo, connecting your hardware interface, adding your first devices, and creating your first automations. Then read the Concept Overview to understand Indigo's building blocks — devices, triggers, schedules, action groups, variables, and control pages — and take the tour of the Mac client.

Setting up your hardware

Indigo supports several hardware interfaces, which can be active simultaneously. Read the guide for the technology you use: Z-Wave®, Insteon, or X10. The Virtual Devices Interface helps you integrate devices from different technologies — and 3rd party plugins — together.

Accessing Indigo remotely

The Indigo Web Server and Indigo Touch for Web put your home in your browser; Indigo Touch for iOS puts it on your iPhone, iPad, and Apple Watch; and the Indigo Reflector makes them reachable from anywhere without router configuration.

Going further

The Advanced Automation section covers techniques that make automations dynamic: substitutions, event data passing, fetching URLs from actions, and Apple Shortcuts integration.

Indigo also ships with a collection of bundled plugins — Alexa voice control, email, weather, timers, and more.

Maintaining your system

When the time comes: upgrading Indigo, moving to another Mac, transferring a license, or uninstalling.

Beyond the User Guide

Want to script Indigo with Python, build a plugin, or integrate an external system? See the Scripting, Plugin Development, and Integration APIs sections.