The Programs section is the nerve center of your HomeGenie system. Here, you manage the automation logic that defines your home's intelligence.

HomeGenie offers three ways to create programs:

1. AI-Assisted: Describe your logic to the AI Genie and let it write and deploy the code for you.
2. Visual Programming: Use the Blockly-based editor to build logic flows without writing code.
3. Direct Coding: Write C#, JavaScript, or Python directly in the professional built-in editor.

Regardless of the method, all programs use the common HomeGenie API to interact with devices and system data.

Developing with the AI Automation Wizard

With the integrated AI Widget Genie, HomeGenie is now an AI-powered IDE. You can create complex automation programs simply by talking to the system.

The Automation Wizard & Auto-Fix

When you ask the Genie for an automation (e.g., "Turn on the porch light for 5 mins when the door opens"), a dedicated Actions card appears:

• Save Program: Automatically creates a new program, assigns it to the "AI Automations" group, and deploys the code.
• Self-Healing Loop: If the generated code contains a syntax error or an invalid API call, HomeGenie's compiler catches it and sends the error log back to the Genie. The AI then automatically generates a corrected version and re-deploys it.

The Magic Loop (IDE Integration)

If you have the Program Editor open, the Genie acts as a live pair-programmer.

• Click Update in the chat to inject the AI-generated code directly into the active editor tabs.
• This process is non-destructive: your Undo/Redo history is preserved, so you can revert any AI changes with a simple Ctrl+Z.

Managing Programs

From the Programs page, you can:

• add_circle Add a program manually to start from a blank template.
• upload_file Import a program from a .zip archive.
• more_vert Manage existing logic using the options menu.

Open media

Programs List Actions

Tapping the more_vert icon offers the following:

• play_arrow Run / stop Stop: Manually trigger or abort execution.
• block Disable: Deactivates the program and removes any custom features or UI fields it contributes to the system.
• edit Edit: Opens the code editor.
• download Export: Bundles the script and its data into a .zip file for backup or sharing.

The Program Editor

The editor is a full-featured development environment powered by Monaco (the engine behind VS Code).

Code Structure

HomeGenie programs are organized into logical blocks to separate configuration from execution:

bolt Setup

The Setup code runs once when the program is enabled or the system starts. It is used to "link" the program to the rest of the system.

• Program.AddFeature(...): Adds custom options to the settings dialog of other devices.
• Program.AddOption(...): Adds global configuration settings for the program itself.
• Program.Run(): Triggers the execution of the Main block.

code Main

The Main block contains the core logic. This is where you define how the program reacts to events or how it loops in the background.

• Use When.ModuleParameterChanged to react to sensor data.
• Use while (Program.IsRunning) for background tasks (always include a Pause() to save CPU).
• For C#, this block maps to the internal ScriptSource.

code Context (C# Only)

This tab is reserved for helper classes, static methods, or external library references that need to be accessible globally within the program.

Program Flags

Available in the Program Data tab:

• Auto-restart on error: Ideal for "unattended" mode. If the script crashes, HomeGenie will automatically try to bring it back online.
• Cloneable: Allows the program to be duplicated, making it easy to create variations of the same logic for different rooms or devices.

Open media

Pro Tip: Hybrid Development

The most efficient way to build is to use the AI Genie to generate the initial architecture and then use the Program Editor to fine-tune the parameters. This combination of AI speed and manual precision gives you total control over your smart system.