RAWcooked(1) Bit-by-bit fidelity RAWcooked(1)

NAME

RAWcooked - encode and decode audio-visual RAW data with Matroska, FFV1 and FLAC

SYNOPSIS

rawcooked [option ...] (folder | file ...) [option ...]

DESCRIPTION

RAWcooked encodes audio-visual RAW data into the Matroska container (MKV), using the video codec FFV1 for the image and the audio codec FLAC for the sound. The metadata accompanying the RAW data are preserved, and sidecar files, like MD5, LUT or XML, can be added into the Matroska container as attachments. This allows for the management of these audio-visual file formats in an effective and transparent way (e.g. native playback in VLC), while saving typically between one to two thirds of the needed storage, and speeding up file writing and reading (e.g. to/from harddisk, over network or for backup on LTO).
When needed, the uncompressed source is retrieved bit-by-bit, in a manner faster than uncompressed sources.
folder
Encodes with the FFV1 video codec all single-image video files in the folder, encodes with the FLAC audio codec all audio files in the folder, and muxes these into a Matroska container (.mkv).
The filenames of the single image files must end with a numbered sequence. RAWcooked will generate the regex to parse in the correct order all the frames in the folder.
file
contains RAW data (e.g. a .dpx or .wav file):
Encodes with the FFV1 video codec all single-image video files in the folder containing the file, encodes with the FLAC audio codec all audio files in the folder containing the file, and muxes these into a Matroska container (.mkv).
The filenames usually end with a numbered sequence. Enter one frame and the tool will generate the regex to parse all the frames in the folder.
file
is a Matroska container (.mkv):
Decodes back the video and the audio of file to its original formats. All metadata accompanying the original data are preserved bit-by-bit.

OPTIONS

GENERAL OPTIONS

--help | -h
Displays a help message.
--version
Displays the installed version.
--attachment-max-size value | -s value
Set maximum size of attachment to value (in bytes).
Default value is 1048576.
--check value
Do or don't do costly (in terms of analysis duration or bytes read) checks.
partial (or 0) is quicker but may lead to partial reversibility with non conform files.
full (or 1) is slower but guaranties reversability with e.g. DPX files with non zero padding bits.
Default value is 'partial'.
--display-command | -d
When an external encoder/decoder is used, display the command to launch instead of launching it.
--output-name value | -o value
Set the name of the output file or folder to value.
Default value is ${Input}.mkv (if input is a folder) or ${Input}.RAWcooked (if input is a file).
--rawcooked-file-name value | -r value
Set (encoding) or get (decoding) the name of the RAWcooked reversibility data file to value.
Default name is ${Input}.rawcooked_reversibility_data
Note: If the RAWcooked reversibility data file is included in the output A/V file during the encoding, this file is deleted after encoding.
Note: Not yet implemented for decoding.
--quiet
Do not show information related to RAWcooked.
External encoder/decoder may need an additional option.
--file
Unlock compression of files (e.g. a .dpx or .wav).
-framerate value
Force video frame rate to value.
Default value is the one found in the image files if available, otherwise 24.
-c:a value
Force the audio encoding format to value: copy (copy PCM to PCM, without modification), flac.
Default value is flac.
-c:v value
Force the video encoding format value: only ffv1 is currently allowed.
Default value is ffv1.
-coder value
If video encoding format is ffv1, set the coder to value: 0 (Golomb-Rice), 1 (Range Coder), 2 (Range Coder with custom state transition table).
Default value is 1.
-context value
If video encoding format is ffv1, set the context to value: 0 (small), 1 (large).
Default value is 0.
-format value
Set the container format to value: only matroska is currently allowed.
Default value is matroska.
-g value
If video encoding format is ffv1, set the GOP size to value any integer >=1.
Default value is 1.
-level value
If video encoding format is ffv1, set the version to value: 0, 1, 3.
Default value is 3.
-slicecrc value
If video encoding format is ffv1, set the CRC to value: 0 (CRC not present), 1 (CRC present).
Default value is 1.
-slices value
If video encoding format is ffv1, set the count of slices to value: any integer >=1 and making sense (2, 4, 6, 9, 16, 24...).
Default value is between 16 and 512, depending on video frame size and depth.

COPYRIGHT

Copyright (c) 2018 MediaArea.net SARL & AV Preservation by reto.ch

LICENSE

RAWcooked is released under a BSD License.

DISCLAIMER

RAWcooked is provided "as is" without warranty or support of any kind.

18.09 https://MediaArea.net/RAWcooked RAWcooked(1)