summaryrefslogtreecommitdiff
path: root/README
blob: fd3983c29e04f02d36f219aeb61f151eedeee0f3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
dvd-o-matic
-----------

Hello!


Building for Linux
------------------

./waf configure
./waf
sudo ./waf install


Building for Windows
--------------------

...is quite involved.  You need to build (or download) all the dependencies.
I'll put my scripts up at some point.


Dependencies
------------

You will need these libraries:

    libdcp (from http://carlh.net/software/libdcp)
    FFmpeg version 0.9.x or higher
    libtiff
    boost thread and filesystem
    libopenjpeg 1.5.0 or higher
    wxWidgets
    libsndfile
    libssh

and also the command line tool:

    vobcopy (if you want to rip DVDs straight into DVD-o-matic)


Documentation
-------------

There is a manual available at http://carlh.net/software/dvdomatic
The DocBook source for this is in doc/manual.


In a nutshell
-------------

The `dvdomatic' program is a GTK front-end which is probably easiest
to use.  It will create a directory for a particular project, and write
its data to that directory.  The basic approach is:

"File->New"; specify a directory.
Choose "Jobs->Copy from DVD" to read a DVD from your drive, if you have one.
Fill in the fields in the window (most importantly the `content' field:
  specify your video, and the `Name' field: give your project [and hence DCP]
  a name.)
Move the slider to see thumbnails; adjust crop if necessary.
Select "Jobs->Make DCP" and go and make a really strong cup of tea.
The DCP will be written to the project's directory; copy this to your
  media server and ingest.

The `Format' field dictates what size your image will be:

- 4:3 within Flat: 1.33:1 images inside a flat (1.85:1) frame; play
  back using the DCI 1.85 / DCI Flat preset on your projector.
- Academy: 1.37:1; play using DCI 1.37 if you have such a thing.
- 16:9 within Flat: 1.78:1 images inside a 1.85:1 frame.
- Flat: 1.85:1 images to the DCI spec.
- Scope: 2.39:1 images to the DCI spec.


Server/client
-------------

Running the `servomatic' program on a remote machine will make it
listen on port 6192 (by default) and process requests from a dvdomatic
instance.  This has been written with no thought to security, so don't
do it over the public internet!  The connection will probably need to
be 1 Gb/s to make it worthwhile.

To tell the client about available servers you will need to go to
Edit->Preferences and add the server's IP address and the number of
parallel threads that the server should execute (make it equal to the
number of CPUs or cores).



Problems
--------

Email me at cth@carlh.net in the first instance.


Carl Hetherington
August 2012