Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo


Tree [7edd73] /

File Date Author Commit
doc 2007-04-07 nicodvb nicodvb [52948a] removed .cvsignore files
examples 2008-04-19 nicodvb nicodvb [52ca2c] removed unused variable dsi; patch by Erik Hovl...
m4 2007-04-07 nicodvb nicodvb [52948a] removed .cvsignore files
misc 2008-01-01 nicodvb nicodvb [173d7d] from now on we don't include anymore _PREFIX/in...
msvc 2004-08-01 mroi mroi [61e24b] almost forgotten patch for MSVC compilation by ...
src 2008-04-19 nicodvb nicodvb [7edd73] in remap_loadmap() close the file pointer befor...
.relignore 2004-04-09 mroi mroi [a7b3f5] testing some improvements to relchk script
AUTHORS 2004-09-12 mroi mroi [4ec9b7] patch from Franti¨ek to avoid symbol name clashes
COPYING 2002-03-12 richwareham richwareham [52d456] Initial revision
ChangeLog 2008-04-10 rathann rathann [097fca] - update with current notable changes
DEVELOPMENT-POLICY.txt 2007-04-11 nicodvb nicodvb [d89641] this->these (I must be really asleep)
INSTALL 2004-02-17 mroi mroi [3752c0] update INSTALL text to autoconf 2.57
Makefile 2008-04-10 rathann rathann [745782] Fix DESTDIR handling
Makefile.am 2004-09-13 pmhahn pmhahn [88407f] Remove all Debian related files, because on ret...
NEWS 2003-03-31 mroi mroi [62d1b4] I should not have deleted this, automake demand...
README 2008-04-10 rathann rathann [575419] Update to reflect current upstream location.
TODO 2007-04-22 nicodvb nicodvb [47b48c] mention the new build-system
autogen.sh 2005-05-03 mroi mroi [ccc0c3] shell quoting fix (thanks to Darren)
configure.ac 2007-05-01 nicodvb nicodvb [7578b0] raise subrevision
configure2 2008-04-13 rathann rathann [d5a97b] bump version for release
version.sh 2007-04-15 nicodvb nicodvb [273f17] initial revision of new build system; patch by ...

Read Me

What is this all about?

libdvdnav is a library that allows easy use of sophisticated DVD navigation
features such as DVD menus, multiangle playback and even interactive DVD games.
All this functionality is provided through a simple API which provides the
DVD playback as a single logical stream of blocks, intermitted by special
dvdnav events to report certain conditions. The main usage of libdvdnav is a
loop regularly calling a function to get the next block, surrounded by
additional calls to tell the library of user interaction.
The whole DVD virtual machine and internal playback states are completely

Where does it come from?

This library is based on a lot of code and expertise from the Ogle project.
Ogle was the first DVD player who implemented free DVD navigation. The
libdvdnav developers wish to express their gratitude to the Ogle people
for all the valuable research work they have done.

Initially, the dvdnav code was part of a plugin to the xine media player
called xine-dvdnav. Later on, the DVD VM specific code was split
from xine-dvdnav and went into the first version of libdvdnav.

Where is it now?

libdvdnav is hosted on http://www.mplayerhq.hu/MPlayer/releases/dvdnav/ .
Please report bugs to the developers mailinglist at
mailto:dvdnav-discuss@mplayerhq.hu .

We are still in beta stage, but libdvdnav is already quite usable. With
regular DVD playback, there should not be any serious issues. The library
also makes some limited effort to handle error situations gracefully, but
there are still assertions in the code that may trigger on some DVDs. Please
send a report to the developer mailinglist, if you encounter such problems.

How can I use it?

libdvdnav is completely licensed under GPL. You may use it at wish within the
bounds of this license. See the file "COPYING" for a copy of the GPL.

Sources for documentation on libdvdnav are:
* the examples directory contains a simple program using libdvdnav
  this one is well-commented and therefore a good starting point
* the public header dvdnav.h documents the API
* the public header dvdnav_events.h documents the dvdnav events
* doc/library_layout contains some info on the internal working of libdvdnav

Sources for documentation on DVD terminology, structure and surrounding concepts:
* doc/dvd_structures briefly explains DVD terms and organization
* a more detailed description of DVD structures is available at
* the ifo_types.h and nav_types.h headers are also interesting if you
  are already used to the sometimes cryptical abbreviations