TimecodeTool span

Get duration information spanning two timecodes.

Synopsis

Get duration information spanning two timecodes. Returns durations in frames, seconds, time, and more.

TimecodeTool span [flags] [First Timecode] [Last Timecode]

Options

  -e, --exclude-last-timecode   Makes the last timecode EXCLUSIVE (industry standard behavior).
                                
                                WITHOUT -e (default): Spans are INCLUSIVE of both endpoints.
                                  Example at 24fps: "00:00:00:00" to "00:00:01:00"
                                    Result: 25 frames (1.042 seconds) - includes frames 0-24
                                
                                WITH -e: Spans are EXCLUSIVE of the last timecode.
                                  Example at 24fps: "00:00:00:00" to "00:00:01:00"
                                    Result: 24 frames (1.000 seconds) - includes frames 0-23, excludes 24
                                    This matches Adobe Premiere, Final Cut Pro, and other NLEs.
      --fps float               Frame rate of timecodes (default 29.97)
  -h, --help                    help for span
      --json-output             Output as JSON
      --key string              Specifies the key of which the sole value will be returned.
      --pretty-print            Output indented JSON

SEE ALSO

Auto generated by spf13/cobra on 13-Dec-2025