mp4box

mp4box

mp4box-コマンド一覧 †

ここで使用したmp4box(ffmpegX0.0.9u版) †

$ mp4box -version
MP4Box - GPAC version 0.4.1-DEV
GPAC Copyright: (c) Jean Le Feuvre 2000-2005
               (c) ENST 2005-200X

性質

エンコード済みのストリーム（動画ファイルの成分）にMP4に適したヘッダを付けて.mp4コンテナに収める道具。
・.mp4コンテナ自体、AVIに比して極めて複雑。
・raw streamとヘッダが分離した構造になっている。QuickTimeは上手に隠しているが、mp4boxはわりと剥き身。
・規格外だがac3やmp3音声も可能な模様。

General Options: †

$ mp4box -h general

-inter time_in_ms? †

interleaves file data (track chunks of time_in_ms)

• * Note 1: Interleaving is 0.5s by default
• * Note 2: a value of 0 disables interleaving

-flat? †

stores file with all media data first, non-interleaved

-frag time_in_ms? †

fragments file (track fragments of time_in_ms)

• * Note: Always disables interleaving

-out filename? †

specifies output file name

• * Note: By default input (MP4,3GP) file is overwritten

-tmp dirname? †

specifies directory for temporary file creation

• * Note: Default temp dir is OS-dependent

-nosys? †

removes all MPEG-4 Systems info except IOD (profiles)

• * Note: Set by default whith '-add' and '-cat'

-isma? †

rewrites the file as an ISMA 1.0 AV file

-ismax? †

same as '-isma' and removes all clock references

-3gp? †

rewrites as 3GPP(2) file (no more MPEG-4 Systems Info)

• * Note 1: some tracks may be removed in the process
• * Note 2: always on for *.3gp *.3g2 *.3gpp

-brand ABCD †

sets major brand of file

-ab ABCD? †

adds given brand to file's alternate brand list

-rb ABCD? †

removes given brand from file's alternate brand list

-cprt string? †

adds copyright string to movie

-chap file? †

adds chapter information contained in file

-rem trackID:? †

removes track from file

-new:? †

forces creation of a new destination file
新規ファイルへの書き出しを強制

-lang [tkID=]LAN:? †

トラックの言語指定。"LAN"はISO 639-2 コードで指定 (eng, und)

-delay tkID=TIME:? †

トラックのスタートディレイ指定。単位ミリセカンド(ms)。

-split time_sec? †

splits in files of time_sec max duration

• * Note: this removes all MPEG-4 Systems media

-splits filesize? †

splits in files of max filesize kB.

• * Note: this removes all MPEG-4 Systems media

-splitx start:end? †

extracts a new file from start to end (in seconds)

• * Note: this removes all MPEG-4 Systems media

Hinting Options †

$ mp4box -h hint

-hint: †

hints the file for RTP/RTSP

-mtu size: †

specifies MTU size in bytes. Default size is 1500

-copy: †

copies media data to hint track rather than reference

• * Note: speeds up server but takes much more space

-tight: †

performs tight interleaving (sample based) of hinted file

• * Note: reduces server disk seek but increases file size

-multi [maxptime]: †

-multi [maxptime]:   enables frame concatenation in RTP packets if possible
       maxptime:     max packet duration in ms (optional, default 100ms)

-rate ck_rate: †

specifies rtp rate in Hz when no default for payload

• * Note: default value is 90000 (MPEG rtp rates)

-mpeg4: †

forces MPEG-4 generic payload whenever possible

-latm: †

forces MPG4-LATM transport for AAC streams

-static: †

enables static RTP payload IDs whenever possible

• * By default, dynamic payloads are always used

MPEG-4 Generic Payload Options †

-ocr: †

forces all streams to be synchronized

• * Most RTSP servers only support synchronized streams

-rap: †

signals random access points in RTP packets

-ts: †

signals AU Time Stamps in RTP packets

-size: †

signals AU size in RTP packets

-idx: †

signals AU sequence numbers in RTP packets

-iod: †

prevents systems tracks embedding in IOD

• * Note: shouldn't be used with -isma option

-sdp_ex string: †

adds sdp string to (hint) track ("-sdp_ex tkID:string") or movie. This will take care of SDP lines ordering

• * WARNING: You cannot add anything to SDP, cf rfc2327.

-unhint: †

removes all hinting information.

Importing Options；インポートオプション †

$ mp4box -h import

File importing syntax: †

• "#video" "#audio": base import for most AV files
  • 大半のAVファイルの基本的なインポート
• "#trackID=ID": track import for IsoMedia and other files
  • IsoMediaファイルなどからトラックをインポート
• ":dur=D": imports only the first D seconds
  • 最初のD秒間だけをインポート
• ":lang=LAN": sets imported media language code
  • 言語コードの指定
• ":delay=delay_ms": sets imported media initial delay in ms
  • 冒頭のディレイの指定。単位ミリセカンド。

-add file: †

add file tracks to (new) output file
（新規の）出力ファイルにファイルトラックを追加

-cat file: †

concatenates file samples to (new) output file
* Note: creates tracks if needed

ファイルサンプルを結合して（新規の）出力ファイルに書き出す。
* Note:必要な場合は新しくトラックを追加する。

-keepsys: †

keeps all MPEG-4 Systems info when using '-add' / 'cat'

'-add' / 'cat'を使った時に、MPEG-4 Systems infoを全部キープする。

以下のオプションはデフォルト、または各トラックごとに指定できる。 †

トラック毎に指定する場合、書式は

:opt

または、

:opt=val

-dref: †

keeps media data in original file

-nodrop: †

forces constant FPS when importing AVI video

AVIからvideoをインポートする際に固定FPSを強制する。

-packed: †

forces packed bitstream when importing raw ASP
raw ASPをインポートする際にpacked bitstreamを強制する。

※：packed bitstreamはAVIでBフレームを使う為のハッキングの一つ。複数フレームを１枚と偽ってデコーダバッファに進入させるもの。

-sbr: †

backward compatible signaling of AAC-SBR

-sbrx: †

non-backward compatible signaling of AAC-SBR

• * Note: SBR AAC cannot be detected at import time

-fps FPS: †

映像と字幕(sub)インポート時にフレームレートを強制。
デフォルトは

• raw H263：15
• その他：25

■参考
24000/1001fps

-fps 23.976025

30000/1001fps

-fps 29.970030

※float型での指定がより正確。手許（MEncoderで吐いたraw x264のmux）では、23.976指定は23.975fpsとなり一時間程度の実写で地味に口と台詞がずれる。本来は-fps 24000:1001でも良いようだが、24000:1001は24000fps（超はやおくり）になる。詳細はこちら参照。

-mpeg4: †

forces MPEG-4 sample descriptions when possible (3GPP2)

-agg N: †

aggregates N audio frames in 1 sample (3GP media only)

• * Note: Maximum value is 15 - Disabled by default

MPEG-4 Scene Encoding Options †

$ mp4box -h encode

-mp4: †

specify input file is for encoding.

-def: †

encode DEF names

-sync time_in_ms: †

forces BIFS sync sample generation every time_in_ms

* Note: cannot be used with -shadow

-shadow time_ms: †

forces BIFS sync shadow sample generation every time_ms.

* Note: cannot be used with -sync

-log: †

generates BIFS encoder log file

-ms file: †

specifies file for track importing

Chunk Processing †

-inctx file: †

specifies initial context (MP4/BT/XMT)

* Note: input file must be a commands-only file

-outctx: †

specifies storage of updated context (MP4/BT/XMT)

Meta handling Options †

$ mp4box -h meta

-set-meta args: †

sets given meta type - syntax: "ABCD[:tk=ID]"

* ABCD: four char meta type (NULL or 0 to remove meta)

* [:tk=ID]: if not set use root (file) meta
if ID is 0 use moov meta
if ID is not 0 use track meta

-add-item args: †

adds resource to meta

* syntax: file_path + options (':' separated):
tk=ID: meta adressing (file, moov, track)
name=str: item name
mime=mtype: item mime type
encoding=enctype: item content-encoding type

* file_path "this" or "self": item is the file itself

-rem-item args: †

removes resource from meta - syntax: item_ID[:tk=ID]

-set-primary args: †

sets item as primary for meta - syntax: item_ID[:tk=ID]

-set-xml args: †

sets meta XML data

* syntax: xml_file_path[:tk=ID][:binary]

-rem-xml [tk=ID]: †

removes meta XML data

-dump-xml args: †

dumps meta XML to file - syntax file_path[:tk=ID]

-dump-item args: †

dumps item to file - syntax item_ID[:tk=ID][:path=fileName]

Extracting Options †

$ mp4box -h extract

-raw TrackID: †

extracts track in raw format when supported

-raws TrackID: †

extract each track sample to a file

* Note: "TrackID:N" extracts Nth sample

-nhnt TrackID: †

extracts track in nhnt format

-single TrackID: †

extracts track to a new mp4 file

-avi TrackID: †

extracts visual track to an avi file

-qcp TrackID: †

same as '-raw' but defaults to QCP file for EVRC/SMV

-aviraw TK: †

extracts AVI track in raw format $TK can be one of "video" "audio" "audioN"

参考

x264+aac.aviを以下のようにすると、

$ mp4box -aviraw video /Volumes/XXX/XXX.avi 

h264 raw videoだけ抽出できた。

Extracting AVI video (format h264) to /Volumes/XXX/XXX_video.h264

以下はXXX_audio.rawを抽出するが、これはmp4boxでmuxできなかった。

$ mp4box -aviraw audio /Volumes/XXX/XXX.avi 

Dumping Options †

$ mp4box -h dump

-std: †

dumps to stdout instead of file

-info [trackID] †

prints movie info / track info if trackID specified

* Note: for non IsoMedia files, gets import options

-bt: †

scene to bt format - removes unknown MPEG4 nodes

-xmt: †

scene to XMT-A format - removes unknown MPEG4 nodes

-wrl: †

scene VRML format - removes unknown VRML nodes

-x3d: †

scene to X3D/XML format - removes unknown X3D nodes

-x3dv: †

scene to X3D/VRML format - removes unknown X3D nodes

-diso: †

scene IsoMedia file boxes in XML output

-drtp: †

rtp hint samples structure to XML output

-dts: †

prints sample timing to text output

-sdp: †

dumps SDP description of hinted file

-dcr: †

ISMACryp samples structure to XML output

-ttxt: †

Converts input subtitle to GPAC TTXT format

-ttxt TrackID: †

Dumps Text track to GPAC TTXT format

-srt: †

Converts input subtitle to SRT format

-srt TrackID: †

Dumps Text track to SRT format

-stat: †

generates node/field statistics for scene

-stats: †

generates node/field statistics per MPEG-4 Access Unit

-statx: †

generates node/field statistics for scene after each AU

SWF Importer Options †

$ mp4box -h swf

MP4Box can import simple Macromedia Flash files (".SWF")
You can specify a SWF input file with '-bt', 'xmt' and '-mp4' options

-static: †

all SWF defines are placed in first scene replace

* Note: By default SWF defines are sent when needed

-ctrl: †

uses a dedicated stream for movie control

* Note: Forces '-static'

-notext: †

removes all SWF text

-nofont: †

removes all embedded SWF Fonts (terminal fonts used)

-noline: †

removes all lines from SWF shapes

-nograd: †

removes all gradients from swf shapes

-quad: †

uses quadratic bezier curves instead of cubic ones

-xlp: †

support for lines transparency and scalability

-flatten ang: †

complementary angle below which 2 lines are merged

* Note: angle '0' means no flattening

ISMA Encryption/Decryption Options †

$ mp4box -h crypt

-crypt drm_file: †

crypts a specific track using ISMA AES CTR 128

-decrypt [drm_file] †

decrypts a specific track using ISMA AES CTR 128

* Note: drm_file can be omitted if keys are in file

-set-kms kms_uri †

changes KMS location for all tracks or a given one.

* to adress a track, use 'tkID=kms_uri'

DRM file syntax for GPAC ISMACryp: †

File is XML and shall start with xml header
File is a list of "ISMACrypTrack" elements (all at root)

ISMACrypTrack attributes are †

TrackID: ID of track to en/decrypt
key: AES-128 key formatted (hex string '0x'+32 chars)
salt: CTR IV salt key (64 bits) (hex string '0x'+16 chars)

Encryption only attributes: †

Scheme_URI: URI of scheme used
KMS_URI: URI of key management system

* Note: 'self' writes key and salt in the file
selectiveType: selective encryption type - understood values are:

"None": all samples encrypted (default)
"RAP": only encrypts random access units
"Non-RAP": only encrypts non-random access units
"Rand": random selection is performed
"X": Encrypts every first sample out of X (uint)
"RandX": Encrypts one random sample out of X (uint)

ipmpType: IPMP Signaling Type: None, IPMP, IPMPX
ipmpDescriptorID: IPMP_Descriptor ID to use if IPMP(X) is used

* If not set MP4Box will generate one for you

サポートするフォーマットと拡張子 †

mp4box -h format

Suppported raw formats and file extensions: †

※.m4vはraw formatsとして扱う事に注意。Appleが使うコンテナフォーマットとしての.m4vはオープンソース的には混乱を招いた。ISO/IEC規格外の可能性大。参考

Supported containers and file extensions: †

Supported text formats: †

Supported Scene formats: †

リンク †

• gpac公式：http://gpac.sourceforge.net/index.php
• フォーラム：https://sourceforge.net/forum/?group_id=84101

コメント †