Home Assistant Integration

Home Assistant Integration

The Printbuddy Home Assistant integration connects Home Assistant to an existing Printbuddy instance and exposes Printbuddy printers as Home Assistant devices and entities.

Repository: vmhomelab/ha-printbuddy-integration

When to use the integration

Use the integration if Printbuddy is already running somewhere else, for example as a Docker container, VM, or Home Assistant add-on, and you want printer telemetry inside Home Assistant.

The first version is read-only by design. It focuses on safe monitoring and does not expose printer control buttons.

Features

• UI config flow; no YAML required.
• One Home Assistant device per configured Printbuddy printer.
• Discovers printers from GET /api/v1/printers/.
• Polls printer status from GET /api/v1/printers/{id}/status.
• Supports unauthenticated Printbuddy instances and Bearer/API-token protected instances.
• Creates stable entity IDs from the Printbuddy instance URL and printer ID.

Entities

Depending on the data reported by Printbuddy and the printer provider, the integration can create entities such as:

• Connection status.
• Printing status.
• Current print name.
• Nozzle, bed, and chamber temperatures.
• Target temperatures.
• Print progress.
• Remaining time.
• Current and total layer counts.
• Wi-Fi signal.
• Door, chamber light, and fan-related sensors when available.

Installation

HACS custom repository

1. In HACS, add this repository as a custom repository of type Integration:

   https://github.com/vmhomelab/ha-printbuddy-integration
   

2. Install Printbuddy.

3. Restart Home Assistant.

4. Open Settings → Devices & services → Add integration → Printbuddy.

Manual installation

Copy custom_components/printbuddy into your Home Assistant custom_components directory, restart Home Assistant, then add the integration from the UI.

Configuration

The setup flow asks for:

• Printbuddy URL: for example http://10.17.200.5:8000 or another URL reachable by Home Assistant.
• API token: optional. Use this if Printbuddy authentication is enabled and your instance requires a Bearer/API token.
• Scan interval: polling interval in seconds. Default: 30.

See also: Home Assistant Add-on