summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README62
1 files changed, 62 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..0ac5c1f
--- /dev/null
+++ b/README
@@ -0,0 +1,62 @@
+README for libdvdcss, a portable abstraction library for DVD decryption
+
+
+Introduction
+============
+
+libdvdcss is part of the VideoLAN project, which among other things produces
+VLC, a full video client/server streaming solution. VLC can also be used as
+a standalone program to play video streams from a hard disk or a DVD.
+
+
+Building and Installing libdvdcss
+=================================
+
+See the INSTALL file.
+
+
+Running libdvdcss
+=================
+
+The behavior of the library can be changed by setting two environment variables:
+
+ DVDCSS_METHOD={title|disc|key}: method for key decryption
+ title: By default the decrypted title key is guessed from the encrypted
+ sectors of the stream. Thus it should work with a file as well as
+ the DVD device. But decrypting a title key may take too much time
+ or even fail. With the title method, the key is only checked at
+ the beginning of each title, so it will not work if the key
+ changes in the middle of a title.
+ disc: The disc key is cracked first. Afterwards all title keys can be
+ decrypted instantly, which allows checking them often.
+ key: The same as the "disc" method if you do not have a file with player
+ keys at compile time. If you do, disc key decryption will be faster.
+ This is the default method also employed by libcss.
+ DVDCSS_VERBOSE={0|1|2}: libdvdcss verbosity
+ 0: no error messages, no debug messages (this is the default)
+ 1: only error messages
+ 2: error and debug messages
+
+
+Troubleshooting
+===============
+
+A mailing-list has been set up for support and discussion about
+libdvdcss. Its address is:
+
+ <libdvdcss-devel@videolan.org>
+
+To subscribe or unsubscribe, go to:
+
+ http://mailman.videolan.org/
+
+When reporting bugs, try to be as precise as possible (which OS, which
+distribution, what plugins you were trying, and so on).
+
+
+Resources
+=========
+
+The VideoLAN web site at http://www.videolan.org/ is a good start for
+information about MPEG and DVD playback. Have a look at the support
+section to look for answers.