matterbridge-example-camera 0.0.8-dev-20260726-61cad4c → 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -28,7 +28,7 @@ If you like this project and find it useful, please consider giving it a star on
28
28
 
29
29
  <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
30
30
 
31
- ## [0.0.8] - Dev branch
31
+ ## [0.0.8] - 2026-07-26
32
32
 
33
33
  ### Added
34
34
 
@@ -58,6 +58,8 @@ If you like this project and find it useful, please consider giving it a star on
58
58
 
59
59
  - [webrtc]: The per-session requested webcam resolution (from a client's `CameraAvStreamManagement.VideoStreamAllocate`) was never actually applied: `buildFfmpegVideoInputArgs` read `MATTERBRIDGE_CAMERA_VIDEO_RESOLUTION` directly before falling back to `getConfiguredVideoResolution(requestedResolution)`, and since the plugin always sets that env var (default `640x480` at the time of this fix, before `videoResolution` defaulted to `auto`), the fallback — and therefore the requested resolution — was never reached.
60
60
 
61
+ <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
62
+
61
63
  ## [0.0.7] - 2026-07-25
62
64
 
63
65
  ### Added
package/README.md CHANGED
@@ -36,6 +36,27 @@ Thanks to [Ludovic BOUÉ](https://github.com/lboue) for his contributions to thi
36
36
  - `src/devices/` contains all single class device types (it will be moved directly in matterbridge core package).
37
37
  - `src/behaviors/` contains all required behaviors (it will be moved directly in matterbridge core package).
38
38
 
39
+ ## Requirements
40
+
41
+ Requires [`ffmpeg`](https://ffmpeg.org/) to be installed. The resolver checks the system command and common installation directories on Linux, macOS, and Windows.
42
+
43
+ Install it with the platform's package manager:
44
+
45
+ ```bash
46
+ # Linux (Debian/Ubuntu)
47
+ sudo apt update && sudo apt install -y ffmpeg
48
+ ```
49
+
50
+ ```powershell
51
+ # Windows
52
+ winget install --id Gyan.FFmpeg -e
53
+ ```
54
+
55
+ ```bash
56
+ # macOS
57
+ brew install ffmpeg
58
+ ```
59
+
39
60
  ## TODO
40
61
 
41
62
  - Track matter.js PR #4128 (https://github.com/matter-js/matter.js/pull/4128) and, once merged and released in the consumed `@matter/*` version, remove the temporary ImageControl workaround used by Audio Doorbell and Intercom for CameraAvStreamManagement choice conformance.
@@ -75,22 +96,14 @@ Features:
75
96
  - Supports configurable stream usages and priorities, encoder limits, video sensor parameters, viewport, rate-distortion trade-off points, and microphone capabilities.
76
97
  - Optional Identify cluster support, with configurable identify time and type. Set to Identify.IdentifyType.None to omit the cluster entirely.
77
98
  - Configurable Power Source cluster type: Rechargeable, Replaceable, Battery, Wired, or None to omit the Power Source cluster entirely.
78
-
79
- Supported by:
80
-
81
- - [Matterserver dashboard](screenshots/matterserver-camera.png)
82
-
83
- ### PTZ Camera
84
-
85
- Features:
86
-
87
- - Same device type and Camera AV Stream Management setup as Camera (Video, Audio, Snapshot and ImageControl features, plus the WebRtcTransportProvider cluster and a WebRtcTransportRequestor client).
88
99
  - Additionally exposes the Camera AV Settings User Level Management cluster with the MechanicalPan, MechanicalTilt and MechanicalZoom features, so a controller can move the camera to an absolute pan/tilt/zoom position (`MPTZSetPosition`) or by a relative delta (`MPTZRelativeMove`). The MechanicalPresets and DigitalPtz features are not part of this example.
89
100
  - `MPTZSetPosition` rejects an absolute pan, tilt, or zoom value outside of the configured range with a ConstraintError.
90
101
  - `MPTZRelativeMove` adds the pan/tilt/zoom delta directly to the current position, clamping the result to the configured range instead of rejecting it, since a relative move is expected to just stop at the mechanical limit.
91
102
  - Configurable pan (`panMin`/`panMax`), tilt (`tiltMin`/`tiltMax`) and zoom (`zoomMax`) ranges, and initial `mptzPosition`. Defaults: pan -170° to 170°, tilt -20° to 90°, zoom 1 to 10, starting position `{ pan: 0, tilt: 0, zoom: 1 }`.
92
- - Optional Identify cluster support, with configurable identify time and type. Set to Identify.IdentifyType.None to omit the cluster entirely.
93
- - Configurable Power Source cluster type: Rechargeable, Replaceable, Battery, Wired, or None to omit the Power Source cluster entirely.
103
+
104
+ Supported by:
105
+
106
+ - [Matterserver dashboard](screenshots/matterserver-camera.png)
94
107
 
95
108
  ### Snapshot Camera
96
109
 
@@ -234,8 +247,6 @@ Example, pulling the audio from the same RTSP camera used for `videoSource`:
234
247
 
235
248
  With `videoResolution: "auto"`, a real client's resolution/quality picker (e.g. in Home Assistant) drives the capture/output resolution: it allocates a video stream with `CameraAvStreamManagement.VideoStreamAllocate` before soliciting or providing a WebRTC offer, and `MatterbridgeWebRtcTransportProviderServer` looks up that stream's `maxResolution` to select the resolution for the session. For `webcam` this is the capture resolution passed to ffmpeg; for `rtsp` the camera keeps streaming at its own native resolution and ffmpeg scales it to match.
236
249
 
237
- Requires [`ffmpeg`](https://ffmpeg.org/) to be installed. The resolver checks the system command and common installation directories on Linux, macOS, and Windows.
238
-
239
250
  Use ffmpeg itself to list the [available capture devices](https://trac.ffmpeg.org/wiki/Capture/Webcam) and find the right value for `videoSource`:
240
251
 
241
252
  - Linux (v4l2): `v4l2-ctl --list-devices` (from `v4l-utils`), or `ls /dev/video*`.
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "matterbridge-example-camera",
3
- "version": "0.0.8-dev-20260726-61cad4c",
3
+ "version": "0.0.8",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "matterbridge-example-camera",
9
- "version": "0.0.8-dev-20260726-61cad4c",
9
+ "version": "0.0.8",
10
10
  "license": "Apache-2.0",
11
11
  "dependencies": {
12
12
  "node-ansi-logger": "3.3.0",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "matterbridge-example-camera",
3
- "version": "0.0.8-dev-20260726-61cad4c",
3
+ "version": "0.0.8",
4
4
  "description": "Matterbridge camera example plugin",
5
5
  "author": "https://github.com/Luligu",
6
6
  "license": "Apache-2.0",