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 +3 -1
- package/README.md +25 -14
- package/npm-shrinkwrap.json +2 -2
- package/package.json +1 -1
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] -
|
|
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
|
-
|
|
93
|
-
|
|
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*`.
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "matterbridge-example-camera",
|
|
3
|
-
"version": "0.0.8
|
|
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
|
|
9
|
+
"version": "0.0.8",
|
|
10
10
|
"license": "Apache-2.0",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"node-ansi-logger": "3.3.0",
|