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 Gemini Genie or Lailama 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 AI Genie engine, HomeGenie is an AI-powered IDE. Use Gemini Genie for cloud AI or Lailama for a local model, and create automation programs simply by talking to the system. Both assistants can create new programs, update existing ones, and build companion widgets in the same conversation.

Enable Automation in the chat’s Capabilities menu to let the assistant create and update programs. Use Context to choose which system information it can read. With Lailama, choose a model suited to coding: results depend on the model’s capabilities.

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.

Keeping Programs Up to Date

Open the Updates view from the Programs toolbar to see which installed programs have a newer version available. The button is always available, even when everything is up to date, and shows a badge when updates are waiting. You can also reach this view from an update notification.

Choose an individual program to update, or use Update All to apply the available updates together. Before you confirm, HomeGenie shows what will be installed and identifies programs that need your attention. Programs with local code changes, or whose original code cannot be reliably compared, are excluded from the automatic batch so you can review them first.

During installation, the Updates view shows progress and the result for each program. You can leave the page and return to check the operation. Once it finishes, the view stays available: when there are no pending updates, it confirms that the system is up to date. If an operation fails or is interrupted, check its details and use the retry action when available.

History and Backups

Expand the update history to review recent operations and their individual results. HomeGenie creates a backup before replacing an existing program, so a failed installation can attempt to restore the previous version.

The view also shows the space used by backups. Use Delete Backups to remove eligible backups from successful updates after confirmation; the operation history remains available. HomeGenie also applies automatic retention, while keeping backups that need manual recovery or review.

These are program updates from the installed package catalog. To update HomeGenie itself, use Maintenance. After a HomeGenie release update, newly required programs from active packages are installed automatically; updates to existing programs remain available for you to review here.

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