aboutsummaryrefslogtreecommitdiff
path: root/cmd/mp4probe
diff options
context:
space:
mode:
authorOnur Gündüz <ogunduz@gmail.com>2026-06-30 19:07:31 +0200
committerOnur Gündüz <ogunduz@gmail.com>2026-06-30 19:07:31 +0200
commitc558ed2d88dea290733dd0cffec22c558de624da (patch)
tree875e877cb3effe5495fc5091f43c528406aea165 /cmd/mp4probe
parent3ed2eb8ab30f9aff95c2a6d062362284852d43db (diff)
downloadmp4-c558ed2d88dea290733dd0cffec22c558de624da.tar.gz
mp4-c558ed2d88dea290733dd0cffec22c558de624da.zip
cmd: add mp4probe tool
Diffstat (limited to 'cmd/mp4probe')
-rw-r--r--cmd/mp4probe/README.md59
-rw-r--r--cmd/mp4probe/main.go97
2 files changed, 156 insertions, 0 deletions
diff --git a/cmd/mp4probe/README.md b/cmd/mp4probe/README.md
new file mode 100644
index 0000000..7c41fdf
--- /dev/null
+++ b/cmd/mp4probe/README.md
@@ -0,0 +1,59 @@
+# mp4probe
+
+Command `mp4probe` gathers information about tracks and keyframe distribution from an MP4 file.
+
+## Usage
+
+```
+mp4probe <file.mp4>
+```
+
+Sample output:
+
+```
+Track 0: avc1.640028
+ Total samples: 720
+ Duration: 30.00s
+ TimeScale: 12288
+
+ Keyframes:
+ [ 0] 0.083s
+ [ 250] 10.500s (10.417s since last)
+ [ 285] 11.958s (1.458s since last)
+ [ 378] 15.833s (3.875s since last)
+ [ 553] 23.125s (7.292s since last)
+
+ Total keyframes: 5
+ Keyframe interval: avg=5.760s min=1.458s max=10.417s
+
+Track 1: mp4a.40.2
+ Total samples: 1408
+ Duration: 30.02s
+ TimeScale: 48000
+
+ Keyframes:
+ [ 0] 0.000s
+ [ 1] 0.021s (0.021s since last)
+ [ 2] 0.043s (0.021s since last)
+ [ 3] 0.064s (0.021s since last)
+ [ 4] 0.085s (0.021s since last)
+ [ 5] 0.107s (0.021s since last)
+ [ 6] 0.128s (0.021s since last)
+ [ 7] 0.149s (0.021s since last)
+ [ 8] 0.171s (0.021s since last)
+ [ 9] 0.192s (0.021s since last)
+ [ 10] 0.213s (0.021s since last)
+ [ 11] 0.235s (0.021s since last)
+ [ 12] 0.256s (0.021s since last)
+ [ 13] 0.277s (0.021s since last)
+ [ 14] 0.299s (0.021s since last)
+ [ 15] 0.320s (0.021s since last)
+ [ 16] 0.341s (0.021s since last)
+ [ 17] 0.363s (0.021s since last)
+ [ 18] 0.384s (0.021s since last)
+ [ 19] 0.405s (0.021s since last)
+ ... (1388 more keyframes)
+
+ Total keyframes: 1408
+ Keyframe interval: avg=0.021s min=0.021s max=0.021s
+```
diff --git a/cmd/mp4probe/main.go b/cmd/mp4probe/main.go
new file mode 100644
index 0000000..3681a1d
--- /dev/null
+++ b/cmd/mp4probe/main.go
@@ -0,0 +1,97 @@
+// Command mp4probe displays information about MP4 tracks and keyframes.
+package main
+
+import (
+ "fmt"
+ "io"
+ "os"
+
+ "github.com/tetsuo/mp4/fragment"
+ "github.com/tetsuo/mp4/track"
+)
+
+func main() {
+ if len(os.Args) < 2 {
+ fmt.Fprintf(os.Stderr, "usage: %s <file.mp4>\n", os.Args[0])
+ os.Exit(1)
+ }
+
+ f, err := os.Open(os.Args[1])
+ if err != nil {
+ fmt.Fprintf(os.Stderr, "error: %v\n", err)
+ os.Exit(1)
+ }
+ defer f.Close()
+
+ fr, initSeg, err := fragment.NewReader(f)
+ if err != nil {
+ fmt.Fprintf(os.Stderr, "error: %v\n", err)
+ os.Exit(1)
+ }
+
+ fmt.Printf("Tracks: %d\n", len(initSeg.Tracks))
+ for _, t := range initSeg.Tracks {
+ kind := "video"
+ if t.Kind == track.TrackAudio {
+ kind = "audio"
+ }
+ fmt.Printf("\n%s Track (ID=%d):\n", kind, t.ID)
+ fmt.Printf(" Codec: %s\n", t.Codec())
+ fmt.Printf(" Timescale: %d\n", t.TimeScale)
+ seconds := 0.0
+ if t.TimeScale > 0 {
+ seconds = float64(t.Duration) / float64(t.TimeScale)
+ }
+ fmt.Printf(" Duration: %d ticks (%.2fs)\n", t.Duration, seconds)
+
+ if t.Kind == track.TrackVideo {
+ fmt.Printf(" Resolution: %dx%d\n", t.Width, t.Height)
+ } else {
+ fmt.Printf(" Channels: %d\n", t.ChannelCount)
+ fmt.Printf(" Sample Rate: %d\n", t.SampleRate)
+ }
+ }
+
+ // Read and analyze fragments
+ fmt.Printf("\nFragments:\n")
+ fragCount := 0
+ totalSamples := 0
+ totalVideoSync := 0
+
+ for {
+ fr, err := fr.ReadFragment()
+ if err == io.EOF {
+ break
+ }
+ if err != nil {
+ fmt.Fprintf(os.Stderr, "error: %v\n", err)
+ os.Exit(1)
+ }
+
+ videoSamples := 0
+ audioSamples := 0
+ syncSamples := 0
+
+ for _, s := range fr.Samples {
+ t := track.FindTrack(initSeg.Tracks, s.TrackID)
+ if t != nil && t.Kind == track.TrackVideo {
+ videoSamples++
+ if s.IsSync() {
+ syncSamples++
+ }
+ } else {
+ audioSamples++
+ }
+ }
+
+ fmt.Printf(" Fragment %d: %d video (%d sync), %d audio\n",
+ fr.SequenceNum, videoSamples, syncSamples, audioSamples)
+
+ fragCount++
+ totalSamples += len(fr.Samples)
+ totalVideoSync += syncSamples
+ }
+
+ fmt.Printf("\nSummary: %d fragments, %d samples, %d video keyframes\n",
+ fragCount, totalSamples, totalVideoSync)
+}