node-red-contrib-ffprobe-zzzcrosss 5.0.2

Node-RED node to extract audio/video metadata using ffprobe

npm install node-red-contrib-ffprobe-zzzcrosss

node-red-contrib-ffprobe-zzzcrosss

Custom Node‑RED node that uses ffprobe (from the FFmpeg suite) to analyze audio and video files and extract detailed technical metadata.

This node is designed for media inspection, quality control, and automation workflows in Node-RED.

✨ Features

• Analyze audio and video files
• Extract container and stream metadata
• JSON output generated directly by ffprobe
• Supports local files and Windows UNC paths
• Configurable execution timeout
• Optional custom ffprobe arguments
• Robust error handling

📦 Requirements

• Node.js >= 16
• Node-RED >= 3.x
• ffprobe installed on the system

Verify ffprobe availability:

ffprobe -version

📥 Installation

INSTALLATION GUIDE node-red-contrib-ffprobe-zzzcrosss

This document explains all the available ways to install the node-red-contrib-ffprobe-zzzcrosss node for Node-RED.

REQUIREMENTS

Before installing the node, make sure you have:

• Node.js version 16 or later
• Node-RED version 3.x or later
• ffprobe installed on the system (part of the FFmpeg suite)

Verify ffprobe availability by running:

ffprobe -version

Notes:

• On Linux and macOS, ffprobe must be available in the system PATH
• On Windows, you can either add ffprobe to the PATH or configure the full path to ffprobe.exe in the node settings

INSTALLATION METHOD 1: NODE-RED PALETTE (RECOMMENDED)

This is the easiest and recommended installation method.

1. Open the Node-RED editor in your browser

2. Open the menu (top right)

3. Select "Manage palette"

4. Go to the "Install" tab

5. Search for:

   node-red-contrib-ffprobe-zzzcrosss
   

6. Click "Install"

Once installed, the ffprobe node will appear in the Node-RED palette.

INSTALLATION METHOD 2: NPM (COMMAND LINE)

This method installs the node directly using npm.

1. Open a terminal

2. Move to the Node-RED user directory (usually ~/.node-red):

   cd ~/.node-red
   

3. Install the node using npm:

   npm install node-red-contrib-ffprobe-zzzcrosss
   

4. Restart Node-RED:

   node-red
   

After restarting, the ffprobe node will be available in the palette.

INSTALLATION METHOD 3: MANUAL INSTALLATION FROM GITHUB

This method is useful for development, testing, or modifying the source code.

1. Open a terminal

2. Move to the Node-RED user directory:

   cd ~/.node-red
   

3. Clone the repository from GitHub:

   git clone https://github.com/zzzcrosss/node-red-contrib-ffprobe-zzzcrosss.git
   

4. Enter the project folder:

   cd node-red-contrib-ffprobe-zzzcrosss
   

5. Install dependencies:

   npm install
   

6. Restart Node-RED:

   node-red
   

The ffprobe node will now appear in the Node-RED palette.

NOTES

• Restarting Node-RED is required after every installation method
• The node does not modify the analyzed media files
• All metadata is generated directly by ffprobe

END OF FILE