FFAStrans wiki - original_manual

anal_interlacing

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter will run through (a portion of) the source file and try to detect the actual scan type of the video.

Percent of media

How many percent of the media file you want to analyze.

Start from

Here you specify the starting point in percent.

Max analyze duration

Lets you specify the max…

anal_loudness

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This node will analyze the current loudness based on the EBU-128R specification.

Discrete tracks

Sets the number of audio tracks/streams of be analyzed. A track can have one or more channels.

Total channels

Sets the total amount of channels the be analyzed per track. Regardless of the original layout, all audio channels are mapped to separate aud…

anal_videoq

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

Analyzer to compare processed video with a reference file. Includes the VMAF algorithm developed and used by Netflix.

Source media:

Sets the input media file on which to analyze. Default is to use %s_source%.

Reference

Sets the reference media on which to compare with the source. Default is to use %s_localized% which under normal circumstances wi…

audio_mapping

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

FFAStrans supports sophisticated audio channel mapping from the source to the output.

Track/stream <no. >

The number of discrete tracks dependent on the"Discrete tracks" settings. So if you have selected 2 discrete tracks, you can map what ever source channels you like to those tracks. If you specify source channel(s) that does not exist, it will be replaced by a silent channel. The nota…

avs_a_acmapper

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter enables you to map audio channels. You can also use it to reduce the number of channels being processed.

Channel layout

Here you select the total number of audio channels, ranging from one (mono) to 24 (22. 2). All channels will be muxed to one audio stream.

The mapping works by defining what channel goes where.

Example: Mapping 2 channels to 4, with t…

avs_a_normalize

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter will set the maximum output to desired value.

If "Value" is selected, 0 will be silent and 100 will bring audio to maximum level without clipping.

If 'dB' is selected, -+50 will decrease/increase by the selected dB.

avs_av_fade

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

Fade audio

Check whether audio should be faded or not.

Fade video

Check whether video should be faded or not.

Fade in

This defines the total length in frames of the fade in. The option applies for both audio and video.

Fade out

This defines the tot…

avs_av_insertmedia

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter enables you to insert a media file either in front of or at the end of the clip. Use this tool to insert a bumper on your videos. Supports variables.

Media file

Sets the path of the video file to be used as layer. Supports variables.

Length

Defines the length of your inserted media. When using video it makes sense to enable "Use …

avs_custom

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

With this editor you can create your own custom AviSynth scripts. When using the "Stills" or "A/VMedia" decoders, FFAStrans will return 'm_clip', which has video size and frame rate of the original source, and one audio stream holding all channels. Other properties might have changed depending on the decoder setting.

Set as 64 bit AviSynth

Tells the the workflow to use 64 bit process…

avs_v_color

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter can change pixel format, color space and depth of video.

Pixel format

Sets the pixel format of the output video. YUV being standard for most video formats.

Bit depth

Sets the bit depth (RGB) or sampling precision (YUV) of the selected pixel format.

Color space

Converts video to …

avs_v_crop

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter allows you to remove lines from left, right, top and bottom of the video.

Left, Right, Top, Bottom

Valid values are integers from 0 and up. If you are using the "Custom FFmpeg" encoder, you should make sure the value is divisable by 2. Otherwise some encoders may choke.

Maintain frame size

If you check this option, FFAStrans…

avs_v_deinterlace

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

With this filter you can make interlaced video progressive. To get the best result you should experiment with the different deinterlacers. Some of the interlacers produce double framerate at full height. These are marked with "2xFPS".

Method

Sets the method used for deinterlacing. The fastest being straight BOB deinterlacing which produce double framerate. The slowest being QTGMC but yield far…

avs_v_flip

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

Flips video horizontally and/or vertically.

avs_v_fpsconv

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

Filter for converting to other frame rates. FFAStrans will try to decide if the video is interlaced or not.

Convert to

Select a set of predefined common frame rates. You can also set custom frame rates.

There is also some special presets that lets you create interlaced, upper or lower, from progressive. It will check the clip for valid progressive frames before performing the conversion.

<…

avs_v_linear_trans

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

With this filter you can apply matrices of linear transformation with 16bit planar precision to convert color curves.

Transformation

Selects the transformation that needs to be applied; currently, only those conversions are supported:
From "Linear_BT601_NTSC" to "Linear_BT709"
From "Linear_BT601_PAL" to "Linear_BT709"
From "Linear_BT709" to "Linear_BT601_NTSC"
From "Linear_BT709" to "…

avs_v_pad

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter will add lines to either sides of video. You can also choose what color should be filled.

Left, Right, Top, Bottom

Valid values are integers from 0 and up. If you are using the "Custom FFmpeg" encoder, you should make sure the value is divisable by 2. Otherwise some encoders may choke.

Color

Sets color to fill the padded vid…

avs_v_resize

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

Video size

A set of predefined valid frame sizes. You can also make custom size. If you select "Percent" the"Width" and "Height" values will be relative to the original. Please note that the scaling is NOT gonna be AR Aware.

Pixel aspect

Sets the pixel aspect (PAR) on the output media.

Quality

avs_v_reverse

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter will reverse video and audio. Interlaced video will switch parity.

avs_v_safecolorlimiter

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

With this filter you can get Broadcast Safe luma and chroma levels (0.0-0.7V) in Limited TV Range depending on the Bit Depth

Bit Depth

Sets the Bit Depth. Recommended: Auto.
8bit sources will be limited to 16 - 235 luma and 16 - 240 chroma
10bit sources will be limited to 64 - 940 luma and 64 - 960 chroma
12bit sources will be limited to 256 - 3760 luma and 256 - 3840 chroma
14bit so…

avs_v_swapfields

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter swaps makes upper field lower, and vice versa. If you use this on progressive source the video may look horrible.

avs_v_tc

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter adds superimposed timecode on you video.

Start TC

Sets the start TC of the video. Default start is at 00:00:00:00.

Use original medias start timecode

This option will use the start timecode as read from the original media.

Force FPS

Force the time code label to frames per secon…

avs_v_videolayer

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This filter lets you add video overlaid on your clip. It usually makes sense if you have an animated logo, or a transparent bumper at the start of you video.

Video file

Sets the path of the video file to be used as layer. Supports variables.

Opacity

Sets transparency level ranging from 0 to 257.

Loop

avs_v_watermark

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

Image file

File to use for overlay. May be transparent. Supports variables.

Type: PNG

Opacity

Set transparency level.

Value: 0 – 257

Resize to fit source

Resize the image to fit the source height and weight. Aspect will not be kept.

Sets the x and y offset on the number of pixel …

cmd_run

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:45+00:00

This processor is what ever you want it to be. It's intended to be used with variables.

Command

Here you write the complete DOS command you want to execute. FFAStrans will always wait for the execution to end. Remember to use full paths and quotes where needed. Supports variables. Use the "%s_source%" variable to insert source media picked up by monitors or manually submitted.

Line feed…

dec_avmedia

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This decoder is necessary only in order to use filters. It will produce a valid AviSynth script on which filters can be built. FFAStrans is shiped with AviSynth+ as standard. If you have any other versions installed, FFAStrans will still used the one that comes with FFAStrans.

Use video

This decides whether to use video from incoming file or not. If the option is unchecked FFAStrans will c…

dec_stills

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This decoder will create an AviSynth script, full with audio, prepared for the filters and any encoder. The video will be full frame, 32 bit RGB and there will be 32 silent audio channels.

Set length to

Lets you define length written in SMPTE time code style; HH:MM:SS:FF. That is HOUR:MINUTES:SECOND:FRAMES.

Set frames per second to

Here you set t…

dec_youtube

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Use this decoder to fetch video links from YouTube, Vimeo, Instagram etc. This works by dragging a link from your browser address bar into a watch folder. Supports links from Internet Explorer, Safari, Chrome, Firefox and Opera using OS-X, Windows or Linux.

This decoder uses youtube-dl from http://rg3.github.io/youtube-dl/

Config file

Lets y…

def_watcher_conf_farming

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Here you can include or exclude hosts in the workflow. The purpose of this is to create segregated farming environments that lets you design special workflow for special members of the farm.

Host

The host to add to the list. Default is the current host. You can insert any host on the list. The hosts will not be validated so you must write the correct name for the host.

Add host…

def_watcher_conf_general

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Description

Description of your workflow. Has no implication on functionality but it will be displayed in the upper editor area if description is enabled there.

Work folder

This info tells you where the workfolder for the workflows jobs reside. This is set automatically from the"Work cache" options in the main configuration and cannot be changed by the…

def_watcher_conf_maintainance

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Keep all job work folders on completion

Enabling this option will prevent FFAStrans from deleting all the files and work folders it creates for jobs.

Note: You should avoid enabling this as the it may fill up your storage. Use only for debugging.

Keep only failed job work folders

Enabling this option will prevent FFAStrans from deleting th…

def_watcher_conf_special

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This is the special settings for the workflow.

Log level

Sets the log level of the workflow. Higher log levels produce more detailed logging information for debugging. Logging is always on.

Protect workflow

Here you can protect you workflow with a password. Note that this is not a foolproof protection. It's purpose is to make sure your workflow h…

dest_folder

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Folder

Set output folder for delivery. Supports drag'n drop.

Prefix

This input enables you to insert custom text ahead of the output file. Supports global variables.

Suffix

This input enables you to append custom text to output file. The source extension will not be affected. Supports global variables.

dest_ftp

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This node writes files to an FTP address.

Set the IP or DNS address for the FTP server.

Port

Sets the port number to use. Usually 21.

Username/Password

Here you specify user name and password. If none is specified an Anonymous login will be used.

Path

This is the path in which to lo…

dest_mediadist

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

With this destination you candistribute different media types different folders. Check any of the boxes and choose a destination to distribute files. This filter does not rely onextensions but rather on file analysis. Supports variables.

enc_a_audio

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This node will extract and output audio only files in different formats. Depending on the selected layout, each stream will be routed to separate files.

Format

Sets the audio format and codec. "Uncompressed" and "Lossless" gives no quality loss. The latter is lossless compressed.

Bit depth

Sets the audio bit depth. This will v…

enc_av_265

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Encoder to support h/x-265 (HEVC) ready for use in YouTube, iPhone, Android and most modern media players..

Video size

This option will scale the output video to the defined size. At default FFAStrans will take the input width and height variables of the source video and apply it to scaling. Note that interlaced aware scaling are automatically taken care of.

Display aspect

enc_av_avcintra

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This encoder creates an AVC-Intra compliant media file in MXF.

Format

Here you set the resolution and framerate for AVC-Intra format. Note that AVC-Intra only support a predefined set of resolution and frame rate.

Class/type

Select the bitrate/class for the video.

Processing

Sets the proce…

enc_av_customff

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This encoder enables you to make your own custom FFMpeg based encoder. You can also save your setting for later use. This way you can write you own extensive set of encoders. Please consult the FFMpeg documentation on how to use FFMpeg's options.

Note: If you are using this encoder in conjunction with the "A/V Media" decoder you might need to add a "Channel Mapper" filter since "A/V Media" decoder allows outputt…

enc_av_dnxhd

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This encoder creates an Avid DNxHD compatible media file in MOV or MXF.

Format

Here you set the resolution and framerate for DNxHD format. Note that DNxHD only support a predefined set of resolutions and frame rates.

Video bitrate (Mb/s)

Select the bitrate for the video and also sets the DNxHD standard.

Processing

enc_av_dnxhr

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This encoder creates an Avid DNxHR type media file in MOV or MXF.

Format

Here you set the resolution and framerate for DNxHR format. It will support "any" kind of resolution. If "Same as source" (default) is selected the output video will have same width and hight as the source.

Note: When using "Same as source" and your source is below 720p (HD), the out…

enc_av_dv

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Creates DV files in SD.

Format

Sets DV format in PAL or NTSC. It also support DVCPRO variants.

Display aspect

Sets display aspect ratio (DAR).

Processing

Sets the processing mode for the video. This comes especially in handy when you just want to conform audio and leave video as is.

enc_av_dvd

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

With this encoder you can create DVD compliant MPEG2 files.

Format

Option to define what kind of MPEG2 to create. PAL and NTSC is supported.

Display sspect

Defines the aspect for the video(DAR).

Field order

Sets the fields dominance.

Interlacing

enc_av_imxd10

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Creates Sony IMX compatible SD files.

Format

Sets format to PAL/NTSC

Bitrate (Mb/s)

Set compression bitrate for video.

Processing

Sets the processing mode for the video. This comes especially in handy when you just want to conform audio and leave video as is.

ALL string inputs containing alphabetic characters (a-z, A-Z) must be encapsulated with single or double quotes: "my string", '123abc', "%s_variable%", '%i_variable%'.
…

hosts_groups_conf

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This section defines the hosts groups. A host group is a named group of hosts that can be assigned to any workflows or nodes.

Delete group

Deletes the selected group from the list.

Add hosts

Add the host to the group.

Remove

Removes selected host(s) from the group.

Ne…

manager_conf

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This is the global configuration.

Global media cache

Here you set the global working directory of FFAStrans. This is where decoding take place so make sure it's big enough for all your task. This is used for farming environment.

Note: For shared media cache to work it MUST be pointed to a shared network path or SAN.

Use global shared media cache

manager_email_conf

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This is the global SMTP configuration used by FFAStrans when sending mail messages. Please note that two factor authentication will not work very well.

From name

The name displayed as the sender name

From e-mail

The mail address displayed as the sender address.

SMTP server

Na…

manager_host_conf

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This section is a local host only section.

Local host media cache

Here you set the working root directory of the local host. This option is only enabled and used if the "Use global shared media cache" option under "General" is deselected. Otherwise the input field will show the same as "shared media cache" under "General".

Web REST service
…

manager_user_conf

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

These preferences are user settings and are saved in the active users Windows home directory.

Warn when deleting processor nodes

Warns the user when user tries to delete one or several processors nodes from a workflow. Default is off.

Warn when deleting node connections

Warns the user when user tries to delete a connection between t…

mon_folder

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This node is for monitoring local or UNC paths. It will also parse Windows shortcuts and Mac alias to find the correct file. Be aware that the "Recurse" and "Forget missing files" options will cause the monitor, run in a separate process, to use more CPU. This is most notable when monitoring thousands of files.

Folder

Set folder that will be monitored. Supports drag'n drop.
…

mon_ftp

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

Server

Set the IP or DNS address for the FTPserver.

Port

Sets the port number to use. Usually21.

User name/Password

Here you specify user name and password. If none is specified an Anonymous log in will be used.

Path

This is the path in which to lo…

mon_gopro

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:46+00:00

This monitor looks for GoPro material and concatenates spanned clips.

Set folder that will be monitored. May be local or UNC. Supports variables and drag'n drop. The monitor looks for GoPro file structure so the setting should point to the root folder.

Create folder

If this is checked, FFAStrans will automatically create, if it does not exist, the folder specified under«Folder».

Chec…

mon_p2

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

Folder

Set folder that will be monitored. May be local or UNC. Supports variables and drag'n drop. The monitor looks for a Panasonic P2 file structure so the setting should point to the root folder of PP2. The monitor also supports clips spanned over several disk and will automatically search for these in the same monitors folder. If they cannot be located it will try to searching local removable drives.

The …

mon_sequence

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

This monitor will check folders for image sequence. By default it will search for matching file patters that include numbers.

Set folder that will be monitored. May be local or UNC. Supports variables and drag'n drop.

Accept/Deny files

Here you can define what kind of files that will be accepted or denied. Supports wild card (*) and question mark(?) for single character. Multiple file na…

mon_xf

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

Folder

Set folder that will be monitored. May be local or UNC. Supports variables and drag'n drop. The monitor looks fora Canon XF file structure so the setting should point to the root folder of CXF.

Create folder

If this is checked, FFAStrans will automatically create, if it does not exist, the folder specified under «Folder».

Forget miss…

op_analyzer

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

This node will analyze the current loudness based on the EBU-128R specification.

Discrete tracks

Sets the number of audio tracks/streams to be analyzed. One track can be analyzed with one or more channels.

Source channels as tracks

This setting will analyze all source audio channels as discrete mono channels…

op_cond

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

With this node you can evaluate complex expressions, by using variables/statics and functions, in order to alter the path of your workflow job. The node consists of eight (8) rows in which to populate your expressions. All the input fields accepts common mathematical symbols like +, -, *, /, ^ and ().

An expression within one input field could look like:

(%i_frames%/%f_fps)+100

…

op_foreach

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

This node enables dynamic branching of values in an array.

Array string

Input field for the string represented as an array or a a line feed separated string.

Please check out https://www.w3schools.com/js/js_json_arrays.asp for how to construct a proper array string.

Note that valid array…

op_hold

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

This processor node will put the job instance in pause until one of the following criterias are met:

Sleep

Pauses the job instance in the amount of seconds specified in the "Time" input.

Synchronize

This special option pauses the job instance until all other instances of the job has reached the same point/node. The timeout option is als…

op_populate

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

In this node you populate your user variables with values, strings, functions or evaluation from complete expressions. There are rows on which you can populate. The next row will activate when you have selected a variable for the initial row. If you need to populate more than eight variables you can just add another node.

Set user variable

With this selector you set what variable to populate. You can NO…

other_email

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

With this node you can send mail to one or multiple recipients.

Please note that the SMTP configuration is global and done in the main FFAStrans configuration window.

To

Receivers e-mail. Multiple receivers is separated with a semicolon ";".

Cc

Mail address to "Carbon copy"receivers. Multiple receivers is separat…

other_httpsend

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

This is a node for sending commands to URLs through HTTP communication. It's very useful for triggering other devices/software through API's.

Body

The field on which to put the string you want to represent the body text.

URL

The http URL to send the text message.

Method

HTTP method used fo…

other_textfile

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

With this node you can create a text file or append to an existing.

Folder

The folder where you want to create the ext file.

Text file name

The file name of the text file.

Encoding

Sets encoding type for the text file. Default is UTF-8 without BOM.

Append to text file…

sub_wf

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

This node lets you send the job to another workflow. All job related data are trasmitted to the defined workflow. You can also specify the recieving node in the workflow.

ID

Defines the workflow ID on which to send to. When the config window is open you can select workflow from the workflow list in the manager and the config will automatically update. You can also use variables holding a proper workflow…

user_variables

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

Here you can define you user variables.

Set

variable: Creates a normal user variable. This will always be lower case and spaces are not allowed.

static: This is a static that can not be populated dynamically in workflows.

as

string: Sets the var…

variables

Anonymous (anonymous@undisclosed.example.com) — 2025-02-16T15:27:47+00:00

Variables are used to adapt and alter your workflow jobs to fit your output needs and incoming media. A variable is represented by a text string encapsulated with the percentage (%)character:

%f_fps%, %username%, %s_original_name% etc.

FFAStrans has 6 categories of variables:

File properties

Media properties