Skip to content

cosalette-apps

A monorepo collection of IoT-to-MQTT bridge applications for smart home automation, all built on the cosalette framework.

Apps

  • airthings2mqtt MIT

    Bridges Airthings Wave BLE air quality sensors to MQTT, publishing 24-hour and long-term radon averages.

  • caldates2mqtt MIT

    Reads CalDAV calendar dates and publishes upcoming all-day events to MQTT, with multi-calendar support and on-demand re-read commands.

  • gas2mqtt MIT

    Reads a domestic gas meter using a QMC5883L magnetometer over I2C and publishes counter ticks, temperature, and debug data to MQTT.

  • jeelink2mqtt MIT

    Bridges LaCrosse temperature and humidity sensors to MQTT via a JeeLink USB receiver.

  • suncast GPL-3.0-or-later

    Computes solar positions and generates shadow visualizations of building footprints, publishing SVG and PNG images via MQTT.

  • velux2mqtt MIT

    Controls Velux covers via Velux remotes and relays connected to GPIO pins, publishing state and accepting commands via MQTT.

  • vito2mqtt GPL-3.0-or-later

    Controls a Viessmann Vitodens gas boiler over the Optolink serial interface, publishing telemetry and accepting commands via MQTT.

Architecture

  • Framework: cosalette — async MQTT lifecycle, decorator-based device registration, hexagonal architecture
  • Build system: uv workspaces + Taskfile
  • Licensing: REUSE-compliant (MIT default, GPL-3.0-or-later for suncast and vito2mqtt)
  • CI: Per-app change detection with reusable workflows
  • Releases: Release Please manifest mode (per-app versioning)