git.sesse.net Git - vlc/blob - README.libdvdcss

   1 README for libdvdcss, a portable abstraction library for DVD decryption
   2
   3
   4 Introduction
   5 ============
   6
   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.
  10
  11
  12 Building and Installing libdvdcss
  13 =================================
  14
  15 See the INSTALL or INSTALL.libdvdcss file for this.
  16
  17 Running lidvdcss
  18 ================
  19
  20 The behaviourof the library can be affected by changing two environment
  21 variables:
  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
  35            libcss.
  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
  40
  41
  42 Troubleshooting
  43 ===============
  44
  45 A mailing-list has been set up for support and discussion about vlc and
  46 libdvdcss. Its address is :
  47
  48    <vlc@videolan.org>
  49
  50 To subscribe, send a mail to <listar@videolan.org> with the following
  51 words in the mail body :
  52
  53    subscribe vlc
  54
  55 To unsubscribe, do the same with the words :
  56
  57    unsubscribe vlc
  58
  59
  60 When reporting bugs, try to be as precise as possible (which OS, which
  61 distribution, what plugins you were trying, and so on).
  62
  63
  64 Resources
  65 =========
  66
  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.
  70