homebridge-plugin-utils 1.15.2 → 1.16.0

package/dist/ffmpeg/record.js

@@ -0,0 +1,504 @@
+/* Copyright(C) 2017-2025, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * ffmpeg/record.ts: Provide FFmpeg process control to support livestreaming and HomeKit Secure Video.
+ *
+ */
+/**
+ * FFmpeg process management for HomeKit Secure Video (HKSV) events and fMP4 livestreaming.
+ *
+ * This module defines classes for orchestrating FFmpeg processes that produce fMP4 segments suitable for HomeKit Secure Video and realtime livestreaming scenarios. It
+ * handles process lifecycle, segment buffering, initialization segment detection, and streaming event generation, abstracting away the complexity of interacting directly
+ * with FFmpeg for these workflows.
+ *
+ * Key features:
+ *
+ * - Automated setup and management of FFmpeg processes for HKSV event recording and livestreaming (with support for audio and video).
+ * - Parsing and generation of fMP4 boxes/segments for HomeKit, including initialization and media segments.
+ * - Async generator APIs for efficient, event-driven segment handling.
+ * - Flexible error handling and timeouts for HomeKit’s strict realtime requirements.
+ * - Designed for Homebridge plugin authors or advanced users who need robust, platform-aware FFmpeg session control for HomeKit and related integrations.
+ *
+ * @module
+ */
+import { HKSV_IDR_INTERVAL, HKSV_TIMEOUT } from "./settings.js";
+import { runWithTimeout } from "../util.js";
+import { FfmpegProcess } from "./process.js";
+import events from "node:events";
+import { once } from "node:events";
+/**
+ * FFmpeg process controller for HomeKit Secure Video (HKSV) and fMP4 livestreaming and recording.
+ *
+ * This class manages the lifecycle and parsing of an FFmpeg process to support HKSV and livestreaming in fMP4 format. It handles initialization segments, media segment
+ * parsing, buffering, and HomeKit segment generation, and emits events for segment and initialization.
+ *
+ * @example
+ *
+ * ```ts
+ * // Create a new recording process for an HKSV event.
+ * const process = new FfmpegRecordingProcess(ffmpegOptions, recordingConfig, 30, true, 5000000, 0);
+ *
+ * // Start the process.
+ * process.start();
+ *
+ * // Iterate over generated segments.
+ * for await(const segment of process.segmentGenerator()) {
+ *
+ *   // Send segment to HomeKit, etc.
+ * }
+ *
+ * // Stop when finished.
+ * process.stop();
+ * ```
+ *
+ * @see FfmpegOptions
+ * @see FfmpegProcess
+ * @see {@link https://ffmpeg.org/ffmpeg.html | FFmpeg Documentation}
+ */
+class FfmpegFmp4Process extends FfmpegProcess {
+    hasInitSegment;
+    _initSegment;
+    isLivestream;
+    isLoggingErrors;
+    isTimedOut;
+    recordingBuffer;
+    recordingConfig;
+    segmentLength;
+    /**
+     * Constructs a new fMP4 FFmpeg process for HKSV event recording or livestreaming.
+     *
+     * @param ffmpegOptions     - FFmpeg configuration options.
+     * @param recordingConfig   - HomeKit recording configuration for the session.
+     * @param isAudioActive     - If `true`, enables audio stream processing.
+     * @param fmp4Options       - Partial configuration for the fMP4 session (fps, url, etc.).
+     *
+     * @example
+     *
+     * ```ts
+     * const process = new FfmpegFmp4Process(ffmpegOptions, recordingConfig, true, { fps: 30 });
+     * ```
+     */
+    constructor(ffmpegOptions, recordingConfig, isAudioActive, fmp4Options = {}) {
+        // Initialize our parent.
+        super(ffmpegOptions);
+        // We want to log errors when they occur.
+        this.isLoggingErrors = true;
+        // Initialize our recording buffer.
+        this.hasInitSegment = false;
+        this._initSegment = Buffer.alloc(0);
+        this.recordingBuffer = [];
+        // Initialize our state.
+        this.isLivestream = fmp4Options.livestream ?? false;
+        this.isTimedOut = false;
+        fmp4Options.fps ??= 30;
+        fmp4Options.url ??= "";
+        // Save our recording configuration.
+        this.recordingConfig = recordingConfig;
+        // Configure our video parameters for our input:
+        //
+        // -hide_banner                  Suppress printing the startup banner in FFmpeg.
+        // -nostats                      Suppress printing progress reports while encoding in FFmpeg.
+        // -fflags flags                 Set the format flags to generate a presentation timestamp if it's missing and discard any corrupt packets rather than exit.
+        // -err_detect ignore_err        Ignore decoding errors and continue rather than exit.
+        // -probesize number             How many bytes should be analyzed for stream information. Use the size of the timeshift buffer or our configured defaults.
+        // -r fps                        Set the input frame rate for the video stream.
+        // -f mp4                        Tell FFmpeg that it should expect an MP4-encoded input stream.
+        // -i pipe:0                     Use standard input to get video data.
+        // -ss                           Fast forward to where HKSV is expecting us to be for a recording event.
+        this.commandLineArgs = [
+            "-hide_banner",
+            "-nostats",
+            "-fflags", "+discardcorrupt+genpts",
+            "-err_detect", "ignore_err"
+        ];
+        if (this.isLivestream) {
+            this.commandLineArgs.push("-avioflags", "direct", "-rtsp_transport", "tcp", "-i", fmp4Options.url);
+        }
+        else {
+            this.commandLineArgs.push("-probesize", (fmp4Options.probesize ?? 5000000).toString(), "-r", fmp4Options.fps.toString(), "-f", "mp4", "-i", "pipe:0", "-ss", (fmp4Options.timeshift ?? 0).toString() + "ms");
+        }
+        // Configure our recording options for the video stream:
+        //
+        // -map 0:v:0                    Selects the first available video track from the stream.
+        this.commandLineArgs.push("-map", "0:v:0", ...(this.isLivestream ? ["-vcodec", "copy"] : this.options.recordEncoder({
+            bitrate: recordingConfig.videoCodec.parameters.bitRate,
+            fps: recordingConfig.videoCodec.resolution[2],
+            height: recordingConfig.videoCodec.resolution[1],
+            idrInterval: HKSV_IDR_INTERVAL,
+            inputFps: fmp4Options.fps,
+            level: recordingConfig.videoCodec.parameters.level,
+            profile: recordingConfig.videoCodec.parameters.profile,
+            width: recordingConfig.videoCodec.resolution[0]
+        })));
+        // If we're livestreaming, emit fragments at one-second intervals.
+        if (this.isLivestream) {
+            this.commandLineArgs.push("-frag_duration", "1000000");
+        }
+        // -movflags flags               In the generated fMP4 stream: start a new fragment at each keyframe, write a blank MOOV box, and avoid writing absolute offsets.
+        // -reset_timestamps             Reset timestamps at the beginning of each segment.
+        // -metadata                     Set the metadata to the name of the camera to distinguish between FFmpeg sessions.
+        this.commandLineArgs.push("-movflags", "frag_keyframe+empty_moov+default_base_moof+skip_sidx+skip_trailer", "-reset_timestamps", "1", "-metadata", "comment=" + this.options.name() + " " + (this.isLivestream ? "Livestream Buffer" : "HKSV Event"));
+        if (isAudioActive) {
+            // Configure the audio portion of the command line. Options we use are:
+            //
+            // -map 0:a:0?                 Selects the first available audio track from the stream, if it exists.
+            // -acodec copy                Copy the stream without reencoding it.
+            this.commandLineArgs.push("-map", "0:a:0?", "-acodec", "copy");
+        }
+        // Configure our video parameters for outputting our final stream:
+        //
+        // -f mp4  Tell ffmpeg that it should create an MP4-encoded output stream.
+        // pipe:1  Output the stream to standard output.
+        this.commandLineArgs.push("-f", "mp4", "pipe:1");
+        // Additional logging, but only if we're debugging.
+        if (this.options.codecSupport.verbose || this.isVerbose) {
+            this.commandLineArgs.unshift("-loglevel", "level+verbose");
+        }
+    }
+    /**
+     * Prepares and configures the FFmpeg process for reading and parsing output fMP4 data.
+     *
+     * This method is called internally by the process lifecycle and is not typically invoked directly by consumers.
+     */
+    configureProcess() {
+        let dataListener;
+        // Call our parent to get started.
+        super.configureProcess();
+        // Initialize our variables that we need to process incoming FFmpeg packets.
+        let header = Buffer.alloc(0);
+        let bufferRemaining = Buffer.alloc(0);
+        let dataLength = 0;
+        let type = "";
+        // Process FFmpeg output and parse out the fMP4 stream it's generating for HomeKit Secure Video.
+        this.process?.stdout.on("data", dataListener = (buffer) => {
+            // If we have anything left from the last buffer we processed, prepend it to this buffer.
+            if (bufferRemaining.length > 0) {
+                buffer = Buffer.concat([bufferRemaining, buffer]);
+                bufferRemaining = Buffer.alloc(0);
+            }
+            let offset = 0;
+            // FFmpeg is outputting an fMP4 stream that's suitable for HomeKit Secure Video. However, we can't just pass this stream directly back to HomeKit since we're using
+            // a generator-based API to send packets back to HKSV. Here, we take on the task of parsing the fMP4 stream that's being generated and split it up into the MP4
+            // boxes that HAP-NodeJS is ultimately expecting.
+            for (;;) {
+                let data;
+                // The MP4 container format is well-documented and designed around the concept of boxes. A box (or atom as they used to be called) is at the center of an MP4
+                // container. It's composed of an 8-byte header, followed by the data payload it carries.
+                // No existing header, let's start a new box.
+                if (!header.length) {
+                    // Grab the header. The first four bytes represents the length of the entire box. Second four bytes represent the box type.
+                    header = buffer.slice(0, 8);
+                    // Now we retrieve the length of the box.
+                    dataLength = header.readUInt32BE(0);
+                    // Get the type of the box. This is always a string and has a funky history to it that makes for an interesting read!
+                    type = header.slice(4).toString();
+                    // Finally, we get the data portion of the box.
+                    data = buffer.slice(8, dataLength);
+                    // Mark our data offset so we account for the length of the data header and subtract it from the overall length to capture just the data portion.
+                    dataLength -= offset = 8;
+                }
+                else {
+                    // Grab the data from our buffer.
+                    data = buffer.slice(0, dataLength);
+                    offset = 0;
+                }
+                // If we don't have enough data in this buffer, save what we have for the next buffer we see and append it there.
+                if (data.length < dataLength) {
+                    bufferRemaining = data;
+                    break;
+                }
+                // If we're creating a livestream to be consumed by the timeshift buffer, we need to track the initialization segment, and emit segments.
+                if (this.isLivestream) {
+                    // If this is part of the initialization segment, store it for future use.
+                    if (!this.hasInitSegment) {
+                        // The initialization segment is everything before the first moof box. Once we've seen a moof box, we know we've captured it in full.
+                        if (type === "moof") {
+                            this.hasInitSegment = true;
+                            this.emit("initsegment");
+                        }
+                        else {
+                            this._initSegment = Buffer.concat([this._initSegment, header, data]);
+                        }
+                    }
+                    if (this.hasInitSegment) {
+                        // We only emit segments once we have the initialization segment.
+                        this.emit("segment", Buffer.concat([header, data]));
+                    }
+                }
+                else {
+                    // Add it to our queue to be eventually pushed out through our generator function.
+                    this.recordingBuffer.push({ data: data, header: header, length: dataLength, type: type });
+                    this.emit("mp4box");
+                }
+                // Prepare to start a new box for the next buffer that we will be processing.
+                data = Buffer.alloc(0);
+                header = Buffer.alloc(0);
+                type = "";
+                // We've parsed an entire box, and there's no more data in this buffer to parse.
+                if (buffer.length === (offset + dataLength)) {
+                    dataLength = 0;
+                    break;
+                }
+                // If there's anything left in the buffer, move us to the new box and let's keep iterating.
+                buffer = buffer.slice(offset + dataLength);
+                dataLength = 0;
+            }
+        });
+        // Make sure we cleanup our listeners when we're done.
+        this.process?.once("exit", () => {
+            this.process?.stdout?.off("data", dataListener);
+        });
+    }
+    /**
+     * Retrieves the fMP4 initialization segment generated by FFmpeg.
+     *
+     * Waits until the initialization segment is available, then returns it.
+     *
+     * @returns A promise resolving to the initialization segment as a Buffer.
+     *
+     * @example
+     *
+     * ```ts
+     * const initSegment = await process.getInitSegment();
+     * ```
+     */
+    async getInitSegment() {
+        // If we have the initialization segment, return it.
+        if (this.hasInitSegment) {
+            return this._initSegment;
+        }
+        // Wait until the initialization segment is seen and then try again.
+        await events.once(this, "initsegment");
+        return this.getInitSegment();
+    }
+    /**
+     * Stops the FFmpeg process and performs cleanup, including emitting termination events for segment generators.
+     *
+     * This is called as part of the process shutdown sequence.
+     */
+    stopProcess() {
+        // Call our parent to get started.
+        super.stopProcess();
+        // Ensure that we clear out of our segment generator by guaranteeing an exit path.
+        this.isEnded = true;
+        this.emit("mp4box");
+        this.emit("close");
+    }
+    /**
+     * Starts the FFmpeg process, adjusting segment length for livestreams if set.
+     *
+     * @example
+     *
+     * ```ts
+     * process.start();
+     * ```
+     */
+    start() {
+        if (this.isLivestream && (this.segmentLength !== undefined)) {
+            const fragIndex = this.commandLineArgs.indexOf("-frag_duration");
+            if (fragIndex !== -1) {
+                this.commandLineArgs[fragIndex + 1] = (this.segmentLength * 1000).toString();
+            }
+        }
+        // Start the FFmpeg session.
+        super.start();
+    }
+    /**
+     * Stops the FFmpeg process and logs errors if specified.
+     *
+     * @param logErrors - If `true`, logs FFmpeg errors. Defaults to the internal process logging state.
+     *
+     * @example
+     *
+     * ```ts
+     * process.stop();
+     * ```
+     */
+    stop(logErrors = this.isLoggingErrors) {
+        const savedLogErrors = this.isLoggingErrors;
+        // Flag whether we should log abnormal exits (e.g. being killed) or not.
+        this.isLoggingErrors = logErrors;
+        // Call our parent to finish the job.
+        super.stop();
+        // Restore our previous logging state.
+        this.isLoggingErrors = savedLogErrors;
+    }
+    /**
+     * Logs errors from FFmpeg process execution, handling known benign HKSV stream errors gracefully.
+     *
+     * @param exitCode - The exit code from the FFmpeg process.
+     * @param signal   - The signal (if any) used to terminate the process.
+     */
+    logFfmpegError(exitCode, signal) {
+        // If we're ignoring errors, we're done.
+        if (!this.isLoggingErrors) {
+            return;
+        }
+        // Known HKSV-related errors due to occasional inconsistencies that are occasionally produced by the input stream and FFmpeg's own occasional quirkiness.
+        const ffmpegKnownHksvError = new RegExp([
+            "(Cannot determine format of input stream 0:0 after EOF)",
+            "(Could not write header \\(incorrect codec parameters \\?\\): Broken pipe)",
+            "(Could not write header for output file #0)",
+            "(Error closing file: Broken pipe)",
+            "(Error splitting the input into NAL units\\.)",
+            "(Invalid data found when processing input)",
+            "(moov atom not found)"
+        ].join("|"));
+        // See if we know about this error.
+        if (this.stderrLog.some(x => ffmpegKnownHksvError.test(x))) {
+            this.log.error("FFmpeg ended unexpectedly due to issues processing the media stream. This error can be safely ignored - it will occur occasionally.");
+            return;
+        }
+        // Otherwise, revert to our default logging in our parent.
+        super.logFfmpegError(exitCode, signal);
+    }
+    /**
+     * Asynchronously generates complete segments from FFmpeg output, formatted for HomeKit Secure Video.
+     *
+     * This async generator yields fMP4 segments as Buffers, or ends on process termination or timeout.
+     *
+     * @yields A Buffer containing a complete MP4 segment suitable for HomeKit.
+     *
+     * @example
+     *
+     * ```ts
+     * for await(const segment of process.segmentGenerator()) {
+     *
+     *   // Process each segment for HomeKit.
+     * }
+     * ```
+     */
+    async *segmentGenerator() {
+        let segment = [];
+        // Loop forever, generating either FTYP/MOOV box pairs or MOOF/MDAT box pairs for HomeKit Secure Video.
+        for (;;) {
+            // FFmpeg has finished it's output - we're done.
+            if (this.isEnded) {
+                return;
+            }
+            // If the buffer is empty, wait for our FFmpeg process to produce more boxes.
+            if (!this.recordingBuffer.length) {
+                // Segments are output by FFmpeg according to our specified IDR interval. If we don't see a segment within the timeframe we need for HKSV's timing requirements,
+                // we flag it accordingly and return null back to the generator that's calling us.
+                // eslint-disable-next-line no-await-in-loop
+                await runWithTimeout(once(this, "mp4box"), HKSV_TIMEOUT);
+            }
+            // Grab the next fMP4 box from our buffer.
+            const box = this.recordingBuffer.shift();
+            // FFmpeg hasn't produced any output. Given the time-sensitive nature of HKSV that constrains us to no more than 5 seconds to provide the next segment, we're done.
+            if (!box) {
+                this.isTimedOut = true;
+                return;
+            }
+            // Queue up this fMP4 box to send back to HomeKit.
+            segment.push(box.header, box.data);
+            // What we want to send are two types of complete segments, made up of multiple MP4 boxes:
+            //
+            // - a complete MOOV box, usually with an accompanying FTYP box, that's sent at the very beginning of any valid fMP4 stream. HomeKit Secure Video looks for this
+            //   before anything else.
+            //
+            // - a complete MOOF/MDAT pair. MOOF describes the sample locations and their sizes and MDAT contains the actual audio and video data related to that segment. Think
+            //   of MOOF as the audio/video data "header", and MDAT as the "payload".
+            //
+            // Once we see these, we combine all the segments in our queue to send back to HomeKit.
+            if ((box.type === "moov") || (box.type === "mdat")) {
+                yield Buffer.concat(segment);
+                segment = [];
+            }
+        }
+    }
+    /**
+     * Returns the initialization segment as a Buffer, or null if not yet available.
+     *
+     * @returns The initialization segment Buffer, or `null` if not yet generated.
+     *
+     * @example
+     *
+     * ```ts
+     * const init = process.initSegment;
+     * if(init) {
+     *
+     *   // Use the initialization segment.
+     * }
+     * ```
+     */
+    get initSegment() {
+        if (!this.hasInitSegment) {
+            return null;
+        }
+        return this._initSegment;
+    }
+}
+/**
+ * Manages a HomeKit Secure Video recording FFmpeg process.
+ *
+ * @example
+ *
+ * ```ts
+ * const process = new FfmpegRecordingProcess(ffmpegOptions, recordingConfig, 30, true, 5000000, 0);
+ * process.start();
+ * ```
+ *
+ * @see FfmpegFmp4Process
+ *
+ * @category FFmpeg
+ */
+export class FfmpegRecordingProcess extends FfmpegFmp4Process {
+    /**
+     * Constructs a new FFmpeg recording process for HKSV events.
+     *
+     * @param options          - FFmpeg configuration options.
+     * @param recordingConfig  - HomeKit recording configuration for the session.
+     * @param fps              - Video frames per second.
+     * @param isAudioActive    - If `true`, enables audio stream processing.
+     * @param probesize        - Stream analysis size, in bytes.
+     * @param timeshift        - Timeshift offset for event-based recording, in milliseconds.
+     */
+    constructor(options, recordingConfig, fps, isAudioActive, probesize, timeshift) {
+        super(options, recordingConfig, isAudioActive, { fps: fps, probesize: probesize, timeshift: timeshift });
+    }
+}
+/**
+ * Manages a HomeKit livestream FFmpeg process for generating fMP4 segments.
+ *
+ * @example
+ *
+ * ```ts
+ * const process = new FfmpegLivestreamProcess(ffmpegOptions, recordingConfig, url, 30, true);
+ * process.start();
+ *
+ * const initSegment = await process.getInitSegment();
+ * ```
+ *
+ * @see FfmpegFmp4Process
+ *
+ * @category FFmpeg
+ */
+export class FfmpegLivestreamProcess extends FfmpegFmp4Process {
+    /**
+     * Constructs a new FFmpeg livestream process.
+     *
+     * @param options          - FFmpeg configuration options.
+     * @param recordingConfig  - HomeKit recording configuration for the session.
+     * @param url              - Source RTSP or livestream URL.
+     * @param fps              - Video frames per second.
+     * @param isAudioActive    - If `true`, enables audio stream processing.
+     */
+    constructor(options, recordingConfig, url, fps, isAudioActive) {
+        super(options, recordingConfig, isAudioActive, { fps: fps, livestream: true, url: url });
+    }
+    /**
+     * Gets the fMP4 initialization segment generated by FFmpeg for the livestream.
+     *
+     * @returns A promise resolving to the initialization segment as a Buffer.
+     *
+     * @example
+     *
+     * ```ts
+     * const initSegment = await process.getInitSegment();
+     * ```
+     */
+    async getInitSegment() {
+        return super.getInitSegment();
+    }
+}
+//# sourceMappingURL=record.js.map

package/dist/ffmpeg/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/ffmpeg/record.ts"],"names":[],"mappings":"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"}