Ooni Connect Bluetooth Library

Ooni Connect is a Python library for communicating with Ooni Connect Bluetooth-enabled devices, such as smart pizza oven thermometers. It provides tools for scanning, connecting, and interacting with these devices, including reading probe temperatures.

It's main target use is for integration into Home Assistant integrations.

Features

• Scan for Ooni Connect Bluetooth devices
• Connect and interact with devices using BLE
• Read probe temperatures and device status
• Command-line interface for easy usage and scripting

Command-Line Interface

Commands

• scan Scan for nearby Ooni Connect Bluetooth devices and display their information.

• connect address Connect to a device by Bluetooth address. This command opens a group of subcommands: Commands can be chained to perform multiple actions in one connection.

  • list List all GATT services and characteristics, and read available data.

  • timer probe seconds Set a timer on the specified probe for a given number of seconds.

  • range probe minimum maximum Set a minimum and maximum temperature range for a probe.

  • target probe target Set a target temperature for a probe.

  • wait Wait indefinitely, keeping the connection open.

Examples

• ooni-connect-bluetooth scan
• ooni-connect-bluetooth connect AA:BB:CC:DD:EE:FF list wait
• ooni-connect-bluetooth connect AA:BB:CC:DD:EE:FF timer 1 600
• ooni-connect-bluetooth connect AA:BB:CC:DD:EE:FF range 1 50.0 80.0
• ooni-connect-bluetooth connect AA:BB:CC:DD:EE:FF target 1 65.0
• ooni-connect-bluetooth connect AA:BB:CC:DD:EE:FF wait