Doing a crossfade between two pieces of video content is actually quite complicated in FFmpeg. There is no “crossfade” filter like there is for audio.

What’s an efficient way to do it?

  • This answer needs to get a LOT more upvotes... Mark, I would so love you forever if you added cross-fading for the audio too...
    – Merc
    Dec 15, 2015 at 5:06
  • As soon as I figure out how, I'll add it. I think audio crossfade is snap, tho', do believe that there's a simple filter for it. Dec 15, 2015 at 20:08
  • 2
    I simply added [0:a][1:a] acrossfade=d=1 [audio] to the filter and then -map "[audio]" to the command and it worked. If you like, give it a test and update the answer!
    – Merc
    Dec 15, 2015 at 23:37
  • 1
    Possible duplicate of crossfade between 2 videos using ffmpeg Jan 1, 2018 at 6:33
  • I like the answer given here far more than the answers at the question for which I marked this a duplicate. Jan 1, 2018 at 6:34

2 Answers 2


TL;DR version:

This example performs video only, assuming both video clips are the same resolution, frame rate, etc. This will create a 1-second fade in between fadeoutclip and fadeinclip. Assume that fadeoutclip is 10 seconds long. Note that this is formatted for clarity: it's really one line of code.

ffmpeg -i fadeoutclip.mp4 -i fadeinclip.mp4 -an \
-filter_complex "\
    [0:v]trim=start=0:end=9,setpts=PTS-STARTPTS[firstclip]; \
    [1:v]trim=start=1,setpts=PTS-STARTPTS[secondclip]; \
    [0:v]trim=start=9:end=10,setpts=PTS-STARTPTS[fadeoutsrc]; \
    [1:v]trim=start=0:end=1,setpts=PTS-STARTPTS[fadeinsrc]; \
    [fadeinsrc]format=pix_fmts=yuva420p, \
                fade=t=in:st=0:d=1:alpha=1[fadein]; \
    [fadeoutsrc]format=pix_fmts=yuva420p, \
                fade=t=out:st=0:d=1:alpha=1[fadeout]; \
    [fadein]fifo[fadeinfifo]; \
    [fadeout]fifo[fadeoutfifo]; \
    [fadeoutfifo][fadeinfifo]overlay[crossfade]; \
    [firstclip][crossfade][secondclip]concat=n=3[output] \
    " \
-map "[output]" <add in encoding part here>

Full Version:

Here is an explanation of what this was all about:

Input Specification...obvious

ffmpeg -i fadeoutclip.mp4 -i fadeinclip.mp4 -an

Creating a filter_complex: assuming you already understand filter complexes:


First we break the two streams into two pieces each using the trim filter: the content and the cross fade section. The fade out is broken into content and fade section, while the fade in is cut into the fade section and content. Total of four sections.

Note that strictly speaking, we don't have to break the cross fade sections out: we COULD just specify the fade out and fade in times for the two video clips. However, by doing this, we:

Each of these four sections specifies: start time (seconds), end time (seconds), and the mysterious setpts=PTS-STARTPTS filter, which essentially makes each video subclip start at 0 seconds. This will be vital when re-compositing them.

Note that the s=0 specifiers are redundant, and the setpts filter for the s=0 ones is ALSO redundant. However, both are specified redundantly to allow the start time change from 0, without breaking the filter complex. Also, the second content clip runs to the end, so the e= part (end=) is not specified.


Next, we specify the fade in and fade out: We first add an alpha (transparency) channel to both fade sections by specifying a pixel format of yuva420p. You can actually use any format that provides an alpha channel.

Next in this filter subcomplex we specify one to fade out, and one to fade in. The alpha=1 means that the video itself will not darken, only the transparency amount will "fade". st means start, d means duration.


What is this?: The fifo filter ensures that there is buffer space available in the filter complex. Amazingly, this is NOT the default. If you don't do this, the crossfade could fail if the output of the stage above overruns the overlay filter below. Yeah, I know what you're thinking right now. It is indeed an FFMPEG bug.


Now, overlay the two fade sections: By making sure the two crossfade sections are the same size, we don't have to worry about the rather nasty options the overlay filter takes (and so we ignore them here):


Finally, we line up our three segments using the concat filter.


And now, map the output pad as your video source.

DO NOT FORGET to set the pixel format TO WHAT YOU NORMALLY USE (typically yuv420p), as the crossfade section will have set it to yuv420 on the output channel! (as we didn't specify it, you can using the overlay arguments) Of course, if you WANT yuv420, then you're fine :-)

-map "[output]" <add your normal encoding part here>

You can then recombine audio in later (outside of the scope of this Q&A)

  • 1
    In the latest ffmpeg, it needs to be trim=start=0:end=9, (rather than trim=st=0:e=9,..
    – Merc
    Dec 15, 2015 at 4:44
  • 1
    But seriously, this is gonna have to be the best answer on FFMPEG I have ever seen, and the clearest ffmpeg explanation ever.
    – Merc
    Dec 15, 2015 at 5:37
  • Man, that's going to go to my head :-) Thanks for the props!!!! Dec 15, 2015 at 20:04
  • No worries. Please update the answer especially with =trim=start=0 as right now it doesn't work with the latest ffmpeg
    – Merc
    Dec 16, 2015 at 0:16
  • 1
    FFmpeg has an xfade filter now, see my answer here: superuser.com/a/1628904/48078
    – slhck
    Feb 25, 2021 at 9:12

FFmpeg now has an xfade (crossfade) filter.

You can use this on two inputs via a complex filterchain:

ffmpeg -i input1.mp4 -i input2.mp4 \
  -filter_complex "[0:v][1:v]xfade=transition=fade:duration=1:offset=2.5" \

Here, the videos will be concatenated, and after 2.5 seconds (offset=2.5) the first one will fade over to the second one, with a fade duration of one second (duration=1).

You can see examples of what crossfades are available on the FFmpeg wiki.

  • 1
    When trying a command identical to this I get the following error: Error while filtering: Cannot allocate memory... Failed to inject frame into filter network: Cannot allocate memory. I'm using a build compiled from the latest version of FFmpeg. Any idea what could be wrong here? Feb 26, 2021 at 18:31
  • @HashimAziz No idea, I would try with a recent stable build (v4.3.2 at the time of writing) and if it works there, you could file a bug report (ffmpeg.org/bugreports.html).
    – slhck
    Feb 26, 2021 at 18:42
  • YAY! Wonderful that they have it! That's so much better that the pipe-o-rama I had to put together! Mar 3, 2021 at 0:37
  • How to do this when the input is a list of images of arbitrary count?
    – jjxtra
    Feb 18, 2023 at 15:51
  • @jjxtra In that case you'd normally write a script to assemble the ffmpeg input dynamically. There are a few slideshow generator scripts out there that basically do this, e.g. github.com/tanersener/ffmpeg-video-slideshow-scripts
    – slhck
    Feb 19, 2023 at 13:32

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .