How do I fix: 🔍 Why This Happens?

The primary reason for this error is that the '-map' option in FFmpeg requires a one-to-one mapping between input streams and output streams. When no '-map' option is specified, FFmpeg automatically maps all input streams to the output stream. However, when a '-map' option is used with no output str

How do I fix: Using the '-async 1' option?

Step 1: Another way to resolve this issue is by using the '-async 1' option with FFmpeg. This option allows you to specify that only one audio stream should be processed at a time.Step 2: By setting '-async 1', you can ensure that only one audio stream is converted, which prevents the 'Number of str

Software⏱️ 3 min read📅 2026-06-19

How to Fix: FFmpeg -map 0 fails with error "Number of stream maps must match number of output streams"

Q: Step-by-Step Verified Fixes Using the '-map' option without specifying any stream?

Step 1: To resolve this issue, you can remove the '-map 0' option from your FFmpeg command. This will allow FFmpeg to automatically map all input streams to the output stream.Step 2: Alternatively, you can specify a specific stream number in the '-map' option to ensure that only certain streams are

FFmpeg error fixing and stream mapping explanation.

Quick Answer: Use -map 0:0 for video, -map 1:v:all,1:a:all for subtitles and audio streams.

📋 Table of Contents

🔍 Why This Happens
🛠️ Step-by-Step Verified Fixes
✨ Wrapping Up

The 'Number of stream maps must match number of output streams' error occurs when using FFmpeg to convert video files while copying certain audio and subtitle streams. This issue affects users who are trying to convert MKV files with multiple audio and subtitle streams to other formats.

This error is frustrating because it prevents the conversion process from completing, leaving the user with an incomplete file. Fortunately, there are ways to resolve this issue using FFmpeg.

🔍 Why This Happens

The primary reason for this error is that the '-map' option in FFmpeg requires a one-to-one mapping between input streams and output streams. When no '-map' option is specified, FFmpeg automatically maps all input streams to the output stream. However, when a '-map' option is used with no output streams specified, FFmpeg throws an error.
An alternative reason for this error could be due to the presence of multiple subtitle streams in the input file that are not being mapped or copied correctly.

🛠️ Step-by-Step Verified Fixes

Using the '-map' option without specifying any stream

Step 1: To resolve this issue, you can remove the '-map 0' option from your FFmpeg command. This will allow FFmpeg to automatically map all input streams to the output stream.
Step 2: Alternatively, you can specify a specific stream number in the '-map' option to ensure that only certain streams are mapped or copied.
Step 3: For example, if you want to copy all video and subtitle streams but convert all audio streams to AC3, you would use the following command: ffmpeg -i input.mkv -map 0:1-2 -vcodec copy -scodec copy -acodec ac3 -ab 256k output.mkv

Using the '-async 1' option

Step 1: Another way to resolve this issue is by using the '-async 1' option with FFmpeg. This option allows you to specify that only one audio stream should be processed at a time.
Step 2: By setting '-async 1', you can ensure that only one audio stream is converted, which prevents the 'Number of stream maps must match number of output streams' error.

✨ Wrapping Up

To resolve the 'Number of stream maps must match number of output streams' error in FFmpeg, you can either remove the '-map 0' option and specify a specific stream number or use the '-async 1' option to process one audio stream at a time. By following these steps, you should be able to successfully convert your MKV file with multiple audio and subtitle streams.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions

🛠️ Related Fixes

How to Fix: Pc crashes shortly after launching game (rainbow

Fix Pc crashes shortly after launching game (rainbow six siege). Compl

How to Fix: Installing an APK on a locked down phone

Installing an APK on a locked down phone: Try using a rooted device, e

How to Fix: New PC build- no signal and no clue

Fix New PC build- no signal and no clue. Complete troubleshooting guid