dvd_player.1

'\" t
.\"     Title: dvd_player
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-11-08
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "DVD_PLAYER" "1" "2024-11-08" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
dvd_player \- a tiny DVD player using libmpv as backend
.SH "SYNOPSIS"
.sp
\fBdvd_player\fP [\fIPATH\fP] [\fIOPTIONS\fP]
.SH "DESCRIPTION"
.sp
Plays back a DVD track. DVD can be an optical disc, image, or directory.
.sp
The default device is based on your operating system, and is the primary
optical drive.
.SH "OPTIONS"
.sp
\fB\-t, \-\-track\fP=\fITRACK\fP
.RS 4
Playback track number. Default is longest valid track.
.RE
.sp
\fB\-c, \-\-chapter\fP=\fICHAPTER[\-[CHAPTER]]\fP
Playback chapter number or range. Default is all chapters.
.sp
\fB\-a, \-\-alang\fP=\fILANGUAGE\fP
Select audio track by language code, two letters. Default is first
audio track.
.sp
\fB\-A, \-\-aid\fP=\fI#\fP
Select audio track by stream ID.
.sp
\fB\-s, \-\-slang\fP=\fILANGUAGE\fP
Select subtitle track by language code, two letters. Default is no
subtitles.
.sp
\fB\-S, \-\-sid\fP=\fI#\fP
Select subtitle track by stream ID.
.sp
\fB\-f, \-\-fullscreen\fP
Display in fullscreen mode.
.sp
\fB\-D, \-\-no\-detelecine\fP
Do not detelecine video.
.sp
\fB\-v, \-\-verbose\fP
Enable verbose output.
.sp
\fB\-z, \-\-debug\fP
Enable debugging output.
.sp
\fB\-V, \-\-version\fP
Display version number.
.sp
\fB\-h, \-\-help\fP
Display help output.
.SH "CONFIGURATION"
.sp
\fBdvd_player\fP uses libmpv as its backend. A configuration file can be created in
~/.config/dvd_player/mpv.conf to set and override defaults. See the mpv
documentation for switches and options that can be used.
.sp
Settings in mpv.conf will override options passed to \fBdvd_player\fP.
.sp
As an example, always select Spanish as default audio language, English as subtitle
language, and play in fullscreen:
.sp
.if n .RS 4
.nf
.fam C
alang=es
slang=en
fullscreen
.fam
.fi
.if n .RE
.SH "SEE ALSO"
.sp
dvd_backup(1), dvd_copy(1), dvd_drive_status(1), dvd_info(1), dvd_rip(1)
.SH "BUGS"
.sp
\fBdvd_player\fP does not wait for an optical device to be ready. Wait for it to
finish "polling" before running the program.
.sp
Please file bugs at \c
.URL "https://github.com/beandog/dvd_info/issues" "" ""
.SH "AUTHOR"
.sp
dvd_player was written by Steve Dibb \c
.MTO "steve.dibb\(atgmail.com" "" ""
.SH "RESOURCES"
.sp
Source code available at GitHub: \c
.URL "https://github.com/beandog/dvd_info" "" ""
.SH "COPYING"
.sp
Copyright (C) 2023 Steve Dibb. Free use of this software is granted under the
terms of the GNU General Public License, version 2 (GPL).