====== dvd_player ======

  * [[dvd_info]] - main package

This is a tiny DVD player that uses libmpv (mpv package) as its backend for media playback. A man page is included with the ''dvd_info'' package, see ''man dvd_player'' for details. Here is the help output:

<code>
dvd_player - a tiny DVD player

Usage: dvd_player [path] [options]

Options:
  -f, --fullscreen              Display in fullscreen mode
  -t, --track <#>               Playback track number (default: longest valid)
  -c, --chapter <#>[-#]         Playback chapter number or range (default: all)
  -a, --alang <language>        Select audio language, two character code (default: first audio track)
  -A, --aid <#>                 Select audio track ID
  -s, --slang <language>        Select subtitles language, two character code (default: no subtitles)
  -S, --sid <#>                 Select subtitles track ID
  -d, --detelecine              Detelecine video
  -v, --verbose                 Verbose output
  -h, --help			Show this help text and exit

DVD path can be a device name, a single file, or directory (default: /dev/sr0)

dvd_player reads a configuration file from ~/.config/dvd_player/mpv.conf
See mpv man page for syntax and dvd_player man page for examples.
</code>

==== Custom Configuration ====

One of mpv's strong points is that it can have configuration saved in your config directory. This program supports that as well.

Here's an example ''mpv.conf'' that goes in ''~/.config/dvd_player/'' directory:

<code>
alang=en
slang=en
fullscreen

screenshot-format=png
screenshot-template="%f-mpv-%ws.%wT"

osd-level=2
</code>

==== Track Selection ====

One thing that may be confusing is that ''mpv'' and ''dvd_player'' do not have the same track ordering number. MPV zero-indexes the tracks (the first track is number 0), while all the dvd_info tools one-index them (the first track is number 1).

This can be confusing in the user output because ''dvd_player'' will accept the one-indexed track number, but libmpv will output a different track number.

<code>
$ dvd_player -t 2
[dvd_player] Track: 2, Length: 00:22:36.033, Chapters: 5, Filesize: 549 MBs
libdvdnav: DVD Title: 888574310851D1
libdvdnav: DVD Serial Number: 0CEE4CEBDVDSHR
libdvdnav: DVD Title (Alternative): 
libdvdnav: DVD disk reports itself with Region mask 0x00000000. Regions: 01 02 03 04 05 06 07 08
[dvdnav] DVDNAV, switched to title: 1
</code>