Get device statistics from the clock.

Returns battery level, RAM usage, uptime, and other device info.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Get current clock settings.

Returns current display settings like brightness, colors, time format, etc.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Get list of all apps in the display rotation loop.

Returns the names of all apps that cycle through on the display.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Get list of all available visual effects.

Returns available background effects that can be used with custom apps.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Turn the matrix display on or off.

Args: power: True to turn on, False to turn off clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Returns: Status of the power operation

Set the matrix brightness.

Args: brightness: Brightness level from 0 (off) to 255 (max) clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Returns: Updated settings

Send the clock to deep sleep mode.

The clock will wake up after the specified seconds or when the middle button is pressed.

Args: seconds: Number of seconds to sleep clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Reboot the clock.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Switch to a specific app.

Args: app_name: Name of the app to switch to (e.g., 'Time', 'Date', 'Temperature', 'Humidity', 'Battery', or custom app name) clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Switch to the next app in the display loop.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Switch to the previous app in the display loop.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Display a notification on the clock.

Args: text: Text to display duration: How long to show the notification in seconds (default: 5) color: Text color as hex string (e.g., "#FF0000") or RGB array icon: Icon name to display sound: Sound filename to play hold: Keep notification on screen until dismissed (default: False) wakeup: Wake up the matrix if it's off (default: False) stack: Stack with other notifications (default: True) clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Create or update a custom app on the clock.

Args: app_name: Unique name for this custom app text: Text to display duration: How long to show in seconds (default: 5) repeat: How many times to repeat scrolling (-1 = infinite, default) color: Text color as hex string or RGB array background: Background color icon: Icon name to display rainbow: Show text in rainbow colors (default: False) effect: Background effect name save: Save to flash memory (default: False) clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Delete a custom app from the clock.

Args: app_name: Name of the custom app to delete clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Dismiss a held notification.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Set mood lighting on the clock.

Args: brightness: Brightness level 0-255 (default: 170) color: Color as hex string or RGB array kelvin: Color temperature in Kelvin clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Set a colored indicator on the clock.

Indicators are small notification signs displayed on specific areas:

• Indicator 1: Upper right corner

• Indicator 2: Right side

• Indicator 3: Lower right corner

Args: indicator_id: Which indicator (1, 2, or 3) color: Color as hex string (e.g., "#FF0000") or RGB array blink: Blink interval in milliseconds fade: Fade interval in milliseconds clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Clear all indicators from the clock.

Args: clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Play a RTTTL melody from the MELODIES folder.

Args: sound: Name of the sound file (without extension) clock_index: Optional index of clock to target (0-based). Defaults to first clock.

Play a RTTTL melody string directly.

Args: rtttl: RTTTL melody string (e.g., ":d=4,o=5,b=180:...") clock_index: Optional index of clock to target (0-based). Defaults to first clock.