Skip to content
Homebridge TestFlight
Raspberry Pi

GPIO Doorbell

homebridge-gpio-doorbell · v2.1.1

VerifiedLocal

Turns a Raspberry Pi GPIO input into a HomeKit doorbell.

What it says it supports

Brands

  • Raspberry Pi

Devices it names

  • Raspberry Pi GPIO button

Shows up in Apple Home as from its README

What people report

GPIO doorbell buttons ring in Home but Home shows 'Not Supported' unless a video doorbell/camera is exposed. Newer Raspberry Pi OS GPIO numbering broke button detection.

  • Partly works1
  • Not working1
DeviceStatusWhat they saidSource
Raspberry Pi GPIO doorbell buttonPartly worksRings, but Home app shows 'Not Supported' without a camera; needs GPIO pull-down
Saved copy
Yes, the Apple Home App shows that the accessory is not supported. This is because the official HomeKit specification want’s the doorbell service to be exposed by a video doorbell. It should ring anyway. Could you please provide the following information: Enable Debug Mode, Ring the doorbell, send the Logs for that To which pins did you connect your doorbell on your pi? A scheme how the button is connected to your pi (photo also ok). Is the button directly connected, if not what is in between? The installed version of homebridge, NodeJS and the plugin

Excerpt saved from GitHub on 2026-10-22.

Issue #1 · 2022-04
Raspberry Pi GPIO pin 18 doorbell (new Raspberry Pi OS)Not workingButton presses not registered; new OS GPIO numbering breaks rpi-gpio
Saved copy
Ok, this is a problem with rpi-gpio. With the new Raspberry Pi OS, GPIOs are no longer numbered starting from zero. What you have to do is examine all of the gpiopinxxx nodes for their base and ngpio. As a workaround, you can edit rpi-gio.js and edit the two pin number tables to come up with the correct value. For example, pin 12 should have a GPIO number of 530 and pin 16 a GPIO number of 535. But rpi-gpio needs to switch to laying on top of libgpiod.

Excerpt saved from GitHub on 2026-10-22.

Issue #4 · 2024-04

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

Raspberry Pi GPIO

You’ll need

  • Raspberry Pi

Compatibility

Verified by HomebridgeYes
Homebridge versions>=1.3.5
Homebridge 2.0No
Node.js>=14.18.1
Settings in Homebridge UIYes
MatterNo
Platform nameGpioDoorbell
LicenseApache-2.0

Community signals

Downloads a week2
Downloads a month25
GitHub stars3
Open issues1
Closed issues2
Last code push2023-04-25
Latest version2.1.1 (2022-03-25)
First published2021-11-13
Releases18

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

Caveats from the README

  • Tested on Raspberry Pi only

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

  • Doorbell