README

   1 dvd-o-matic
   2 -----------
   3
   4 Hello!
   5
   6
   7 Building
   8 --------
   9
  10 ./waf configure
  11 ./waf
  12 sudo ./waf install
  13
  14
  15 Dependencies
  16 ------------
  17
  18 You will need these libraries:
  19
  20     FFmpeg
  21     libtiff
  22     boost thread and filesystem
  23     libopenjpeg
  24
  25 and also the command line tools:
  26
  27     opendcp_mxf and opendcp_xml (from OpenDCP http://code.google.com/p/opendcp/)
  28     vobcopy (if you want to rip DVDs straight into DVD-o-matic)
  29
  30
  31 In a nutshell
  32 -------------
  33
  34 The `dvdomatic' program is a GTK front-end which is probably easiest
  35 to use.  It will create a directory for a particular project, and write
  36 its data to that directory.  The basic approach is:
  37
  38 "File->New"; specify a directory.
  39 Choose "Jobs->Copy from DVD" to read a DVD from your drive, if you have one.
  40 Fill in the fields in the window (most importantly the `content' field:
  41   specify your video, and the `Name' field: give your project [and hence DCP]
  42   a name.)
  43 Move the slider to see thumbnails; adjust crop if necessary.
  44 Click "Make DCP" and go and make a really strong cup of tea.
  45 The DCP will be written to the project's directory; copy this to your
  46   media server and ingest.
  47
  48 The `Format' field dictates what size your image will be:
  49
  50 - 4:3 within Flat: 1.33:1 images inside a flat (1.85:1) frame; play
  51   back using the DCI 1.85 / DCI Flat preset on your projector.
  52 - Academy: 1.37:1; play using DCI 1.37 if you have such a thing.
  53 - 16:9 within Flat: 1.78:1 images inside a 1.85:1 frame.
  54 - Flat: 1.85:1 images to the DCI spec.
  55 - Scope: 2.39:1 images to the DCI spec.
  56
  57
  58
  59 Server/client
  60 -------------
  61
  62 Running the `servomatic' program on a remote machine will make it
  63 listen on port 6192 (by default) and process requests from a dvdomatic
  64 instance.  This has been written with no thought to security, so don't
  65 do it over the public internet!  The connection will probably need to
  66 be 1 Gb/s to make it worthwhile.
  67
  68 To tell the client about available servers you will need to go to
  69 Edit->Preferences and add the server's IP address and the number of
  70 parallel threads that the server should execute (make it equal to the
  71 number of CPUs or cores).
  72
  73
  74
  75 Problems
  76 --------
  77
  78 Email me at cth@carlh.net in the first instance.
  79
  80
  81 Carl Hetherington
  82 July 2012