Skip to content

About

Unofficial Linux/Windows client for the BTicino EASYKIT WiFi video door entry kit: live view, two-way audio, door release, ring notifications (Rust)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Door entry for BTicino EASYKIT — Linux and Windows

Italiano

Unofficial desktop app and command-line tool for the BTicino EASYKIT WiFi video door entry kit (BTicino 310913, Legrand 360910). BTicino only offers the Home + Security phone app; this project brings the main features to Linux and Windows.

Independent project, not affiliated with or endorsed by BTicino, Legrand or Netatmo. It talks to the same cloud service as the official app, with your own account and your own device. See Legal notes.

Home

Live view Calls
Live Calls

Features

  • Live view of the entrance panel (H264 video) with two-way audio: listen through the speakers, click to open the microphone.
  • Open the door and the gate (every lock of the kit), with a confirmation.
  • Staircase light on/off, including lights the phone app hides.
  • Ring notifications on the desktop with the visitor's snapshot.
  • Call history with thumbnails.
  • Tray icon, start with the system, single instance, English and Italian.
  • A scriptable CLI for everything above.

Compatibility

Kit Bridge Status
BTicino 310913 EASYKIT WiFi, firmware 1.00.11 BDIY Tested by the author (see below)
Legrand 360910 EASYKIT WiFi BDIY Same bridge, reported working by others for events and locks
Classe 100X / 300X BNC1, BNC3, BNCX Not tested; the API is shared, live view may need changes

Other EASYKIT owners: please open a Device report issue with the output of bticino-easykit list.

What is verified on real hardware

Feature Status
Sign-in, topology, status, call history ✅
Live view: video ✅
Live view: audio from the panel (recorded and decoded) ✅
Hearing it on the speakers, talking from the PC ⏳ code ready, not yet checked by ear
Door release (pedestrian and garage gate) ✅ seen opening
Ring notification (push WebSocket) ✅
Answering an incoming call from the PC ❌ not yet (see Known limitations)
Staircase light ⏳ not tested
Windows build built by CI only, never run by the author

Install

Arch Linux (AUR)

yay -S bticino-easykit      # builds from source
yay -S bticino-easykit-bin  # prebuilt binaries

Linux (release archive)

Download bticino-easykit-vX.Y.Z-linux-x86_64.tar.gz from the releases, then:

tar xf bticino-easykit-*-linux-x86_64.tar.gz
cd bticino-easykit-*-linux-x86_64
./install.sh            # into ~/.local, no root
./install.sh --uninstall

No udev rule is needed: the kit is reached through the internet, not USB.

Windows

Download the .zip from the releases, extract it and run bticino-easykit-gui.exe. The executable is not signed, so SmartScreen may warn on first start (More info → Run anyway).

From source

cargo build --release                        # GUI + CLI
cargo build --release --no-default-features  # CLI only

Linux needs alsa-lib (libasound2-dev) and pkg-config.

Usage

Start Door entry for BTicino EASYKIT from the menu and sign in with your Home + Security account. The password is never stored: only the session tokens, in ~/.config/bticino-easykit/tokens.toml (%APPDATA%\bticino-easykit on Windows).

The CLI:

bticino-easykit login           # asks email and password
bticino-easykit list            # homes and modules (use this for bug reports)
bticino-easykit status          # live status (firmware, Wi-Fi, …)
bticino-easykit events          # call history
bticino-easykit live --seconds 30 --out clip   # save video.h264 + audio.ogg
bticino-easykit listen          # print call notifications as they arrive
bticino-easykit logout

Environment variables:

Variable Effect
BTICINO_EASYKIT_CONFIG_DIR use another directory for tokens and settings
BTICINO_EASYKIT_DEBUG=1 print the raw API traffic (tokens redacted)
RUST_LOG=webrtc=debug WebRTC internals
BTICINO_EASYKIT_DEMO=1 GUI with fake data, no network
BTICINO_EASYKIT_SCREENSHOTS=dir GUI saves every tab in both languages and exits

Known limitations

  • Answering an incoming call from the PC does not work yet. The kit sends the call's video offer only as a Firebase push to registered phones; the live view cannot be opened while the panel is ringing ("Max number of peers reached"). You still get the ring notification and can open the door.
  • The connection uses a short RSA key on the device side and the older AES_CM SRTP profile: both are what the kit supports. The certificate fingerprint is still checked.
  • Wayland: the window is closed and re-created to go to the tray, since it cannot be hidden.
  • If the kit stops reporting calls to the cloud, restarting the indoor monitor helped in testing.

How everything works is documented in docs/PROTOCOL.md.

Credits

Legal notes

  • Trademarks. BTicino, EASYKIT, Legrand, Netatmo and Home + Security are trademarks of their respective owners. They are used here only to say which hardware this software works with.
  • How it was made. The network protocol was learned by observing the traffic of the user's own kit and by analysing the official Android app to the extent needed for interoperability (EU Directive 2009/24/EC, art. 6; Italian law 633/1941, art. 64-quater). No code, images or other material from the official app is included. The OAuth and Firebase client identifiers of the official app are used to talk to the same cloud service; the client secret has been public in other open-source projects for years.
  • Use at your own risk. Unofficial clients may not be allowed by Netatmo's terms of service, and Netatmo can change or block the cloud API at any time, which could also affect your account. This software opens doors and gates: you are responsible for how you use it. It comes with no warranty (see the license).
  • Privacy. Your password is never stored; tokens stay on your computer. Debug logs hide tokens, location and image links.
  • Third-party licenses of the bundled crates: THIRD-PARTY-LICENSES.md.

License

MIT

About

Unofficial Linux/Windows client for the BTicino EASYKIT WiFi video door entry kit: live view, two-way audio, door release, ring notifications (Rust)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages