Bosch Smart Home Camera — Full HA Integration (HACS)

Third party integrations
1

Disclaimer

This is an independent community project. Not affiliated with Robert Bosch GmbH. The API is undocumented and may change at any time. Use at your own risk.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Hey everyone,

I built a custom integration for the Bosch Smart Home cameras (Eyes Outdoor / 360 Indoor) — the ones from the Bosch Smart Camera app, not the SHC-only cameras. Since Bosch doesn’t offer any public API or HomeKit/Matter support, I reverse-engineered the cloud API via mitmproxy and built this from scratch.

It’s available on HACS — just click the button above or search for “Bosch Smart Home Camera”.

What it does

This gives you full camera control in Home Assistant — everything the Bosch app can do, and more:

Camera & Streaming

  • Live camera entity with snapshot (latest event JPEG)

  • Full 30fps H.264 1080p + AAC audio live stream via RTSPS

  • Works with go2rtc / WebRTC out of the box

  • Custom Lovelace card with live video, pan controls, and all toggles

Switches & Controls

  • Privacy mode (on/off)

  • Camera light (outdoor only)

  • Notifications (on/off + per-type: movement, person, audio, trouble, camera alarm)

  • Motion detection toggle + sensitivity select

  • Auto-follow (360 camera)

  • Timestamp overlay (show/hide clock on video)

  • Record sound toggle

  • Intercom (two-way audio)

Sensors

  • Camera status (ONLINE/OFFLINE)

  • WiFi signal strength (%)

  • Firmware version + native update entity (HA update card)

  • Ambient light level

  • Event counters (today, by type)

  • Last event timestamp + type

  • Schedule rules count

Number Entities

  • Pan position (360 camera, ±120 degrees slider)

  • Audio alarm threshold (dB)

  • Speaker level (intercom volume)

Binary Sensors

  • Motion detected

  • Audio alarm detected

  • Person detected

Built-in Alert System (no automations needed)

The integration has a 3-step alert system built in:

  1. Instant text notification

  2. Snapshot image (~5s later)

  3. Video clip (~30-90s later)

Sends to any HA notify service — Telegram, Signal, iOS push, etc. Just configure the service name in the integration options.

Near-Instant Event Detection

FCM Push support (~2-3 second detection) via Firebase Cloud Messaging. Falls back to polling automatically if FCM goes down.

SMB/NAS Upload

Auto-upload event snapshots + video clips to any SMB share (FRITZ!Box NAS, Synology, etc.) with configurable folder/file patterns and retention cleanup.

Services

  • bosch_shc_camera.create_rule / delete_rule — cloud-side schedule rules

  • bosch_shc_camera.download_clip — on-demand event clip download

  • bosch_shc_camera.trigger_snapshot — force refresh

  • bosch_shc_camera.open_live_connection — open live proxy

Supported Cameras

  • Bosch Eyes Outdoor Camera (CAMERA_EYES) — Gen1

  • Bosch 360 Indoor Camera (CAMERA_360) — Gen1

These are the cameras managed via the Bosch Smart Camera app (not the Bosch Smart Home app). Gen2 cameras (Eyes Indoor 2 / Outdoor 2) should also work but are untested — feedback welcome.

Setup

  1. Install via HACS (or copy custom_components/bosch_shc_camera/ manually)

  2. Restart HA

  3. Settings → Integrations → Add → Bosch Smart Home Camera

  4. The wizard gives you a Bosch login URL — open it, log in with your SingleKey ID

  5. Copy the redirect URL back into HA

  6. Done — cameras are auto-discovered

Token renewal is fully automatic via refresh token. No mitmproxy or manual token handling needed after initial setup.

Custom Lovelace Card

The integration includes a custom card with:

  • Live HLS video streaming

  • Snapshot polling (near-real-time when streaming)

  • Pan controls (360 camera)

  • All toggle buttons (privacy, light, audio, notifications, intercom)

  • Quality selector

  • Page Visibility API (reduces polling when tab is in background)


type: custom:bosch-camera-card

camera_entity: camera.bosch_garten

title: Garten

How it works

The integration communicates with the Bosch Cloud API at residential.cbs.boschsecurity.com. Authentication uses OAuth2/PKCE via Bosch’s Keycloak (SingleKey ID). Live streaming goes through Bosch’s proxy servers via RTSPS on port 443.

The cloud API was reverse-engineered via mitmproxy analysis of the official iOS and Android apps. No Bosch software was modified or distributed — only network protocol observations were used, which is permitted under EU Directive 2009/24/EC.

The SHC (Smart Home Controller) local API is not required — everything works via cloud only. However, if you have an SHC, the integration can use it as an offline fallback for privacy mode and camera light control.

Links

The Python CLI tool is a standalone command-line tool with the same API access — useful for debugging, scripting, or if you just want to control your cameras from the terminal.

Feedback, bug reports, and feature requests are welcome on GitHub Issues. If you have Gen2 cameras and want to help test, please reach out!

2

My only feedback is it you used AI resources to help code this, it should be disclosed.

3

as every can see i used for many parts Claude Code.