git.sesse.net Git - casparcg/blob - build/html/_sources/tutorial/file-consumer.txt

   1 .. _tut-file:
   2
   3 *************************
   4 Running the File Consumer
   5 *************************
   6
   7 The disk consumer uses ffmpeg to encode video and ffmpeg users will feel somewhat at home with the commands.
   8
   9 The encoding will take advantage of multi-core cpus.
  10
  11 To start the disk consumer you need to send the following command:
  12
  13 ::
  14
  15     ADD 1 FILE myfile.mov
  16
  17 Where the file extension will decide the container format and appropriate codec.
  18
  19 To stop it you simply type:
  20
  21 ::
  22
  23     REMOVE 1 FILE
  24
  25 The default, and recommended format is H264 which uses the highly optimized libx264 encoder. You can of course also choose what codec to encode to. The file consumer follows commandline arguments syntax used by ffmpeg, see ffmpeg for more options. Some of the available options are:
  26
  27 ::
  28
  29     -f // container format
  30     -vcodec // vicdeo codec
  31     -pix_fmt // pixel_format
  32     -r // video framerate
  33     -s // size
  34     -b // video bitrate
  35     -acodec // audio codec
  36     -ar // audio samplerate
  37     -ab // audio bitrate
  38     -ac // audio channels
  39
  40 ::
  41
  42     ADD 1 FILE myfile.mov -vcodec dnxhd
  43     ADD 1 FILE myfile.mov -vcodec prores
  44     ADD 1 FILE myfile.mov -vcodec dvvideo
  45     ADD 1 FILE myfile.mov -vcodec libx264
  46
  47 For the above formats we have already provided high quality default parameters. Though you can of course also specify other codecs (see the -vcodec option in ffmpeg), and the corresponding options (see ffmpeg documentation):
  48
  49 ::
  50
  51     ADD 1 FILE myfile.mov -vcodec libx264 -preset ultrafast -tune fastdecode -crf 5