Chapter Metadata Builder

Add fractional chapter starts to an MP4

Use the timestamps from your edit and the finished media duration. Each chapter runs until the next start, and the last chapter runs until the duration you enter.

Open Chapter Metadata Builder

End the opening at 24.475 seconds

Input

00:00 Opening scene
00:24.475 Meet the team

Media duration: 01:40.250

Output

;FFMETADATA1

[CHAPTER]
TIMEBASE=1/1000
START=0
END=24475
title=Opening scene

[CHAPTER]
TIMEBASE=1/1000
START=24475
END=100250
title=Meet the team

Enter the first two lines as chapter text and put 01:40.250 in Media duration. The millisecond time base lets START and END remain integers while retaining the fraction of a second.

Check the result

  1. Download chapters.ffmeta. For a matching input.mp4, run the FFmpeg command shown below the download.
  2. Open chaptered.mp4 in VLC and choose Playback > Chapter > Meet the team. For a numeric check, run ffprobe -v error -show_chapters chaptered.mp4 and confirm the second start time of 24.475000.

Common problems

Map the chapter input explicitly

If input.mp4 already has chapters, a command that maps only descriptive metadata can keep the old chapter table. Use -map_chapters 1 with chapters.ffmeta as the second input.

Use a container that carries chapters

Write MP4 for MP4-compatible streams or choose MKV for a wider range of streams. Some containers and players do not expose chapters. Check the resulting file with FFprobe as well as your player.

Using Chapter Metadata Builder

Enter chapter times

Use one line per chapter with a title after the time. Set the media duration for the last chapter. You can also open an existing FFmetadata text file.

Check each interval

The preview shows the exact start and end that will be written in milliseconds.

Map the chapter file

Download FFmetadata. Run the MP4 command in the result or use -map_chapters 1 in your FFmpeg workflow with the chapter file as the second input.

Offline use

Open the tool once online and let it finish loading. Use the install option in your browser or Add to Home Screen on iPhone. Reopen the tool to process a new input offline.

References