multimedia/libdvdcss/libdvdcss-1.4.3

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.
Name		Date	Size	#Lines	LOC
..		03-May-2022	-
doc/	H	20-Apr-2021	-	2,294	1,769
m4/	H	20-Apr-2021	-	9,372	8,465
msvc/	H	06-Jan-2015	-	474	393
src/	H	20-Apr-2021	-	6,302	4,078
test/	H	20-Apr-2021	-	425	305
AUTHORS	H A D	27-Feb-2013	1.7 KiB	89	68
COPYING	H A D	19-Feb-2016	17.7 KiB	340	281
ChangeLog	H A D	20-Apr-2021	116.6 KiB	3,628	2,447
INSTALL	H A D	19-Apr-2021	1.5 KiB	68	38
Makefile.am	H A D	16-Dec-2015	1.9 KiB	84	63
Makefile.in	H A D	03-May-2022	41 KiB	1,127	1,001
NEWS	H A D	20-Apr-2021	5 KiB	193	134
README	H A D	16-Nov-2014	2.1 KiB	63	42
aclocal.m4	H A D	20-Apr-2021	42.7 KiB	1,175	1,067
compile	H A D	12-Feb-2019	7.2 KiB	349	259
config.guess	H A D	12-Feb-2019	43.2 KiB	1,481	1,288
config.h.in	H A D	20-Apr-2021	4.4 KiB	170	115
config.sub	H A D	12-Feb-2019	35.3 KiB	1,802	1,661
configure	H A D	20-Apr-2021	478.9 KiB	16,557	13,994
configure.ac	H A D	20-Apr-2021	6.7 KiB	256	225
depcomp	H A D	12-Feb-2019	23 KiB	792	502
install-sh	H A D	12-Feb-2019	15 KiB	519	337
libdvdcss.spec	H A D	20-Apr-2021	5.7 KiB	182	140
libdvdcss.spec.in	H A D	15-Feb-2015	5.7 KiB	182	142
ltmain.sh	H A D	12-Feb-2019	319.4 KiB	11,250	8,044
missing	H A D	12-Feb-2019	6.7 KiB	216	143