xine_dvdnav - DVD Navigator plugin for Xine Introduction ~~~~~~~~~~~~ This is the Xine-DVDNAV plugin for the Xine media player. Its aim is to add the full compliment of advanced DVD features to Xine, including branching, menus and angles. Currently the plugin is in a beta phase being mostly feature complete. Updates to this plugin normally go hand-in-hand with updates to Xine itself so normally one should fetch the latest xine-lib and xine-ui from Xine's CVS. Releases of the plugin follow the same versioning scheme as Xine itself, so if you have version x.y.z of Xine, the x.y.z release of the dvdnav plugin should work with it. This plugin WILL NOT WORK with versions of Xine 0.4.x and below. Please see KNOWN-BUGS for current issues before posting bug reports to the list. Also, if you are worried that this plugin allows you to view encrypted content on DVDs, please read the IMPORTANT_README file. Software Requirements ~~~~~~~~~~~~~~~~~~~~~~ * A version of xine-lib and xine-ui which matches the version number of this release. * libdvdread (0.9.0 or higher recommended) which may be downloaded from http://www.dtek.chalmers.se/groups/dvd/downloads.shtml * For CSS-decryption, a copy of libdvdcss from the VideoLan project's homepage (http://www.videolan.org/). Usage ~~~~~ The plugin adds the 'dvdnav://' MRL-type to Xine. To launch Xine from the command line and make it play the DVD in /dev/dvd fullscreen, simply use $ xine -f -g -pq dvdnav:// Alternatively, start Xine, click on the 'NAV' button and press 'play'. If all goes well, any copyright notices on the DVD will be displayed followed by the main DVD menu. You can move the mouse to move the highlight and clicking the mouse will activate the currently highlighted button. Alternatively, you may use the KEYPAD arrowkeys to move the highlight and KEYPAD Enter to select the currently highlighted button. The default keybindings of xine-ui provide the following features: * Keypad 9/3 -- Next/previous chapter (ensure NumLock is on). * Keypad 7/1 -- Next/previous angle (ensure NumLock is on). If you look at the Xine GUI, the plugin displays, when appropriate, the current title, chapter and (if present) angle. The Subtitle and Audio languages are shown in terms of its two-letter code (e.g. English is 'en', Trad. Chinese is 'zh' and French is 'fr'). Advanced usage ~~~~~~~~~~~~~~ A useful feature of the plugin is the ability to specify a title/chapter from the MRL. The MRL takes the following form: dvdnav://[path to dvd device][:title[.chapter]] So, for example dvdnav:///dev/dvd2:3.4 would play chapter 4 of title 3 from the DVD in /dev/dvd2. Note the three '/'s in the MRL. Acknowledgements ~~~~~~~~~~~~~~~~ The plugin would be next to useless without the great work of the Xine project (http://xine.sf.net/). Portions of this software originated from the Ogle DVD player project (http://www.dtek.chalmers.se/groups/dvd/) and I hereby thank all the authors involved in that project. Copyright ~~~~~~~~~ Copyright (C) 2000,2001 Richard J Wareham Portions of this code originated from the Ogle and Xine projects. xine_dvdnav is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Comments are welcome. - Richard J Wareham