NReco.VideoConverter

Represents async live media conversion task.

Start live stream conversion

Write input data into conversion stream

Stop live stream conversion process

Stop live stream conversion process and optionally force ffmpeg to quit

force FFMpeg to quit by sending 'q' command to stdin.

Wait until live stream conversion is finished (input stream ended)

Do not call "Wait" when input stream is not used and input data is provided using Write method

Abort live stream conversions process

Media conversion setting

NReco.VideoConverter.OutputSettings

Add silent audio stream to output

Seek to position (in seconds) before converting

Extra custom FFMpeg parameters for 'input'

FFMpeg command line arguments inserted before input file parameter (-i)

Media concatenation setting

NReco.VideoConverter.OutputSettings

Determine whether audio stream

Seek to position (in seconds) before converting

The exception that is thrown when FFMpeg process retruns non-zero error exit code

FFMpeg input (filename, URL or demuxer parameter)

Input media stream format (if null ffmpeg tries to automatically detect format).

Extra custom FFMpeg parameters for this input.

These FFMpeg command line arguments inserted before input specifier (-i).

Represents user credential used when starting FFMpeg process.

Gets the user name to be used when starting FFMpeg process.

Gets a secure string that contains the user password to use when starting FFMpeg process.

Gets a value that identifies the domain to use when starting FFMpeg process.

The exception that is thrown when FFMpeg process retruns non-zero error exit code

Get FFMpeg process error code

Explicit sample rate for audio stream. Usual rates are: 44100, 22050, 11025

Audio codec (complete list of audio codecs: ffmpeg -codecs)

Explicit video rate for video stream. Usual rates are: 30, 25

Number of video frames to record

Video frame size (common video sizes are listed in VideoSizes

Video codec (complete list of video codecs: ffmpeg -codecs)

Get or set max duration (in seconds)

Extra custom FFMpeg parameters for 'output'

FFMpeg command line arguments inserted after input file parameter (-i) but before output file

Represents common video frame sizes

QVGA: 320x200

VGA: 640x480

SVGA: 640x480

XGA: 1024x768

SXGA: 1280x1024

WXGA: 1366x768

WSXGA: 1600x1024

UXGA: 1600x1200

HD480: 852x480

HD720: 1280x720

HD1080: 1920x1080

Represents common media format strings

Complete list of formats supported by FFMpeg: ffmpeg.exe -formats

AC-3 - encode and decode

Audio IFF (AIFF) - encode and decode

raw PCM A-law - encode and decode

ASF - encode and decode

WMV file (alias for ASF format) - encode and decode

AST (Audio format used on the Nintendo Wii.) - encode and decode

Sun AU - encode and decode

AVI (Audio Video Interleaved) - encode and decode

Apple CAF (Core Audio Format) - encode and decode

raw DTS

raw E-AC-3 - encode and decode

FFM (FFserver live feed) - encode and decode

raw FLAC - encode and decode

FLV (Flash Video) - encode and decode

raw H.261 - encode and decode

raw H.263 - encode and decode

raw H.264 - encode and decode

raw H.265 - only decode

Matroska - encode and decode

raw MPEG-4 video - encode and decode

raw MJPEG video - encode and decode

QuickTime / MOV - encode and decode

MP4 (MPEG-4 Part 14) - encode and decode

MP4 container cannot be used with live streams!

MPEG-1 Systems / MPEG program stream - encode and decode

PCM mu-law - encode and decode

Ogg - encode and decode

Sony OpenMG audio - encode and decode

WebM - encode and decode

Video converter component (wrapper to FFMpeg process)

Gets or sets path where FFMpeg tool is located

By default this property points to the folder where application assemblies are located. If WkHtmlToPdf tool files are not present PdfConverter expands them from DLL resources.

Gets or sets FFMpeg tool EXE file name ('ffmpeg.exe' by default)

Gets or sets maximum execution time for conversion process (null is by default - means no timeout)

Occurs when FFMpeg outputs media info (total duration, convert progress)

Occurs when log line is received from FFMpeg process

Gets or sets FFMpeg process priority (Normal by default)

Gets or sets user credential used for starting FFMpeg process.

By default this property is null and FFMpeg process uses credential of parent process (application pool in case of ASP.NET).

Gets or sets ffmpeg loglevel option (by default is "info").

Initializes a new instance of the FFMpegConverter class.

FFMpegConverter is NOT thread-safe. Separate instance should be used for each thread.

Converts media represented by local file and writes result to specified local file

local path to input media file local path to ouput media file desired output format (like "mp4" or "flv")

Converts media represented by local file and writes result to specified local file with specified settings.

local path to input media file input format (null for automatic format suggestion) local path to output media file output media format explicit convert settings

Converts media represented by local file and writes result to specified stream

local path to input media file output stream output media format

Converts media represented by local file and writes result to specified stream with specified convert settings.

local path to input media file input format (null for automatic format suggestion) output stream output media format convert settings

Converts several input files into one resulting output file.

one or more FFMpeg input specifiers output file name output file format (optional, can be null) output settings

Create a task for live stream conversion (real-time) without input source. Input data should be passed with Write method.

input stream media format output media stream output media format convert settings instance of

Create a task for live stream conversion (real-time) that reads data from FFMpeg input source and write conversion result to output stream

input source string identifier (file path, UDP or TCP source, local video device name) input stream media format output media stream output media format convert settings instance of

Create a task for live stream conversion (real-time) that reads data from stream and writes conversion result to the file

input live stream (null if data is provided by calling "Write" method) input stream media format output file path output media format convert settings instance of

Create a task for live stream conversion (real-time) that reads data from input stream and write conversion result to output stream

input live stream (null if data is provided by calling "Write" method) input stream media format output media stream output media format convert settings instance of

Extract video thumbnail (first frame) from local video file

path to local video file output stream for thumbnail in jpeg format

Extract video thumbnail (first frame) from local video file

path to local video file path to thumbnail jpeg file

Extract video frame from local video file at specified position

path to local video file output stream for thumbnail in jpeg format video position (in seconds)

Extract video frame from local video file at specified position

path to local video file path to thumbnail jpeg file video position (in seconds)

Concatenate several video files

list of local video files path to contactenation result file desired output format convert settings Note: all video files should have the same video frame size and audio stream.

Invoke FFMpeg process with custom command line arguments

string with arguments

Extracts ffmpeg binaries (if needed) to the location specified by .

If missed ffmpeg is extracted automatically before starting conversion process. In some cases it is better to do that explicetily on the application start by calling method. This method is not available in LT version (without embedded ffmpeg binaries).

Abort FFMpeg process started by ConvertMedia or ConcatMedia methods

This method IMMEDIATELY stops FFMpeg by killing the process. Resulting file may be inconsistent.

Stop FFMpeg process "softly" by sending 'q' command to FFMpeg console. This method doesn't stop FFMpeg process immediately and may take some time.

true if 'q' command was sent sucessfully and FFPeg process has exited. If this method returns false FFMpeg process should be stopped with Abort method.

Provides data for ConvertProgress event

Total media stream duration

Processed media stream duration

Provides data for log received event

Log line