1 README for libdvdcss, a portable abstraction library for DVD decryption
7 libdvdcss is part of the VideoLAN project, a full MPEG2 client/server
8 solution. The VideoLAN Client can also be used as a standalone program
9 to play MPEG2 streams from a hard disk or a DVD.
12 Building and Installing libdvdcss
13 =================================
15 See the INSTALL or INSTALL.libdvdcss file for this.
20 The behaviourof the library can be affected by changing two environment
22 DVDCSS_METHOD={title|disc|key}: method for key decryption
23 title: decrypted title key is guessed from the encrypted sectors of
24 the stream. Thus it should work with a file as well as the
25 DVD device. But it sometimes takes much time to decrypt a title
26 key and may even fail. With this method, the key is only checked
27 at the beginning of each title, so it won't work if the key
28 changes in the middle of a title.
29 This is the default method,
30 disc: the disc key is first cracked ; then all title keys can be
31 decrypted instantly, which allows us to check them often,
32 key: the same as "disc" if you don't have a file with player keys at
33 compilation time. If you do, the decryption of the disc key
34 will be faster with this method. It is the one that was used by
36 DVDCSS_VERBOSE={0|1|2}: libdvdcss verbosity
37 0: no error messages, no debug messages,
38 1: only error messages (this is the default)
39 2: error and debug messages
45 A mailing-list has been set up for support and discussion about vlc and
46 libdvdcss. Its address is :
50 To subscribe, send a mail to <listar@videolan.org> with the following
51 words in the mail body :
55 To unsubscribe, do the same with the words :
60 When reporting bugs, try to be as precise as possible (which OS, which
61 distribution, what plugins you were trying, and so on).
67 The VideoLAN web site at http://www.videolan.org/ is a good start for
68 information about MPEG and DVD playing. Have a look at the documentation
69 section, as well as the bookmarks.