Skip to main content

boneIO Black

boneIO Black is a DIN-rail home automation controller: relays, inputs and sensors in one box, ready to wire into a switchboard. This repository is the software that runs on it — configured from the browser, integrated with Home Assistant over MQTT, and working on its own when the network or the server is down.

boneio.eu · Documentation · Releases

The controller

  • 32x10A — 32 relay outputs, 10 A each, plus inputs for wall switches.
  • 24x16A — 24 relay outputs, 16 A each, for heavier loads.
  • Cover and Cover Mix — boards made for roller blinds, venetian blinds and gates.

Every board has an OLED status screen, a temperature sensor, power monitoring and RS-485 for Modbus devices. It comes with the system image installed: power it up, open the panel, pick the board type, done.

What the software does

  • Web panel — configure outputs, inputs, covers and devices from the browser, with no YAML editing needed (YAML stays available for those who want it). Accounts with roles, HTTPS, works as a phone app (PWA).
  • Home Assistant — every output, input and sensor appears in Home Assistant by itself through MQTT discovery. MQTT over TLS is supported.
  • Local logic — inputs drive outputs directly on the controller, with click / double click / long press actions and conditions. Lights still work when Home Assistant or the network does not.
  • Covers — time-based roller blinds, venetian blinds with tilt, gates.
  • Modbus — ready definitions for energy meters, inverters, HVAC units and sensors (SDM630, ORNO, Socomec, Sofar, SHT30, PT100 and more).
  • Templates — thermostats, alarm panel, irrigation, schedules, presence simulation, sunrise / sunset triggers, virtual switches and energy sensors.
  • Remote devices — ESPHome, WLED and other controllers over MQTT or CAN, used as inputs and outputs as if they were local.
  • Updates from the panel — application and system updates, backups and configuration restore without SSH.

Getting started

The controller ships ready to use. Connect it to the network and open https://<controller-ip>:8443, or plug in USB and open http://192.168.7.2:8090. The first-run wizard creates the administrator account and asks which board this is.

Full guide: boneio.eu/docs.

The supported way to run this software is the boneIO system image on boneIO hardware. Installing the Python package by hand on another system is not supported.

Development

uv sync
uv run boneio run -c ~/boneio/config.yaml -dd

Python 3.13 or newer. Frontend sources are in frontend/.

License

GNU General Public License v3.0.

Metadata

Release files for boneio 1.6.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for boneio 1.6.3
File Size Uploaded
boneio-1.6.3.tar.gz 5.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for boneio 1.6.3
File Interpreter ABI Platform
boneio-1.6.3-py3-none-any.whl Python 3 none any Details

Total release size: 11.9 MB

Release files / boneio-1.6.3.tar.gz

Download URL boneio-1.6.3.tar.gz
Size 5.8 MB
Tags Source
SHA-256 checksum
How to use checksums
c40095d01469b6c71834c5b5218a85f77f841465c3ffe7e7f8016c2f3acb21d6
BLAKE2b-256 checksum
How to use checksums
ba1cc53f0dff9a63e831716f73477a03e9450219a9d6b9e2bb975953aab90203
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / boneio-1.6.3-py3-none-any.whl

Download URL boneio-1.6.3-py3-none-any.whl
Size 6.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ebf7528739f73462524302d052e9ae259ebfe9d4066bad7c2d3309ba5b679e3b
BLAKE2b-256 checksum
How to use checksums
8923d142d9b5bb6dd593b400562b71f0bc12b14f3b56a854db6b55fcb74f34bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release history Release notifications | RSS feed

This release

1.6.3 This release

2 release files

1.6.2

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.6

2 release files

1.5.5

2 release files

1.5.4

2 release files

1.5.3

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.4

2 release files

1.4.3

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.12.2

2 release files

0.12.1

2 release files

0.12.0

2 release files

0.11.3

2 release files

0.11.2

2 release files

0.11.1

2 release files

0.11.0

2 release files

0.10.0

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page