mediainfo-z

Production-ready MediaInfo node for Node-RED

A powerful, robust, and user-friendly Node-RED node to extract complete metadata from media files (video, audio, images, subtitles, etc.) using MediaInfo.

✨ Features

• Clean and intuitive UI inspired by ffprobe-z
• Full support for msg.payload.path and msg.payload.filePath
• Configurable timeout to prevent hanging
• Maximum output size protection (prevents memory exhaustion)
• Optional debug logging
• Robust cross-platform path handling (Windows, Linux, macOS)
• Support for custom MediaInfo CLI arguments
• Automatic MediaInfo detection

Installation

Go to your Node-RED user directory

cd ~/.node-red

Clone the repository

git clone https://github.com/YOUR-USERNAME/mediainfo-z.git nodes/mediainfo-z

Install dependencies

cd nodes/mediainfo-z npm install

Restart Node-RED

cd ~/.node-red npm install mediainfo-z

Usage Input JSON{ "payload": { "path": "/path/to/your/file.mkv", "timeout": 45000, "args": "--Output=JSON" } } You can also use filePath instead of path. Output JSON{ "payload": { "status": "success", "processingSuccess": true, "fileOpened": true, "error": null, "durationMs": 1247 }, "mediainfo": { // Complete MediaInfo metadata } }

Examples Basic Example JavaScriptmsg.payload = { path: "/media/movies/inception.mkv" }; return msg; With Custom Arguments JavaScriptmsg.payload = { path: "/media/file.mp4", args: "--Output=JSON --Language=raw" };

Requirements

MediaInfo CLI installed on the system Node-RED v3.0 or higher (recommended)

Notes This node is designed for production stability. It includes safeguards against very large files and excessive output.

License MIT License