Tool for different operations on FLV files. Initially created to replace extremely slow flvtool2 -U.
Update metadata keyframes records:
$ ls -l in.flv
-rw-r--r-- 1 root root 398312988 2012-11-06 10:58 in.flv
$ time flvsak -in in.flv -out out.flv -update-keyframes
real 0m1.803s
user 0m0.640s
sys 0m1.170s
$ time flvtool2 -U in.flv
real 8m37.501s
user 8m32.050s
sys 0m4.900s
Add following values to metadata:
- audiocodecid
- audiodatarate
- audiodelay
- audiosamplerate
- audiosamplesize
- audiosize
- canSeekToEnd
- cuePoints
- duration
- framerate
- hasAudio
- hasCuePoints
- hasKeyframes
- hasVideo
- height
- lastkeyframetimestamp
- lasttimestamp
- stereo
- videocodecid
- videodatarate
- videosize
- width
Following records are recalculated after building first metadata tag:
- datasize
- filesize
- hasMetadata
- keyframes
Example of metadata:
[<<"onMetaData">>,
[
* {<<"width">>,960.0},
* {<<"filesize">>,458356236.0},
* {<<"lasttimestamp">>,6610.245},
* {<<"lastkeyframetimestamp">>,6609.445},
* {<<"metadatacreator">>,<<"inlet media FLVTool2 v1.0.6 - http://www.inlet-media.de/flvtool2">>},
* {<<"hasKeyframes">>,true},
* {<<"audiodatarate">>,48.082306177758916},
* {<<"videosize">>,414403791.0},
* {<<"canSeekToEnd">>,false},
* {<<"videocodecid">>,4.0},
* {<<"audiocodecid">>,2.0},
* {<<"videodatarate">>,500.20897803334066},
* {<<"height">>,720.0},
* {<<"datasize">>,456947343.0},
* {<<"hasAudio">>,true},
* {<<"framerate">>,14.0},
* {<<"audiosamplesize">>,16.0},
* {<<"metadatadate">>,{date,1351681379738.907}},
* {<<"hasCuePoints">>,false},
* {<<"cuePoints">>,[]},
* {<<"duration">>,6610.312},
* {<<"hasVideo">>,true},
* {<<"audiosamplerate">>,2.2e4},
* {<<"stereo">>,true},
* {<<"keyframes">>,
{object,[{times,[0.0,4.0, ...]},
{filepositions,[30463.0,287756.0, ...]}]}},
* {<<"audiodelay">>,0.0},
* {<<"audiosize">>,42513072.0},
* {<<"hasMetadata">>,true}
]]
lastkeyframetimestamp = 6609.44482421875
audiodatarate = 48.081443786621094
videocodecid = 4
audiodelay = 0
width = 960
metadatacreator = FlvSAK https://github.com/metachord/flvsak
hasVideo = true
audiosize = 4.2513072e+07
canSeekToEnd = false
duration = 6610.36376953125
videosize = 4.14403791e+08
hasKeyframes = true
filesize = 4.58356236e+08
audiosamplesize = 16
lasttimestamp = 6610.2451171875
metadatadate = {0 1.352184840548653e+12}
height = 720
framerate = 14
keyframes = 0xf840049658
stereo = true
cuePoints = &[]
datasize = 4.56947343e+08
audiocodecid = 2
hasMetadata = true
hasCuePoints = false
audiosamplerate = 22050
hasAudio = true
videodatarate = 500.20001220703125
All metadata in alphabetically order:
$ flvsak -in in_file.flv -info
audiocodecid: 2
audiodatarate: 44.8125
audiodelay: 0
audiosamplerate: 22000
audiosamplesize: 16
audiosize: 4.2513072e+07
canSeekToEnd: false
cuePoints: &[]
datasize: 4.56947287e+08
duration: 7092.57080078125
filesize: 4.58356172e+08
framerate: 13
hasAudio: true
hasCuePoints: false
hasKeyframes: true
hasMetadata: true
hasVideo: true
height: 720
keyframes: 0xf840047348
lastkeyframetimestamp: 7091.72900390625
lasttimestamp: 7092.533203125
metadatacreator: FlvSAK https://github.com/metachord/flvsak
metadatadate: {0 1.354265321490319e+12}
stereo: true
videocodecid: 4
videodatarate: 466.1925964355469
videosize: 4.14403791e+08
width: 960
Specify list of keys from metadata:
$ flvsak -in in_file.flv -info -info-keys height,width,duration
height: 720
width: 960
duration: 7092.57080078125
Dump all frames info to stdout between min-dts and max-dts:
$ flvsak -in in_file.flv -dump -min-dts 6031657 -max-dts 7092449
The following command will split in_file.flv to two files: out.flv (contains only audio and video only for stream 0) and out-meta.flv (contains all metadata for all streams). Flag -fix-dts will fix non monotonically increasing DTS in input file.
$ flvsak -in in_file.flv -split-content -outc video:out.flv,audio:out.flv,meta:out-meta.flv -fix-dts -streams video:0,audio:0
Crop parts of file in specified ranges of DTS. Flag -crop-wait-keyframe will crop at nearest keyframe.
$ flvsak -in in_file.flv -out out_crop.flv -crop 1619000..1731000,2753000..2812000 -crop-wait-keyframe
If crop range is one number, frame with this DTS will be cropped.
To recover broken FLV-file, use flag -recover. On every broken frame reader will skip byte until valid. If option -max-frame-size specified frame with body greater than this value also broken.
$ ./flvsak/flvsak -in in_file.flv -split-content -outc video:out.flv,audio:out.flv,meta:out.flv -recover -max-frame-size 100000