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

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

Open media

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 Options

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