v10.7.0 — Media Browser provider for downloaded events (local + NAS)

Adds a media_source platform exposing event recordings under
"Media → Bosch SHC Camera". Two backends are auto-detected from the
existing options:

* Local — when enable_auto_download + download_path are configured.
  Tree: Camera → Date → Event.
* NAS / SMB — when enable_smb_upload is on. Tree: Year → Month → Day →
  Event, matching the on-disk layout. Files are streamed on demand via
  smbprotocol with HTTP Range support so MP4 seeking works; nothing is
  cached on the HA host.

Each event title shows time + type + camera. JPEGs serve as thumbnails
for matching MP4 clips. macOS resource-forks (._*) are filtered.

Files are served by an authenticated /api/bosch_shc_camera/event/…
view; path-traversal is blocked, only image/jpeg and video/mp4 MIME
types are returned.

New options-flow dropdown "media_browser_source" (auto / local / smb /
none) overrides the auto-detect when both backends are active but only
one should appear in the browser.

Forum context: simon42 community post #14.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: noreply

CHANGELOG.md

@@ -7,6 +7,21 @@ versions see this file or the [GitHub Releases page](https://github.com/mosandlt
 
 ---
 
+## v10.7.0
+
+**Event recordings now appear in HA's Media Browser — both local and NAS.** New `media_source` provider exposes downloaded events under **Media → Bosch SHC Camera**, with two backends auto-detected from existing options:
+
+* **Local** — when *Events automatically download* is enabled with a `download_path`. Tree: *Camera → Date → Event*.
+* **NAS / SMB** — when *SMB upload* is enabled (default for users who don't want to fill HA's small disk). Tree: *Year → Month → Day → Event*; matches the on-disk layout, all cameras share a day folder. Files are streamed on-demand via smbprotocol with HTTP `Range` support so MP4 seeking works.
+
+Each event title shows time, type, and camera (e.g. `09:15:23 — MOVEMENT (Garten)`). MP4 clips play inline; JPEG snapshots double as thumbnails for the matching clip. macOS resource-fork files (`._*`) are filtered out — relevant for FRITZ.NAS / Time Machine targets.
+
+When only one backend is configured, the source-chooser is hidden so the tree opens straight at the meaningful content. With both backends enabled the user picks *Lokal* vs *NAS* at the entry root.
+
+**Manual filter — `Media Browser source` option.** New options-flow dropdown overrides the auto-detect when needed: *Auto* (default — show every backend with data), *Nur Lokal*, *Nur NAS*, *Deaktiviert* (hide the Media Browser entry entirely). Useful when both download_path and SMB upload are active but only one of them should appear in the browser.
+
+Files are served by an authenticated `/api/bosch_shc_camera/event/…` view; path-traversal is blocked, only `image/jpeg` and `video/mp4` are returned. Forum thread context: [simon42 community post #14](https://community.simon42.com/t/bosch-smart-home-kameras-vollstaendig-in-home-assistant-custom-integration-mit-live-stream-bewegungssensoren-cloud-api-kein-shc-noetig/81743/14) — same UX as Reolink's `Media → Reolink` entry.
+
 ## v10.6.2
 
 **Branding fix — switched to the right Bosch app icon.** v10.6.1 mistakenly used the blue *Bosch Smart Home* hub icon. v10.6.2 uses the red *Bosch Smart Camera* app icon (Robert Bosch GmbH, sourced from the official iOS App Store listing) — that's the camera-specific Bosch branding which matches what this integration actually does. Pure asset swap.

README.md

@@ -506,6 +506,31 @@ Set **Low disk warning threshold (MB)** to receive an alert when the NAS runs lo
   1. The configured **notify service** (e.g. Signal, mobile app) if set
   2. **HA persistent notification** as fallback (always shown in the sidebar)
 
+### Media Browser
+
+Once events are being saved — either to the local download folder (`enable_auto_download`) or to a NAS via SMB upload — they appear under **Media → Bosch SHC Camera** in HA's built-in media browser. No extra setup needed; the integration auto-detects which backends have data.
+
+**Tree shape**
+- *Local backend:* `Camera → Date → Event`
+- *NAS backend:* `Year → Month → Day → Event` (matches the on-disk layout, all cameras share a day folder)
+
+Each event title is `HH:MM:SS — TYPE (Camera)`, e.g. `09:15:23 — MOVEMENT (Garten)`. MP4 clips play inline with HTTP `Range` support so the player can seek; the matching JPEG snapshot doubles as a thumbnail. macOS resource-fork files (`._*`) are filtered out — relevant for FRITZ.NAS / Time Machine targets.
+
+When only one backend is configured the source-chooser is hidden and the tree opens straight at the meaningful content. With both backends enabled the entry root shows *Lokal* and *NAS \\server\share* as siblings.
+
+**Manual filter — `Media Browser source` option**
+
+Settings → Devices & Services → Bosch SHC Camera → Configure → **Quelle des Media Browsers**:
+
+| Value | Effect |
+|-------|--------|
+| Auto (default) | Show every backend that has data |
+| Nur Lokal | Hide the NAS even if SMB upload is active |
+| Nur NAS | Hide local files even if auto-download is active |
+| Deaktiviert | Hide the Media Browser entry entirely |
+
+Files are served by an authenticated `/api/bosch_shc_camera/event/…` view; path-traversal is blocked, only `image/jpeg` and `video/mp4` are returned. NAS files are streamed on demand via `smbprotocol` — no local cache, no HA disk usage.
+
 ### HA Events
 
 The integration fires events on the HA event bus for custom automations:
@@ -1116,8 +1141,8 @@ Features investigated or intentionally parked — listed here so the direction i
 
 ## Releases
 
-Latest stable: **v10.6.2** — see the GitHub release page for full notes:
-[**v10.6.2 release notes →**](https://github.com/mosandlt/Bosch-Smart-Home-Camera-Tool-HomeAssistant/releases/tag/v10.6.2)
+Latest stable: **v10.7.0** — see the GitHub release page for full notes:
+[**v10.7.0 release notes →**](https://github.com/mosandlt/Bosch-Smart-Home-Camera-Tool-HomeAssistant/releases/tag/v10.7.0)
 
 | | |
 |---|---|

custom_components/bosch_shc_camera/config_flow.py

@@ -451,6 +451,18 @@ async def async_step_init(self, user_input=None):
                     "download_path",
                     description={"suggested_value": opts.get("download_path", "")},
                 ): str,
+                vol.Optional(
+                    "media_browser_source",
+                    default=str(opts.get("media_browser_source", "auto")),
+                ): SelectSelector(SelectSelectorConfig(
+                    options=[
+                        SelectOptionDict(value="auto",  label="Auto (alles Aktive anzeigen)"),
+                        SelectOptionDict(value="local", label="Nur Lokal (download_path)"),
+                        SelectOptionDict(value="smb",   label="Nur NAS (SMB-Upload)"),
+                        SelectOptionDict(value="none",  label="Provider deaktivieren"),
+                    ],
+                    mode=SelectSelectorMode.DROPDOWN,
+                )),
                 # SHC local API — camera light + privacy mode
                 vol.Optional(
                     "shc_ip",

custom_components/bosch_shc_camera/const.py

@@ -34,6 +34,10 @@
     "enable_snapshot_button": True,
     "enable_auto_download":   False,
     "download_path":          "",
+    # Filter for the Media Browser provider (separate from upload/download).
+    # auto = show every backend that has data; local/smb = show only that one;
+    # none = hide the provider entirely.
+    "media_browser_source":   "auto",
     "shc_ip":        "",
     "shc_cert_path": "",
     "shc_key_path":  "",

custom_components/bosch_shc_camera/manifest.json

@@ -3,12 +3,12 @@
   "name": "Bosch Smart Home Camera",
   "codeowners": ["@mosandlt"],
   "config_flow": true,
-  "dependencies": ["my", "http"],
+  "dependencies": ["my", "http", "media_source"],
   "documentation": "https://github.com/mosandlt/Bosch-Smart-Home-Camera-Tool-HomeAssistant",
   "integration_type": "hub",
   "iot_class": "cloud_push",
   "issue_tracker": "https://github.com/mosandlt/Bosch-Smart-Home-Camera-Tool-HomeAssistant/issues",
   "loggers": ["bosch_shc_camera"],
   "requirements": ["requests>=2.28.0", "firebase-messaging>=0.4.0", "smbprotocol>=1.10.0"],
-  "version": "10.6.2"
+  "version": "10.7.0"
 }