Use the concat demuxer with a text file listing your image and video inputs to join them without reencoding. This method preserves the original video quality and completes instantly because it only remuxes the streams rather than decoding and encoding the data again.
Why Reencoding Is Unnecessary
Many users attempt to use the standard concat filter or complex filter graphs when they simply want to append an image to a video. These methods force FFmpeg to decode the video frames, process them, and then reencode them into a new container. This process is computationally expensive, time-consuming, and results in generational loss of quality.
The goal here is stream copying. By using the concat demuxer protocol, we instruct FFmpeg to treat the input list as a single logical stream. It reads the headers, verifies compatibility, and writes the output file by copying the existing packets directly. This operation is nearly instantaneous regardless of the video length, provided the codecs and resolutions match.
Preparing the Input List
The foundation of this technique is a plain text file that tells FFmpeg the order and duration of each input. Create a file named input.txt in the same directory as your media files. The syntax must be strictly followed for the demuxer to parse it correctly.
Each line in the file represents one input source. You must specify the file path using the file directive. Crucially, you must also define the duration for every entry. Since images are static, you must tell FFmpeg how many seconds the image should appear on screen before transitioning to the video.
file 'image.png'
duration 5.0
file 'video.mp4'In this example, the image will display for five seconds, followed immediately by the full video. Ensure there are no extra spaces after the duration value and that the paths are relative to the location of the text file. If your files contain spaces, enclose the entire path in single quotes as shown above.
Executing the Command
Once the input list is ready, run the following command in your terminal. This command utilizes the -f concat flag to specify the format, points to the text file with -i, and uses -c copy to ensure no reencoding occurs.
ffmpeg -f concat -safe 0 -i input.txt -c copy output.mp4The -safe 0 option is often required if you use absolute paths or paths containing special characters, though it is best practice to keep files in the current directory to avoid security warnings from FFmpeg. The -c copy flag is the most critical part; it explicitly tells FFmpeg to copy audio and video streams without touching the codec.
If you encounter errors regarding incompatible formats, check the technical specifications of your image and video. The video container (e.g., MP4) and codec (e.g., H.264) must be compatible with the output container. For instance, you cannot easily concatenate a PNG directly into an MPEG-TS stream without transcoding due to container limitations. Stick to MP4 or MKV containers for maximum compatibility.
Handling Audio Streams
A common complication arises when the image has no audio track but the video does. In such cases, the concat demuxer may fail because it expects all inputs to have matching stream counts. To solve this, you can create a silent audio track for the image or use a more complex filter graph.
However, a simpler workaround for tech support scenarios is to ensure the image file itself contains a silent audio track if possible, or to accept that pure demuxing might not work for mixed media types. If the image is truly silent and the video has audio, you might need to use the amovie source filter or convert the image to a short video clip with silence first. But for pure video concatenation, the text file method remains the fastest solution.
If you face issues with seeking in the final output, particularly in web browsers, refer to our guide on FFmpeg Outputted Videos Not Seekable in Chrome & Edge: A Solution. Properly handling metadata and keyframes during the copy process ensures smooth playback across different players.
Troubleshooting Common Errors
If FFmpeg reports an invalid signature, verify that your image file is not corrupted. Sometimes, downloading images from certain sources can result in malformed headers. Check the file integrity before adding it to the list. For specific PNG-related signature errors, consult Invalid PNG signature FFmpeg Error: How to Fix It.
Another frequent issue is the command hanging or not exiting properly. If the process seems stuck, check for infinite loops in your script execution. Ensure you are not running the command in a way that causes FFmpeg to wait for additional input. See How to Send Multi Video in UDP Protocol with Single IP/Port? for related network streaming stability tips, although this specific issue is usually local.
Frequently Asked Questions
Can I concatenate multiple videos together using this method?
Yes, you can list any number of video files in the input.txt file. Just ensure each entry has a specified duration if they are images, or omit the duration for standard continuous video clips if you want them to play back-to-back seamlessly.
What happens if my image resolution differs from the video?
The concat demuxer requires identical resolution and codec parameters. If the sizes differ, FFmpeg will throw an error. You must resize the image to match the video dimensions using a separate command before creating the input list.
Does this method preserve subtitles?
If the subtitle streams are present in both the image placeholder (if treated as a video) and the main video, and they share the same codec, they will be copied. However, since images typically lack subtitle tracks, this method is primarily for visual concatenation.
Is the output file size larger than the original video?
No, the output file size will be slightly larger than the sum of the inputs due to container overhead, but it will not grow significantly like it would with reencoding. It essentially adds the size of the image file (converted to video frames) to the video size.
Why did my video become unseekable after concatenation?
This often happens if the keyframe intervals are not aligned or if the container metadata is not written correctly. Using the -movflags +faststart flag for MP4 outputs can help ensure proper indexing for web playback.