summaryrefslogtreecommitdiff
path: root/sound-cutter.1.in
blob: c5b9697cbcb78fe3287a58d3dfca9593f1553190 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
.TH sound-cutter 8 "" "sound-cutter #VERSION#" ""
.SH NAME
sound-cutter \- Wrapper for sox for mastering stereo music (a.k.a. CDs) from multi channel records
.SH SYNOPSIS
\fBsound-cutter [options]\fP
.SH DESCRIPTION
\fBsound-cutter\fP mixes, processes and cuts multi channel recordings via \fBsox\fP.
.SH OPTIONS
.TP
.B "\-1, \-\-no\-gain"
Do not normalize audio (it's faster).
.TP
.B "\-f, \-\-force"
Overwrite output file(s).
.TP
.B "\-n, \-\-dummy"
Only print what would be done.
.TP
.B "\-s, \-\-sampleRate"
Explicitly set output sample rate.
.TP
.B "\-i, \-\-input"
Specify input file, one at a time (can be given multiple times).
.TP
.B "\-o, \-\-output"
Specify output file.
May be given only once.
.TP
.B "\-p, \-\-points"
Specify points file (see below for syntax).
May be given only once.
.TP
.B "\-a, \-\-ausfuehrlich"
Give verbose explanations (rudimentary).
.TP
.B "\-h, \-\-help"
Print help and exit.
.SH POINTS_FILE
Structure of file containing instructions for mixing, processing and cutting:
.TP
.B "# with trailing space"
starts comment (until end of line)
.TP
.B "# without trailing space"
divides left and right part of line
.TP
.B "first line"
left part denotes global start and stop of recording,
right part denotes final remix command
.TP
.B "other lines with non-empty left part"
denote border between tracks. Left part is time for cut, right part may be \fBoverlap $someTime\fP to denote fade betweeen tracks and/or \fBnoNewFile\fP to denote that no new 
track should start here (thus it's only a border between \fBsub\fPtracks) or may be left empty.
.TP
.B "other lines with empty left part"
denote modifications of current (sub)track.
Additional to all sox effects, \fBtrimsplice $position $discard $excess $leeway\fP is also valid.
This combines splice and trim in a sensible manner.
These type of lines must not occure successively.
.SH AUTHOR
.nf
Erich Eckner <opensource at eckner dot net>
.fi