Do I need to call the Dot API directly?

No. All operations go through the provided Python scripts in the scripts/ directory, which handle authentication and formatting.

What if DOT_API_KEY is missing?

Set DOT_API_KEY in your environment or follow the prereqs in the skill to obtain an API key.

Which Python version is required?

Python 3.10+ is required, as the skill uses modern type hints and standard library modules.

quote0-dot-screen

Scanned

npx machina-cli add skill azzgo/agent-skills/quote0-dot-screen --openclaw

Files (1)

SKILL.md

3.9 KB

Quote/0 Dot Screen Controller

Overview

This skill provides control over Quote/0 electronic screen devices through the Dot Developer Platform APIs.

CRITICAL: You MUST use the provided Python scripts in the scripts/ directory for ALL operations. Do NOT attempt to make direct API calls (via curl, requests, or custom code). The scripts handle authentication, error handling, and response formatting.

Prerequisites

Check for DOT_API_KEY environment variable before any operation. If not set, guide the user to:

Visit https://dot.mindreset.tech/docs/service/open/get_api
Create an API key in the Dot. App
Export the key: export DOT_API_KEY=xxx

Scripts Reference

All scripts are located in scripts/ directory. Run from the skill root directory.

list_devices.py - List All Devices

Get all available devices and their serial numbers (device_id).

python3 scripts/list_devices.py [--format json|markdown]

--format: Output format (default: markdown)
Returns: Device serial numbers, series, model, edition

device_status.py - Get Device Status

Query a device's current state and connection status.

python3 scripts/device_status.py <device_id> [--format json|markdown]

device_id: Device serial number (required, get from list_devices.py)
--format: Output format (default: markdown)

display_text.py - Display Text on Device

Show text content on device screen.

python3 scripts/display_text.py <device_id> <message> [options]

Required:

device_id: Device serial number
message: Text content to display

Optional:

--title <title>: Title to display
--signature <signature>: Signature to display
--icon <base64>: Base64-encoded PNG icon (40px×40px)
--link <url>: NFC redirect link
--task-key <key>: Task key for updating specific Text API content
--no-refresh: Do not display immediately

display_image.py - Display Image on Device

Show image content on device screen.

python3 scripts/display_image.py <device_id> <image> [options]

Required:

device_id: Device serial number
image: Base64-encoded PNG image data (296px×152px)

Optional:

--link <url>: NFC redirect link
--border <0|1>: Border color (0=white, 1=black, default: 0)
--dither-type <type>: Dither type (DIFFUSION, ORDERED, NONE)
--dither-kernel <kernel>: Dither kernel (FLOYD_STEINBERG, ATKINSON, BURKES)
--task-key <key>: Task key for updating specific Image API content
--no-refresh: Do not display immediately

switch_next.py - Switch to Next Content

Navigate to next content item in device's display loop.

python3 scripts/switch_next.py <device_id> [--format json|markdown]

device_id: Device serial number (required)

list_tasks.py - List Device Tasks

Get list of content tasks configured on device.

python3 scripts/list_tasks.py <device_id> [task_type] [--format json|markdown]

device_id: Device serial number (required)
task_type: Task type (default: loop)
--format: Output format (default: markdown)

Device Specifications

Screen resolution: 296px × 152px
Icon size: 40px × 40px (for text display)
Image format: PNG, Base64-encoded

Troubleshooting

API key not found: Check DOT_API_KEY environment variable is set
Device not updating: Check device status, ensure WiFi connected
Image issues: Verify Base64 encoding, check resolution, try different dither types

Source

git clone https://github.com/azzgo/agent-skills/blob/main/skills/quote0-dot-screen/SKILL.mdView on GitHub

Overview

This skill lets you control Quote/0 electronic screen devices through the Dot Developer Platform APIs using the provided Python scripts. It covers getting device information or status, displaying text content, displaying images, switching content, and listing device tasks. All operations must go through the scripts to handle authentication and error formatting.

How This Skill Works

You do not call the API directly. You run the Python scripts in the scripts/ directory (list_devices.py, device_status.py, display_text.py, display_image.py, switch_next.py, list_tasks.py). The scripts authenticate with DOT_API_KEY, standardize responses, and perform the requested operation on the target device.

When to Use It

Get device information or status
Display text content on a device
Display images on a device
Switch to the next content item in the device display loop
List the device's configured content tasks

Quick Start

Step 1: Ensure DOT_API_KEY is exported (export DOT_API_KEY=...)
Step 2: List devices to obtain device_id (python3 scripts/list_devices.py --format json)
Step 3: Run the needed script with the device_id and content (e.g., python3 scripts/display_text.py DEV_ID 'Hello')

Best Practices

Ensure DOT_API_KEY is set in your environment before any operation
Run scripts from the skill's root directory
Use list_devices.py first to obtain device_id, then other scripts
Match content types and options to each script (text, image, task-key, etc.)
Verify device connectivity and retry if updates do not appear

Example Use Cases

python3 scripts/list_devices.py --format json
python3 scripts/device_status.py DEV123 --format markdown
python3 scripts/display_text.py DEV123 'Hello from Quote/0' --title 'Announcement' --signature 'Agent'
python3 scripts/display_image.py DEV123 <base64_png> --border 1 --dither-type NONE
python3 scripts/switch_next.py DEV123 --format json

Frequently Asked Questions

Add this skill to your agents