GitHub - alsoftbv/topic-lab: MQTT Topic Lab, best way to interact with your IoT devices

MQTT Topic Lab

A desktop application for sending saved MQTT commands via configurable buttons. Built with Tauri (Rust) and React.

Features

• Button Commands: Create buttons with customizable topics, payloads, QoS levels, and retain flags
• Project Variables: Define variables like device_id once, use them across buttons with {device_id} syntax
• Multi-send: Send messages repeatedly at configurable intervals
• Message Viewer: Subscribe to topics and monitor incoming messages in real-time
• Multiple Connections: Switch between different MQTT brokers
• Button Groups: Organize buttons into collapsible groups with drag-and-drop reordering
• Import/Export: Share connection configurations as JSON files
• Auto-connect: Automatically connects to your MQTT broker on startup
• TLS Support: Secure connections with TLS/SSL
• Cross-platform: Works on Windows, Linux, and macOS

Variables

Use {variable_name} syntax in topics and payloads. Variables are defined per connection in the Variables panel. When the panel is open, buttons and subscriptions show the raw templates so you can see which variables are used where.

Custom Variables

Define your own variables like device_id = "sensor-001", then use {device_id} in topics or payloads.

Built-in Variables

{timestamp} is an alias for {now}, and {rand} is an alias for {random}.

Modifiers

Modifiers are added with : after the variable name and can be combined.

Time offsets: {now:+5m}, {now:-1h}, {now:+7d}, {now:+2w}, {now:+1M}, {now:+1y}

• Units: s (seconds), m (minutes), h (hours), d (days), w (weeks), M (months), y (years)

Timezone: {now:utc} or {now:local} (default is local)

Custom format: {now:fmt:YYYY-MM-DD}, {now:fmt:HH:mm:ss}

• Tokens: YYYY, YY, MM, M, DD, D, HH, H, mm, ss, SSS

Combined: {now:unix:+1h}, {now:utc:fmt:YYYY-MM-DD_HH:mm}

Keyboard Shortcuts

Getting Started

Prerequisites

• Node.js (v18+)
• Rust
• Platform-specific dependencies for Tauri (see Tauri Prerequisites)

Development

npm install
npm run tauri dev

Testing

npm test                    # Frontend tests
cd src-tauri && cargo test  # Backend tests

Building

License

MIT