@matterbridge/core 3.10.13-dev-20261003-ba58ee6 → 3.10.13-dev-20261004-0c9c4ee

package/dist/behaviors/export.d.ts

@@ -6,6 +6,7 @@ export * from './deviceEnergyManagementModeServer.js';
 export * from './deviceEnergyManagementServer.js';
 export * from './doorLockServer.js';
 export * from './fanControlServer.js';
+export * from './ffmpeg.js';
 export * from './hepaFilterMonitoringServer.js';
 export * from './identifyServer.js';
 export * from './levelControlServer.js';

package/dist/behaviors/export.js

@@ -6,6 +6,7 @@ export * from './deviceEnergyManagementModeServer.js';
 export * from './deviceEnergyManagementServer.js';
 export * from './doorLockServer.js';
 export * from './fanControlServer.js';
+export * from './ffmpeg.js';
 export * from './hepaFilterMonitoringServer.js';
 export * from './identifyServer.js';
 export * from './levelControlServer.js';

package/dist/behaviors/ffmpeg.d.ts

@@ -2,3 +2,10 @@ import { type ChildProcess } from 'node:child_process';
 export declare function hasFfmpeg(): boolean;
 export declare function redactSource(source: string): string;
 export declare function runFfmpeg(args: string[]): ChildProcess;
+export declare function parseAvfoundationWebcams(output: string): string[];
+export declare function parseDshowWebcams(output: string): string[];
+export declare function parseV4l2Webcams(output: string): string[];
+export declare function listWebcams(): Promise<string[]>;
+export declare function getPlayWebcamArgs(videoSource: string, audioSource?: string): string[];
+export declare function playWebcam(videoSource: string, audioSource?: string): ChildProcess;
+export declare function installFfmpeg(): Promise<boolean>;

package/dist/behaviors/ffmpeg.js

@@ -2,6 +2,7 @@ import { spawn } from 'node:child_process';
 import { constants } from 'node:fs';
 import { access, readdir } from 'node:fs/promises';
 import path from 'node:path';
+import { getErrorMessage } from '@matterbridge/utils';
 import { AnsiLogger, MAGENTA } from 'node-ansi-logger';
 const log = new AnsiLogger({ logName: 'Ffmpeg', logLevel: "debug", logNameColor: MAGENTA, logTimestampFormat: 4 });
 async function runProbe(command, args) {
@@ -83,7 +84,7 @@ async function resolveFfmpeg() {
     log.debug('Could not resolve ffmpeg');
     return undefined;
 }
-const ffmpegCommand = await resolveFfmpeg();
+let ffmpegCommand = await resolveFfmpeg();
 if (ffmpegCommand)
     log.debug(`Using ffmpeg: ${ffmpegCommand}`);
 else
@@ -101,3 +102,107 @@ export function runFfmpeg(args) {
     log.debug(`Spawning ffmpeg: ${ffmpegCommand} ${args.map(redactSource).join(' ')}`);
     return spawn(ffmpegCommand, args);
 }
+async function ffmpegOutput(args) {
+    return new Promise((resolve, reject) => {
+        const child = runFfmpeg(args);
+        let output = '';
+        child.stdout?.on('data', (data) => (output += data.toString()));
+        child.stderr?.on('data', (data) => (output += data.toString()));
+        child.on('error', reject);
+        child.on('close', () => resolve(output));
+    });
+}
+export function parseAvfoundationWebcams(output) {
+    const webcams = [];
+    let video = false;
+    for (const line of output.split(/\r?\n/)) {
+        if (line.includes('AVFoundation video devices'))
+            video = true;
+        else if (line.includes('AVFoundation audio devices'))
+            video = false;
+        else if (video) {
+            const name = /\]\s+\[\d+\]\s+(.+?)\s*$/.exec(line)?.[1];
+            if (name && !name.startsWith('Capture screen'))
+                webcams.push(name);
+        }
+    }
+    return webcams;
+}
+export function parseDshowWebcams(output) {
+    const webcams = [];
+    let video = false;
+    for (const line of output.split(/\r?\n/)) {
+        if (line.includes('DirectShow video devices'))
+            video = true;
+        else if (line.includes('DirectShow audio devices'))
+            video = false;
+        const match = /"(.+?)"(?:\s+\((video|audio|none)(?:,\s*(?:video|audio|none))*\))?\s*$/.exec(line);
+        if (match && (match[2] === 'video' || (match[2] === undefined && video)))
+            webcams.push(match[1]);
+    }
+    return webcams;
+}
+export function parseV4l2Webcams(output) {
+    const cameras = new Map();
+    for (const line of output.split(/\r?\n/)) {
+        const match = /^\s*\/dev\/video(\d+)\s+\[(.+)\]/.exec(line);
+        if (!match)
+            continue;
+        const node = Number(match[1]);
+        cameras.set(match[2], Math.min(node, cameras.get(match[2]) ?? node));
+    }
+    return [...cameras.values()].toSorted((a, b) => a - b).map((node) => `/dev/video${node}`);
+}
+export async function listWebcams() {
+    if (process.platform === 'darwin')
+        return parseAvfoundationWebcams(await ffmpegOutput(['-hide_banner', '-f', 'avfoundation', '-list_devices', 'true', '-i', '']));
+    if (process.platform === 'win32')
+        return parseDshowWebcams(await ffmpegOutput(['-hide_banner', '-list_devices', 'true', '-f', 'dshow', '-i', 'dummy']));
+    return parseV4l2Webcams(await ffmpegOutput(['-hide_banner', '-sources', 'v4l2']));
+}
+export function getPlayWebcamArgs(videoSource, audioSource) {
+    if (process.platform === 'darwin')
+        return ['-hide_banner', '-window_title', videoSource, '-f', 'avfoundation', '-framerate', '30', '-i', audioSource ? `${videoSource}:${audioSource}` : videoSource];
+    if (process.platform === 'win32')
+        return ['-hide_banner', '-window_title', videoSource, '-f', 'dshow', '-i', audioSource ? `video=${videoSource}:audio=${audioSource}` : `video=${videoSource}`];
+    return ['-hide_banner', '-window_title', videoSource, '-f', 'v4l2', '-i', videoSource];
+}
+export function playWebcam(videoSource, audioSource) {
+    if (!ffmpegCommand) {
+        throw new Error('Cannot play the webcam: ffmpeg not found on this host');
+    }
+    const ffplayCommand = path.isAbsolute(ffmpegCommand) ? path.join(path.dirname(ffmpegCommand), path.basename(ffmpegCommand).replace(/^ffmpeg/i, 'ffplay')) : 'ffplay';
+    const args = getPlayWebcamArgs(videoSource, audioSource);
+    log.debug(`Spawning ffplay: ${ffplayCommand} ${args.map(redactSource).join(' ')}`);
+    return spawn(ffplayCommand, args);
+}
+export async function installFfmpeg() {
+    if (process.platform !== 'linux') {
+        log.warn(`Cannot install ffmpeg: unsupported platform ${process.platform}`);
+        return false;
+    }
+    if (process.getuid?.() !== 0) {
+        log.warn('Cannot install ffmpeg: root privileges are required');
+        return false;
+    }
+    try {
+        if (await isRunnable('apk')) {
+            await runProbe('apk', ['add', '--no-cache', 'ffmpeg']);
+        }
+        else if (await isRunnable('apt-get')) {
+            await runProbe('apt-get', ['update']);
+            await runProbe('env', ['DEBIAN_FRONTEND=noninteractive', 'apt-get', 'install', '-y', '--no-install-recommends', 'ffmpeg']);
+        }
+        else {
+            log.warn('Cannot install ffmpeg: no supported package manager found (apk, apt-get)');
+            return false;
+        }
+    }
+    catch (error) {
+        log.error(`Failed to install ffmpeg: ${getErrorMessage(error)}`);
+        return false;
+    }
+    ffmpegCommand = await resolveFfmpeg();
+    log.info(ffmpegCommand ? `Installed ffmpeg: ${ffmpegCommand}` : 'ffmpeg was installed but could not be resolved');
+    return ffmpegCommand !== undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/core",
-  "version": "3.10.13-dev-20261003-ba58ee6",
+  "version": "3.10.13-dev-20261004-0c9c4ee",
   "description": "Matterbridge core library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -136,10 +136,10 @@
   },
   "dependencies": {
     "@matter/main": "0.17.9",
-    "@matterbridge/dgram": "3.10.13-dev-20261003-ba58ee6",
-    "@matterbridge/thread": "3.10.13-dev-20261003-ba58ee6",
-    "@matterbridge/types": "3.10.13-dev-20261003-ba58ee6",
-    "@matterbridge/utils": "3.10.13-dev-20261003-ba58ee6",
+    "@matterbridge/dgram": "3.10.13-dev-20261004-0c9c4ee",
+    "@matterbridge/thread": "3.10.13-dev-20261004-0c9c4ee",
+    "@matterbridge/types": "3.10.13-dev-20261004-0c9c4ee",
+    "@matterbridge/utils": "3.10.13-dev-20261004-0c9c4ee",
     "escape-html": "1.0.3",
     "express": "5.2.1",
     "express-rate-limit": "8.7.0",