Commit | Line | Data |
---|---|---|
c764e832 MW |
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) |