FFMPEG - PNG Overlay - Fade In / Out

This guide explains how to overlay a PNG image with transparency onto an FFmpeg video, apply fade-in and fade-out effects at specific timestamps, and concatenate multiple clips. By using the overlay filter with alpha channel support and the fade filter for opacity transitions, you can create professional-looking intros or watermarks without re-encoding the entire source stream unnecessarily.

Preparing the Overlay Image

For an overlay to fade correctly, it must contain an alpha channel. If your PNG does not have transparency data, the fade effect will only change the visible pixels, leaving a solid rectangular block behind. Ensure your source image is saved as a PNG with transparency. If you are creating this programmatically, use libraries that support RGBA formats. When using FFmpeg to process the overlay itself before applying it to the video, ensure the pixel format is compatible. The most robust method involves ensuring the overlay has an alpha plane so the overlay filter can composite it properly over the main video stream.

Fading the Overlay In and Out

To make the overlay appear and disappear smoothly, you need to manipulate its opacity over time. FFmpeg provides the fade filter for this purpose. You can chain filters to first fade the image and then overlay it. The syntax generally follows the pattern of specifying the start time, duration, and direction (in or out). For example, to fade in from second 0 to second 2, and fade out from second 8 to second 10, you would construct a complex filter graph. It is crucial to note that the alpha parameter mentioned in some older tutorials is deprecated or incorrect for modern usage; instead, rely on the fade filter's native opacity handling or use format=rgba to ensure proper channel handling. The command structure typically looks like this:

ffmpeg -i input.mp4 -i overlay.png -filter_complex "[1:v]fade=in:st=0:d=2,fade=out:st=8:d=2[ovr];[0:v][ovr]overlay=x=10:y=10" output.mp4

In this example, [1:v] refers to the second input file (the overlay). The fade=in:st=0:d=2 starts fading in immediately and finishes after 2 seconds. The fade=out:st=8:d=2 begins fading out at 8 seconds and completes by 10 seconds. The result is labeled [ovr]. This labeled output is then used in the overlay filter alongside the main video [0:v]. Adjust x and y coordinates to position the overlay where desired.

Combining Multiple Videos

Once you have mastered adding overlays, you may need to join several video clips together. FFmpeg handles this efficiently using the concat demuxer or filter graphs. The concat demuxer is often faster because it can perform a stream copy rather than re-encoding, provided all inputs have identical codecs and parameters. Create a text file listing your files:

file 'clip1.mp4'
file 'clip2.mp4'
file 'clip3.mp4'

Then run:

ffmpeg -f concat -safe 0 -i filelist.txt -c copy combined.mp4

If your clips have different properties, you must re-encode them to a common standard before concatenation. This process is more computationally intensive. For more details on optimizing performance during splitting or joining operations, see Troubleshooting Slow Video Splitting with FFmpeg. When combining videos with overlays, you can apply the overlay filter to each segment individually before concatenating, or concatenate first and then apply the overlay if the timing allows. Applying the overlay per-segment ensures consistent positioning relative to each clip's timeline. Be aware that mismatched metadata between clips can cause playback issues in some players. To avoid sound synchronization problems during these merges, check our guide on FFmpeg Warning and No Sound on the Encoding Video, which addresses common audio stream discrepancies.

Advanced Timing and Precision

For precise control over when the overlay appears, you can use the enable option within the overlay filter. This allows you to define expressions based on time. For instance, enable='between(t,1,5)' shows the overlay only between 1 and 5 seconds. This is useful for dynamic graphics that should not rely solely on the fade filter's duration but on exact start and end points. If you are working with H.264 metadata or need to edit headers without full re-encoding, consider tools that preserve existing streams. However, since overlays require compositing, re-encoding is usually mandatory. Understanding how to edit video h.264 metadata without encode can help optimize your workflow for other parts of your pipeline, such as fixing container issues after the overlay process. Refer to Edit video h.264 metadata without encode for insights on preserving stream integrity where possible. Always test your commands on short segments first. Complex filter graphs can be sensitive to input formats. Ensure your overlay PNG is not excessively large, as this increases processing time. Use -vf or -filter_complex appropriately; -filter_complex is required when connecting multiple inputs or outputs.

Frequently Asked Questions

Why is my overlay showing a black background instead of transparency?

Your PNG likely lacks an alpha channel. Re-save the image with transparency enabled. If converting from another format, ensure the output codec supports alpha, such as PNG or ProRes 4444.

Can I fade the main video while keeping the overlay static?

Yes. Apply the fade filter only to the main video stream [0:v] in your filter graph, while passing the overlay [1:v] directly to the overlay filter without modification.

How do I handle audio when adding overlays?

By default, FFmpeg copies the audio stream from the first input. If you need to mix audio from multiple sources, use the amix filter in addition to your video filters.

What causes "No sound" errors after encoding?

This often happens if the audio codec is incompatible with the output container or if the audio stream was dropped during filtering. Check your output format compatibility and ensure audio is not muted in the filter chain.

Is there a way to speed up overlay rendering?

Use hardware acceleration flags like -hwaccel cuda if supported by your GPU. Also, ensure your overlay images are resized to match the video resolution before processing to reduce memory bandwidth usage.