LipsyncFlow - FFmpeg Options Editing Guide

📚 Managing Your FFmpeg Library

1 Open the Library
Navigate to

2 Add New Processor
Click the Add button to create a new ffmpeg processor

3 Edit Processor
Double-click any processor in the grid to open the JSON editor

4 Configure FFmpeg Options
In the editor, set:

type: "ffmpeg"
value: Your ffmpeg filter chain

                💡 Pro Tip: The library automatically saves your processors and makes them available across all your projects!
            

📝 Note: The service only supports video filters (-vf) and audio filters (-af). Filter values default to video filters. You can specify the filter type by including the prefix:

No prefix: "hflip" → becomes "-vf hflip" (video filter)
Video filter: "-vf scale=1920:1080" → used as-is
Audio filter: "-af volume=2.0" → used as-is (audio filter)

🎯 Using Processors in Your Scripts

For Sequences

1 Open any sequence editor

2 In the "Processors" section, you'll find:

Per Clip Processors - Applied to individual clips
Joined Video Processors - Applied to the final joined video

3 Click Add From Library... to select from your saved processors

For Script Entries

1 Open any script entry editor

2 In the "Processors" section, you'll find:

Per Clip Processors - Applied to individual clips
Final Frame Processors - Applied to final frames

3 Click Add From Library... to select from your saved processors

Screenshot of the Edit per_clip_processors dialog showing how to edit FFmpeg values

Figure: Edit per_clip_processors Dialog
This dialog allows you to manage individual media processors. It displays a table with 'Key', 'Type', and 'Value' columns.

'Object' Type Rows (e.g., 'FlipHorizontal', 'ColorEQ'): When the 'Type' is 'object', double-clicking the 'Value' field will open a separate dictionary editor dialog for detailed configuration. This is where you can edit the FFmpeg filter values.
'String' Type Rows (e.g., 'Brighter'): When the 'Type' is 'string', the 'Value' field can be directly edited by clicking into it. This is used for simple text-based processor values.

The example shows 'FlipHorizontal' (object), 'Brighter' (string), and 'ColorEQ' (object) processors. The 'Value' fields display JSON snippets like {"type":"ffmpeg","value":...}.

To edit FFmpeg values: Double-click on any 'object' type row's Value field to open the dictionary editor, where you can modify the FFmpeg filter parameters.

Buttons at the bottom include 'Add', 'Remove', 'Import JSON', 'from Library', 'OK', and 'Cancel'.

Import Options

The dialog provides two powerful import options to help you quickly add FFmpeg processors:

Screenshot of the Import from Library dialog showing available media processors

Figure: Import from Library Dialog
This dialog appears when you click the "from Library" button. It shows all available media processors from your library with checkboxes to select which ones to import.

Available Processors: Lists all saved processors (e.g., 'FlipHorizontal', 'Brighter', 'ColorEQ') with checkboxes
Selection: Check the boxes next to the processors you want to import
Import Button: Click to add the selected processors to your current dialog
Cancel Button: Close without importing anything

This is the easiest way to reuse previously created FFmpeg processors across different projects.

How to Use Import Buttons

1 Import JSON Button: Click this to import processors from external sources

From Clipboard: If you have JSON data copied, the dialog will ask if you want to import from clipboard
From File: If you click "No" to clipboard, you can browse and select a JSON file
Use Case: Import processors from other projects, share configurations, or restore from backups

2 From Library Button: Click this to import from your saved processor library

Select Processors: Check the boxes next to the processors you want to add
Import Selected: Click "Import" to add them to your current dialog
Use Case: Quickly reuse your favorite FFmpeg effects across different script entries

💡 Pro Tip: The "From Library" button is only available when you have a media processor library loaded. If you don't see it, make sure you've created some processors in the Media Processor Library first.

📚 Media Processor Library

The Media Processor Library is your central hub for creating, managing, and reusing custom FFmpeg filter configurations. This is where you build your toolkit of FFmpeg effects that can be quickly applied across different projects.

Figure: Media Processor Library Dialog
This dialog is your central repository for managing reusable FFmpeg filter definitions. Each row represents a 'Media Processor' with a 'Name', 'Type' (always 'ffmpeg' for these filters), and 'Value' (the FFmpeg filter chain).

Defining Processors: Use the 'Add', 'Remove', and 'Edit...' buttons to manage your list of processors
Import/Export: The 'Import' and 'Export' buttons allow you to save and load your entire library of processors as a JSON file, making it easy to share or back up your configurations
Editing Values: Double-clicking a row or using the 'Edit...' button opens a dictionary editor where you can define the FFmpeg filter 'Value'
Relationship to 'From Library' Dialog: The processors defined here are the exact items that appear for selection when you click the 'From Library...' button in other dialogs

How to Use the Media Processor Library

1 Creating New Processors: Click the Add button to create a new media processor

Enter a descriptive name (e.g., "MyCustomSharpen")
Set the type to "ffmpeg"
Enter your FFmpeg filter value (e.g., "unsharp=5:5:0.8:3:3:0.4")

2 Editing Existing Processors: Double-click any row or select it and click Edit...

This opens a dictionary editor where you can modify the processor's properties
Perfect for fine-tuning FFmpeg filter parameters

3 Managing Your Library: Use the toolbar buttons for various operations

Remove: Delete the selected processor
Import: Load processors from a JSON file
Export: Save your entire library to a JSON file

Connection to "From Library" Dialog

The Media Processor Library is directly connected to the "From Library" dialog you saw earlier. Here's how they work together:

                🔄 Workflow: 
                Create: Define your FFmpeg processors in the Media Processor Library
Save: These processors are automatically saved and available across all projects
Reuse: When editing script entries, click "From Library" to see and select from your saved processors
Apply: Selected processors are instantly added to your current dialog

            

💡 Pro Tip: Build a comprehensive library of your most-used FFmpeg effects. This saves time and ensures consistency across all your video projects. You can export your library to share with team members or backup your configurations.

🔗 Additional Resources

For more detailed information about FFmpeg filters and commands, check out these helpful resources:

📖 Official FFmpeg Documentation

Comprehensive official documentation covering all FFmpeg features, filters, and command-line options.

Visit FFmpeg Docs →

🎬 FFmpeg Filter Documentation

Detailed reference for all available video and audio filters, including examples and parameter descriptions.

View Filter Reference →

🎵 Audio Filter Reference

Complete guide to audio processing filters including equalizers, compressors, and effects.

Audio Filters Guide →

🎨 Video Filter Reference

Comprehensive list of video filters for scaling, color correction, effects, and transformations.

Video Filters Guide →

⚡ FFmpeg Examples

Practical examples and common use cases for video and audio processing with FFmpeg.

View Examples →

🔧 FFmpeg Wiki

Community-maintained wiki with tutorials, guides, and troubleshooting information.

Browse Wiki →

💡 Quick Reference: When looking up FFmpeg filters, remember that this application only supports video filters (-vf) and audio filters (-af). Other FFmpeg options like codec settings or input/output specifications are not supported in the Media Processor Library.

📋 Dictionary Examples

Here's what the JSON structure looks like for each type of processor:

📚 Library Entry

{
  "name": "NormalizeAudio",
  "type": "ffmpeg", 
  "value": "loudnorm"
}

🎬 Sequence Per Clip Processors

{
  "audio_normalize": {
    "type": "ffmpeg",
    "value": "loudnorm"
  },
  "video_scale": {
    "type": "ffmpeg", 
    "value": "scale=1920:1080"
  }
}

🎞️ Sequence Joined Video Processors

{
  "final_effects": {
    "type": "ffmpeg",
    "value": "hflip,scale=1280:720"
  },
  "audio_boost": {
    "type": "ffmpeg",
    "value": "-af volume=2.0"
  },
  "video_enhance": {
    "type": "ffmpeg",
    "value": "-vf eq=brightness=0.1:contrast=1.1"
  }
}

📝 Script Entry Per Clip Processors

{
  "clip_enhance": {
    "type": "ffmpeg",
    "value": "unsharp=5:5:0.8:3:3:0.4"
  },
  "color_adjust": {
    "type": "ffmpeg",
    "value": "eq=brightness=0.1:contrast=1.1:saturation=1.0:gamma=1.0"
  }
}

🖼️ Script Entry Final Frame Processors

{
  "frame_watermark": {
    "type": "ffmpeg", 
    "value": "overlay=10:10"
  },
  "blur_effect": {
    "type": "ffmpeg",
    "value": "boxblur=5:1"
  }
}

⚡ Quick Reference

Common FFmpeg Values

Video Filters (default -vf):
Horizontal flip:         "hflip"
Scale video:             "scale=1920:1080"
Multiple filters:        "scale=1920:1080,hflip"
Color adjustment:        "eq=brightness=0.1:contrast=1.1:saturation=1.0:gamma=1.0"
Unsharp mask:            "unsharp=5:5:0.8:3:3:0.4"

Audio Filters (-af prefix):
Audio normalization:     "-af loudnorm"
Audio volume boost:      "-af volume=2.0"
Audio equalizer:         "-af equalizer=f=1000:width_type=h:width=200:g=5"

💡 Manual Editing: You can edit processor JSON directly in the grid without using the library picker.

✅ Validation: The system ensures unique names and valid JSON format automatically.

💾 Persistence: Your library is automatically saved and restored between sessions.

📤 Import/Export: Use the Library dialog to backup or share your processor collections.

⚠️ Important: Make sure your ffmpeg filter syntax is correct. Invalid filters may cause processing errors.

🔧 Advanced Usage

Complex Filter Chains

You can combine multiple ffmpeg filters in a single processor:

{
  "complex_processing": {
    "type": "ffmpeg",
    "value": "scale=1920:1080,hflip,unsharp=5:5:0.8:3:3:0.4 -af loudnorm,volume=1.2"
  },
  "video_audio_combo": {
    "type": "ffmpeg",
    "value": "-vf eq=brightness=0.1:contrast=1.1 -af equalizer=f=1000:g=3"
  }
}

Conditional Processing

Use additional JSON fields for more control:

{
  "conditional_scale": {
    "type": "ffmpeg",
    "value": "scale=1920:1080",
    "condition": "width > 1920",
    "description": "Scale down if video is too wide"
  }
}

🎬 LipsyncFlow

📚 Managing Your FFmpeg Library

🎯 Using Processors in Your Scripts

For Sequences

For Script Entries

Import Options

How to Use Import Buttons

📚 Media Processor Library

How to Use the Media Processor Library

Connection to "From Library" Dialog

🔗 Additional Resources

📖 Official FFmpeg Documentation

🎬 FFmpeg Filter Documentation

🎵 Audio Filter Reference

🎨 Video Filter Reference

⚡ FFmpeg Examples

🔧 FFmpeg Wiki

📋 Dictionary Examples

📚 Library Entry

🎬 Sequence Per Clip Processors

🎞️ Sequence Joined Video Processors

📝 Script Entry Per Clip Processors

🖼️ Script Entry Final Frame Processors

⚡ Quick Reference

Common FFmpeg Values

🔧 Advanced Usage

Complex Filter Chains

Conditional Processing