chiark - git - mdw - disorder/blob - doc/disorder-gstdecode.8.in

   1 .\" -*-nroff-*-
   2 .\"
   3 .\" Copyright (C) 2007, 2008 Richard Kettlewell
   4 .\" Copyright (C) 2016 Mark Wooding
   5 .\"
   6 .\" This program is free software: you can redistribute it and/or modify
   7 .\" it under the terms of the GNU General Public License as published by
   8 .\" the Free Software Foundation, either version 3 of the License, or
   9 .\" (at your option) any later version.
  10 .\"
  11 .\" This program is distributed in the hope that it will be useful,
  12 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 .\" GNU General Public License for more details.
  15 .\"
  16 .\" You should have received a copy of the GNU General Public License
  17 .\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 .\"
  19 .TH disorder-gstdecode 8
  20 .SH NAME
  21 disorder-gstdecode \- DisOrder audio decoder using GStreamer
  22 .SH SYNOPSIS
  23 .B disorder\-gstdecode
  24 .RB [ -c
  25 .IR CONFIGFILE ]
  26 .RB [ -d
  27 .IR DITHER ]
  28 .RB [ -f
  29 .IR GAIN ]
  30 .br
  31 \h'8n'\c
  32 .RB [ -n
  33 .IR SHAPE ]
  34 .RB [ -q
  35 .IR QUALITY ]
  36 .RB [ -r
  37 .IR MODE ]
  38 .I PATH
  39 .SH DESCRIPTION
  40 .B disorder\-gstdecode
  41 converts encoded audio files into DisOrder's "raw" format.
  42 It uses the GStreamer library for conversion,
  43 and can decode any kind of audio file
  44 for which the necessary GStreamer plugins are available.
  45 .PP
  46 It is suitable for use as an
  47 .B execraw
  48 player.
  49 .PP
  50 It is not intended to be used from the command line,
  51 but command-line options can usefully be provided
  52 in DisOrder's configuration file.
  53 .SH OPTIONS
  54 .TP
  55 .B \-\-help\fR, \fB\-h
  56 Display a usage message.
  57 .TP
  58 .B \-\-version\fR, \fB\-V
  59 Display version number.
  60 .TP
  61 .B \-\-config \fICONFIGFILE\fR, \fB\-c \fICONFIGFILE
  62 Set the configuration file.
  63 .TP
  64 .B \-\-dither \fITYPE\fR, \fB\-d \fIDITHER
  65 Set the dither type used during audio format conversion.
  66 This can be \fBnone\fR,
  67 \fBrpdf\fR for rectangular dithering,
  68 \fBtpdf\fR for triangular dithering, or
  69 \fBtpdf-hf\fR for high-frequency triangular dithering.
  70 Maybe the GStreamer documentation will explain what these mean.
  71 The default is to leave the decision
  72 to GStreamer's \fBaudioconvert\fR plugin.
  73 .TP
  74 .B \-\-fallback-gain \fIGAIN\fR, \fB\-f \fIGAIN
  75 Set the gain to be applied to tracks
  76 which don't have ReplayGain information.
  77 This is in decibels, and will usually be negative.
  78 The default is zero, which is probably wrong.
  79 .TP
  80 .B \-\-noise-shape \fITYPE\fR, \fB-n \fITYPE
  81 Set the noise shaping type used during audio format conversion.
  82 This can be \fBnone\fR,
  83 \fBerror-feedback\fR,
  84 \fBsimple\fR for 2-pole noise shaping,
  85 \fBmedium\fR for 5-pole noise shaping, or
  86 \fBhigh\fR for 8-pole noise shaping.
  87 Maybe the GStreamer documentation will explain what these mean.
  88 The default is to leave the decision
  89 to GStreamer's \fBaudioconvert\fR plugin.
  90 .TP
  91 .B \-\-quality \fIQUALITY\fR, \fB\-q \fIQUALITY
  92 Set the quality level to be used for resampling.
  93 This should be an integer between
  94 0 (poor, but fast) and
  95 10 (good, but slow).
  96 See the GStreamer documentation for more information.
  97 The default is to leave the decision
  98 to GStreamer's \fBaudioresample\fR plugin.
  99 .TP
 100 .B \-\-replay-gain \fIMODE\fR, \fB\-r \fIMODE
 101 Set the ReplayGain mode.
 102 This can be \fBoff\fR to not bother with ReplayGain at all,
 103 \fBtrack\fR to use the per-track gain setting, or
 104 \fBalbum\fR to use the per-album gain setting
 105 (so that the volume level sounds consistent
 106 when playing an entire album).
 107 The default is \fBalbum\fR.
 108 .SH "SEE ALSO"
 109 .BR disorderd (8),
 110 .BR disorder_config (5)