untrunc で 壊れた video file を 修復

# はじめに

security cameraなどが保存するファイルが壊れている（再生できない）事があるかと思います。
通常、こういうカメラは同じようなファイルの作り方で生成しているので、他の再生可能なファイルをベースに再構築することで、再生できることがあります。

まさにそういう[ツール](https://github.com/ponchio/untrunc) を作ってくれている方がおりましたので、それを Mac OS X上で buildして実際にファイルを修復してみます。

# まずファイルの診断

```
$ ffmpeg -i corrupt.mp4
ffmpeg version 4.3.1 Copyright (c) 2000-2020 the FFmpeg developers
  built with Apple clang version 11.0.0 (clang-1100.0.33.17)
  configuration: --prefix=/usr/local/Cellar/ffmpeg/4.3.1_4 --enable-shared --enable-pthreads --enable-version3 --enable-avresample --cc=clang --host-cflags= --host-ldflags= --enable-ffplay --enable-gnutls --enable-gpl --enable-libaom --enable-libbluray --enable-libdav1d --enable-libmp3lame --enable-libopus --enable-librav1e --enable-librubberband --enable-libsnappy --enable-libsrt --enable-libtesseract --enable-libtheora --enable-libvidstab --enable-libvorbis --enable-libvpx --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxml2 --enable-libxvid --enable-lzma --enable-libfontconfig --enable-libfreetype --enable-frei0r --enable-libass --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-libopenjpeg --enable-librtmp --enable-libspeex --enable-libsoxr --enable-videotoolbox --disable-libjack --disable-indev=jack
  libavutil      56. 51.100 / 56. 51.100
  libavcodec     58. 91.100 / 58. 91.100
  libavformat    58. 45.100 / 58. 45.100
  libavdevice    58. 10.100 / 58. 10.100
  libavfilter     7. 85.100 /  7. 85.100
  libavresample   4.  0.  0 /  4.  0.  0
  libswscale      5.  7.100 /  5.  7.100
  libswresample   3.  7.100 /  3.  7.100
  libpostproc    55.  7.100 / 55.  7.100
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x7fbedf000a00] moov atom not found
corrupt.mp4: Invalid data found when processing input
```

このように、moovのatom (chunk)が見つからないというエラーがある壊れた(再生できない)ファイルがあります。

# まずはツールの準備

```
$ git clone https://github.com/ponchio/untrunc.git
$ brew install libav yasm nasm
$ wget https://libav.org/releases/libav-12.3.tar.xz
$ tar -xJf libav-12.3.tar.xz -C untrunc
$ cd untrunc/libav-12.3/
$ ./configure
$ make
$ cd ..
$ g++ -o untrunc file.cpp main.cpp track.cpp atom.cpp mp4.cpp -I./libav-12.3 -L./libav-12.3/libavformat -lavformat -L./libav-12.3/libavcodec -lavcodec -L./libav-12.3/libavresample -lavresample -L./libav-12.3/libavutil -lavutil -lpthread -lz -framework CoreFoundation -framework CoreVideo -framework VideoDecodeAcceleration -lbz2 -DOSX
```

# 実際に修復してみる

使い方は非常にかんたんで、正常に再生できるファイル 壊れたファイルの順で指定するだけです。
なお、同じカメラの同じ設定のものの再生可能なファイルを指定するのがコツのようです。

```
$ ./untrunc playable.mp4 corrupt.mp4 

..snip..

Length         : 1869
Ref idc        : 2
Nal type       : 1
First mb       : 0
Slice type     : 0
Pic parm set id: 0
Frame number   : 31
Field  pic flag: 1
Bottom pic flag: 1
Partial length : 1869

Buffer size exceeded (2983 > 2947).
Track 0 codec: mp4a
mp4a: Failure because of NULL header.
Track 1 codec: avc1
avc1: Match with 0 header.

Buffer size exceeded (2983 > 2947).
Found 14916 packets.

Saving to: corrupt.mp4_fixed.mp4
Track 0 (mp4a): duration: 6287360 timescale: 8000
Adjusting track duration to movie timescale: New duration: 785920000 timescale: 1000000.
Track 1 (avc1): duration: 699916000 timescale: 1000000
Adjusting track duration to movie timescale: New duration: 699916000 timescale: 1000000.
Movie duration: 785920000 timescale: 1000000
```

というわけで、再生してみると、再生できました！

(不審者がいたので、ぜひ監視カメラの映像を再生したかったのです。)


# 修復後のファイルをinspection

```
$ ffmpeg -i corrupt.mp4_fixed.mp4
ffmpeg version 4.3.1 Copyright (c) 2000-2020 the FFmpeg developers
  built with Apple clang version 11.0.0 (clang-1100.0.33.17)
  configuration: --prefix=/usr/local/Cellar/ffmpeg/4.3.1_4 --enable-shared --enable-pthreads --enable-version3 --enable-avresample --cc=clang --host-cflags= --host-ldflags= --enable-ffplay --enable-gnutls --enable-gpl --enable-libaom --enable-libbluray --enable-libdav1d --enable-libmp3lame --enable-libopus --enable-librav1e --enable-librubberband --enable-libsnappy --enable-libsrt --enable-libtesseract --enable-libtheora --enable-libvidstab --enable-libvorbis --enable-libvpx --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxml2 --enable-libxvid --enable-lzma --enable-libfontconfig --enable-libfreetype --enable-frei0r --enable-libass --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-libopenjpeg --enable-librtmp --enable-libspeex --enable-libsoxr --enable-videotoolbox --disable-libjack --disable-indev=jack
  libavutil      56. 51.100 / 56. 51.100
  libavcodec     58. 91.100 / 58. 91.100
  libavformat    58. 45.100 / 58. 45.100
  libavdevice    58. 10.100 / 58. 10.100
  libavfilter     7. 85.100 /  7. 85.100
  libavresample   4.  0.  0 /  4.  0.  0
  libswscale      5.  7.100 /  5.  7.100
  libswresample   3.  7.100 /  3.  7.100
  libpostproc    55.  7.100 / 55.  7.100
Input #0, mov,mp4,m4a,3gp,3g2,mj2, from 'corrupt.mp4_fixed.mp4':
  Metadata:
    major_brand     : mp42
    minor_version   : 0
    compatible_brands: avc1mp42isom
    creation_time   : 2020-12-21T09:45:21.000000Z
  Duration: 00:13:05.92, start: 0.000000, bitrate: 1319 kb/s
    Stream #0:0(eng): Video: h264 (Main) (avc1 / 0x31637661), yuv420p, 1920x1080, 1424 kb/s, 12.54 fps, 12 tbr, 1000k tbn, 24 tbc (default)
    Metadata:
      creation_time   : 2020-12-21T09:45:21.000000Z
      handler_name    : IP CENTCOM Media Handler
      encoder         : VC Coding
    Stream #0:1(eng): Audio: aac (LC) (mp4a / 0x6134706D), 8000 Hz, mono, fltp, 48 kb/s (default)
    Metadata:
      creation_time   : 2020-12-21T09:45:21.000000Z
      handler_name    : IP CENTCOM Media Handler
At least one output file must be specified
```

こんな感じで修復ができたようです。