dvd_rip.1

'\" t
.\"     Title: dvd_rip
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-11-30
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "DVD_RIP" "1" "2024-11-30" "\ \&" "\ \&"
.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_rip \- a tiny DVD ripper using libmpv as backend
.SH "SYNOPSIS"
.sp
\fBdvd_rip\fP [\fIPATH\fP] [\fIOPTIONS\fP]
.SH "DESCRIPTION"
.sp
A tiny DVD ripper that has a small set of options for encoding.
.sp
Options and switches can be set in ~/.config/dvd_rip/mpv.conf. See the mpv
documentation for details.
.sp
By default, dvd_rip will encode source to H.264 video with AAC audio in an
MP4 container. If an output filename is given with a different extension,
it will use the default settings for those instead. In each case, the default
presets are used as selected by the codecs as well. Note that mpv must already
be built with support for these codecs, or dvd_rip will quit.
.sp
.if n .RS 4
.nf
.fam C
\&.mp4 \- H.264 video, AAC audio
\&.mkv \- H.264 video, AAC audio
\&.webm \- VPX8 video, Opus audio
.fam
.fi
.if n .RE
.sp
With no options, the largest track will be ripped with the first audio track,
to a file named dvd_track_#.mkv, where # is a zero\-padded name of the track
number.
.SH "OPTIONS"
.sp
\fB\-o, \-\-output\fP=\fIFILENAME\fP
.RS 4
Save to filename (default: \fIdvd_track_#.mp4\fP),
where default track is longest one on DVD, and ## is zero\-padded
track number.
.RE
.sp
\fB\-t, \-\-track\fP=\fITRACK\fP
.RS 4
Encode track number. Default is longest valid track.
.RE
.sp
\fB\-c, \-\-chapter\fP=\fICHAPTER[\-[CHAPTER]]\fP
Encode chapter number or range. Default is all chapters.
.sp
\fB\-\-start\fP=\fI[+|\-][[hh:]mm:]ss[.ms]\fP
Start at time length in format in [+|\-][[hh:]mm:]ss[.ms] or <percent>%
.sp
\fB\-\-stop\fP=\fI[+|\-][[hh:]mm:]ss[.ms]\fP
Stop at time length in format in [+|\-][[hh:]mm:]ss[.ms] or <percent>%
.sp
\fB\-\-alang\fP=\fILANGUAGE\fP
Select audio track by language code, two letters. Default is first
audio track.
.sp
\fB\-\-aid\fP=\fI#\fP
Select audio track by stream ID.
.sp
\fB\-\-slang\fP=\fILANGUAGE\fP
Select subtitle track by language code, two letters. Default is no
subtitles.
.sp
\fB\-\-sid\fP=\fI#\fP
Select subtitles track by stream ID.
.sp
\fB\-v, \-\-vcodec\fP=\fIx264|x265|vp8|vp9\fP
Video codec to use. H.264 (x264) has widest support, including
HTML5. H.265 (x265) videos will be smaller than H.264. VP8 and 9 can
also be played back with HTML5.
.sp
\fB\-a, \-\-acodec\fP=\fIaac|opus\fP
Audio codec to use.
.sp
\fB\-q, \-\-crf\fP=\fI#\fP
Video encoder CRF to use. The default is a high quality value.
.sp
\fB\-D, \-\-no\-detelecine\fP
Do not detelecine video.
.sp
\fB\-\-verbose\fP
Display verbose output.
.sp
\fB\-\-debug\fP
Display debug output.
.sp
\fB\-h, \-\-help\fP
Display help output.
.SH "SEE ALSO"
.sp
dvd_backup(1), dvd_copy(1), dvd_drive_status(1), dvd_info(1), dvd_player(1)
.SH "BUGS"
.sp
\fBdvd_rip\fP sometimes breaks on tracks that libdvdnav moves around on, and so
it can be unpredictable, or encode past a track\(cqs actual length.
.sp
\fBdvd_rip\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).