dtas 0.16.1 → 0.19.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.gitignore +1 -1
- data/Documentation/.gitignore +1 -1
- data/Documentation/GNUmakefile +2 -2
- data/Documentation/dtas-archive.pod +2 -2
- data/Documentation/dtas-console.pod +2 -2
- data/Documentation/dtas-ctl.pod +2 -2
- data/Documentation/dtas-cueedit.pod +2 -2
- data/Documentation/dtas-enq.pod +2 -2
- data/Documentation/dtas-env.pod +3 -3
- data/Documentation/dtas-msinkctl.pod +2 -2
- data/Documentation/dtas-player.pod +2 -2
- data/Documentation/dtas-player_effects.pod +2 -2
- data/Documentation/dtas-player_protocol.pod +4 -4
- data/Documentation/dtas-player_sink_examples.pod +2 -2
- data/Documentation/dtas-sinkedit.pod +4 -4
- data/Documentation/dtas-sourceedit.pod +4 -4
- data/Documentation/dtas-splitfx.pod +7 -1
- data/Documentation/dtas-tl.pod +4 -4
- data/Documentation/dtas-xdelay.pod +2 -2
- data/Documentation/update-footer.rb +2 -2
- data/GIT-VERSION-FILE +1 -1
- data/GIT-VERSION-GEN +2 -2
- data/GNUmakefile +13 -1
- data/HACKING +2 -2
- data/INSTALL +10 -24
- data/NEWS +103 -0
- data/README +14 -8
- data/Rakefile +1 -1
- data/TODO +3 -1
- data/bin/dtas-archive +1 -1
- data/bin/dtas-console +17 -21
- data/bin/dtas-ctl +1 -1
- data/bin/dtas-cueedit +1 -1
- data/bin/dtas-enq +1 -1
- data/bin/dtas-mlib +1 -1
- data/bin/dtas-msinkctl +1 -1
- data/bin/dtas-partstats +1 -1
- data/bin/dtas-player +1 -1
- data/bin/dtas-readahead +3 -3
- data/bin/dtas-sinkedit +1 -1
- data/bin/dtas-sourceedit +1 -1
- data/bin/dtas-splitfx +8 -1
- data/bin/dtas-tl +1 -1
- data/bin/dtas-xdelay +1 -1
- data/dtas-linux.gemspec +2 -2
- data/dtas-mpris.gemspec +2 -2
- data/dtas.gemspec +3 -3
- data/dtas.sh +7 -0
- data/examples/zsh-completion/README +3 -0
- data/examples/zsh-completion/_dtas-archive +16 -0
- data/examples/zsh-completion/_dtas-ctl +114 -0
- data/examples/zsh-completion/_dtas-cueedit +7 -0
- data/examples/zsh-completion/_dtas-enq +7 -0
- data/examples/zsh-completion/_dtas-mlib +29 -0
- data/examples/zsh-completion/_dtas-msinkctl +8 -0
- data/examples/zsh-completion/_dtas-partstats +7 -0
- data/examples/zsh-completion/_dtas-sinkedit +11 -0
- data/examples/zsh-completion/_dtas-sourceedit +11 -0
- data/examples/zsh-completion/_dtas-splitfx +17 -0
- data/examples/zsh-completion/_dtas-tl +52 -0
- data/examples/zsh-completion/_dtas-xdelay +17 -0
- data/lib/dtas/buffer/fiddle_splice.rb +216 -0
- data/lib/dtas/buffer/read_write.rb +3 -3
- data/lib/dtas/buffer/splice.rb +9 -5
- data/lib/dtas/buffer.rb +10 -7
- data/lib/dtas/command.rb +1 -1
- data/lib/dtas/compat_onenine.rb +1 -1
- data/lib/dtas/cue_index.rb +1 -1
- data/lib/dtas/disclaimer.rb +1 -1
- data/lib/dtas/edit_client.rb +1 -1
- data/lib/dtas/encoding.rb +8 -9
- data/lib/dtas/fadefx.rb +1 -1
- data/lib/dtas/format.rb +1 -1
- data/lib/dtas/mcache.rb +1 -1
- data/lib/dtas/mlib/migrations/0001_initial.rb +1 -1
- data/lib/dtas/mlib.rb +19 -7
- data/lib/dtas/nonblock.rb +1 -1
- data/lib/dtas/parse_freq.rb +1 -1
- data/lib/dtas/parse_time.rb +1 -1
- data/lib/dtas/partstats.rb +2 -3
- data/lib/dtas/pipe.rb +13 -9
- data/lib/dtas/pipeline.rb +1 -1
- data/lib/dtas/player/client_handler.rb +23 -15
- data/lib/dtas/player.rb +3 -3
- data/lib/dtas/process.rb +1 -1
- data/lib/dtas/replaygain.rb +1 -1
- data/lib/dtas/rg_state.rb +1 -1
- data/lib/dtas/serialize.rb +1 -1
- data/lib/dtas/sigevent/efd.rb +3 -1
- data/lib/dtas/sigevent/fiddle_efd.rb +38 -0
- data/lib/dtas/sigevent/pipe.rb +2 -2
- data/lib/dtas/sigevent.rb +6 -3
- data/lib/dtas/sink.rb +1 -1
- data/lib/dtas/source/av.rb +1 -1
- data/lib/dtas/source/av_ff_common.rb +2 -2
- data/lib/dtas/source/cmd.rb +1 -1
- data/lib/dtas/source/common.rb +1 -1
- data/lib/dtas/source/ff.rb +1 -1
- data/lib/dtas/source/file.rb +1 -1
- data/lib/dtas/source/mp3gain.rb +1 -1
- data/lib/dtas/source/sox.rb +2 -2
- data/lib/dtas/source/splitfx.rb +1 -1
- data/lib/dtas/source.rb +1 -1
- data/lib/dtas/spawn_fix.rb +1 -1
- data/lib/dtas/splitfx.rb +9 -8
- data/lib/dtas/state_file.rb +1 -1
- data/lib/dtas/tfx.rb +1 -1
- data/lib/dtas/track.rb +1 -1
- data/lib/dtas/tracklist.rb +1 -1
- data/lib/dtas/unix_accepted.rb +1 -1
- data/lib/dtas/unix_client.rb +1 -1
- data/lib/dtas/unix_server.rb +1 -1
- data/lib/dtas/util.rb +1 -1
- data/lib/dtas/version.rb +1 -1
- data/lib/dtas/watchable/fiddle_ino.rb +78 -0
- data/lib/dtas/watchable/inotify.rb +13 -0
- data/lib/dtas/watchable.rb +59 -58
- data/lib/dtas/writable_iter.rb +1 -1
- data/lib/dtas/xs.rb +1 -1
- data/lib/dtas.rb +10 -2
- data/man/dtas-archive.1 +15 -15
- data/man/dtas-console.1 +19 -19
- data/man/dtas-ctl.1 +16 -16
- data/man/dtas-cueedit.1 +12 -12
- data/man/dtas-enq.1 +12 -12
- data/man/dtas-env.7 +15 -15
- data/man/dtas-msinkctl.1 +12 -12
- data/man/dtas-player.1 +24 -24
- data/man/dtas-player_effects.7 +9 -9
- data/man/dtas-player_protocol.7 +48 -48
- data/man/dtas-player_sink_examples.7 +15 -15
- data/man/dtas-sinkedit.1 +16 -16
- data/man/dtas-sourceedit.1 +17 -17
- data/man/dtas-splitfx.1 +43 -38
- data/man/dtas-tl.1 +16 -16
- data/man/dtas-xdelay.1 +16 -16
- data/perl/dtas-graph +7 -2
- data/setup.rb +1 -2
- data/test/covshow.rb +1 -1
- data/test/helper.rb +1 -1
- data/test/player_integration.rb +1 -1
- data/test/test_buffer.rb +6 -6
- data/test/test_encoding.rb +1 -1
- data/test/test_env.rb +1 -1
- data/test/test_fadefx.rb +1 -1
- data/test/test_format.rb +1 -1
- data/test/test_format_change.rb +1 -1
- data/test/test_mcache.rb +1 -1
- data/test/test_mlib.rb +1 -1
- data/test/test_parse_freq.rb +1 -1
- data/test/test_pipeline.rb +1 -1
- data/test/test_player.rb +1 -1
- data/test/test_player_client_handler.rb +1 -1
- data/test/test_player_integration.rb +1 -1
- data/test/test_process.rb +1 -1
- data/test/test_rg_integration.rb +1 -1
- data/test/test_rg_state.rb +1 -1
- data/test/test_sigevent.rb +20 -0
- data/test/test_sink.rb +1 -1
- data/test/test_sink_pipe_size.rb +13 -16
- data/test/test_sink_tee_integration.rb +1 -1
- data/test/test_source_av.rb +1 -1
- data/test/test_source_sox.rb +1 -1
- data/test/test_splitfx.rb +1 -1
- data/test/test_tfx.rb +1 -1
- data/test/test_tracklist.rb +1 -1
- data/test/test_unixserver.rb +1 -1
- data/test/test_util.rb +1 -1
- metadata +23 -4
@@ -1,4 +1,4 @@
|
|
1
|
-
.\" Automatically generated by Pod::Man
|
1
|
+
.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
|
2
2
|
.\"
|
3
3
|
.\" Standard preamble:
|
4
4
|
.\" ========================================================================
|
@@ -46,7 +46,7 @@
|
|
46
46
|
.ie \n(.g .ds Aq \(aq
|
47
47
|
.el .ds Aq '
|
48
48
|
.\"
|
49
|
-
.\" If the F register is
|
49
|
+
.\" If the F register is >0, we'll generate index entries on stderr for
|
50
50
|
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
51
51
|
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
52
52
|
.\" output yourself in some meaningful fashion.
|
@@ -56,12 +56,12 @@
|
|
56
56
|
..
|
57
57
|
.nr rF 0
|
58
58
|
.if \n(.g .if rF .nr rF 1
|
59
|
-
.if (\n(rF:(\n(.g==0)) \{
|
60
|
-
. if \nF \{
|
59
|
+
.if (\n(rF:(\n(.g==0)) \{\
|
60
|
+
. if \nF \{\
|
61
61
|
. de IX
|
62
62
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
63
63
|
..
|
64
|
-
. if !\nF==2 \{
|
64
|
+
. if !\nF==2 \{\
|
65
65
|
. nr % 0
|
66
66
|
. nr F 2
|
67
67
|
. \}
|
@@ -133,7 +133,7 @@
|
|
133
133
|
.\" ========================================================================
|
134
134
|
.\"
|
135
135
|
.IX Title "DTAS-PLAYER_SINK_EXAMPLES 7"
|
136
|
-
.TH DTAS-PLAYER_SINK_EXAMPLES 7 "1994-10-02" "dtas 0.
|
136
|
+
.TH DTAS-PLAYER_SINK_EXAMPLES 7 "1994-10-02" "dtas 0.18.1" "dtas user manual"
|
137
137
|
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
138
138
|
.\" way too many mistakes in technical documents.
|
139
139
|
.if n .ad l
|
@@ -149,7 +149,7 @@ dtas-sinkedit \s-1SINKNAME\s0
|
|
149
149
|
.IX Header "EXAMPLES"
|
150
150
|
.SS "Streaming Ogg-Vorbis to Icecast"
|
151
151
|
.IX Subsection "Streaming Ogg-Vorbis to Icecast"
|
152
|
-
To use \
|
152
|
+
To use \fBoggfwd\fR\|(1) and Icecast, the following sink works.
|
153
153
|
Warning: the following example will likely expose your Icecast source
|
154
154
|
password to any local users on the system.
|
155
155
|
.PP
|
@@ -161,7 +161,7 @@ password to any local users on the system.
|
|
161
161
|
.Ve
|
162
162
|
.SS "Stream to a remote host via ssh"
|
163
163
|
.IX Subsection "Stream to a remote host via ssh"
|
164
|
-
Alternatively, if you have \
|
164
|
+
Alternatively, if you have \fBplay\fR\|(1) installed on any remote host and
|
165
165
|
a slow connection using Ogg-Vorbis:
|
166
166
|
.PP
|
167
167
|
.Vb 6
|
@@ -191,7 +191,7 @@ the above Ogg-Vorbis example.
|
|
191
191
|
To configure a dumper sink (in addition to the \*(L"default\*(R" sink). Note
|
192
192
|
the use of \f(CW$SOXFMT\fR, this will be automatically expanded to match the
|
193
193
|
internal format of the player. The internal format of the player is
|
194
|
-
described in \
|
194
|
+
described in \fBdtas\-player_protocol\fR\|(7).
|
195
195
|
.PP
|
196
196
|
.Vb 1
|
197
197
|
\& $ dtas\-ctl sink ed dumper command=\*(Aqsox $SOXFMT \- /tmp/dump.sox\*(Aq
|
@@ -206,21 +206,21 @@ Non\-\*(L"default\*(R" sinks are not active by default, but may be made active.
|
|
206
206
|
Changing it again to \*(L"active=false\*(R" will deactivate the sink.
|
207
207
|
.SS "Apply a short delay to low frequencies to improve time-alignment"
|
208
208
|
.IX Subsection "Apply a short delay to low frequencies to improve time-alignment"
|
209
|
-
See \
|
209
|
+
See \fBdtas\-xdelay\fR\|(1).
|
210
210
|
.SH "CONTACT"
|
211
211
|
.IX Header "CONTACT"
|
212
212
|
All feedback welcome via plain-text mail to: <mailto:dtas\-all@nongnu.org>
|
213
213
|
.PP
|
214
214
|
Mailing list archives available at <https://80x24.org/dtas\-all/>
|
215
|
-
and <
|
215
|
+
and <https://lists.gnu.org/archive/html/dtas\-all/>
|
216
216
|
.PP
|
217
217
|
No subscription is necessary to post to the mailing list.
|
218
218
|
.SH "COPYRIGHT"
|
219
219
|
.IX Header "COPYRIGHT"
|
220
|
-
Copyright 2013\-
|
220
|
+
Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
|
221
221
|
.PP
|
222
|
-
License: \s-1GPL\-3.0
|
222
|
+
License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
|
223
223
|
.SH "SEE ALSO"
|
224
224
|
.IX Header "SEE ALSO"
|
225
|
-
\&\
|
226
|
-
\&\
|
225
|
+
\&\fBdtas\-ctl\fR\|(1), \fBdtas\-sinkedit\fR\|(1), \fBdtas\-xdelay\fR\|(1),
|
226
|
+
\&\fBsox\fR\|(1), \fBplay\fR\|(1), \fBoggfwd\fR\|(1), \fBssh\fR\|(1), \fBssh_config\fR\|(5), \fBenv\fR\|(1)
|
data/man/dtas-sinkedit.1
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
.\" Automatically generated by Pod::Man
|
1
|
+
.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
|
2
2
|
.\"
|
3
3
|
.\" Standard preamble:
|
4
4
|
.\" ========================================================================
|
@@ -46,7 +46,7 @@
|
|
46
46
|
.ie \n(.g .ds Aq \(aq
|
47
47
|
.el .ds Aq '
|
48
48
|
.\"
|
49
|
-
.\" If the F register is
|
49
|
+
.\" If the F register is >0, we'll generate index entries on stderr for
|
50
50
|
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
51
51
|
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
52
52
|
.\" output yourself in some meaningful fashion.
|
@@ -56,12 +56,12 @@
|
|
56
56
|
..
|
57
57
|
.nr rF 0
|
58
58
|
.if \n(.g .if rF .nr rF 1
|
59
|
-
.if (\n(rF:(\n(.g==0)) \{
|
60
|
-
. if \nF \{
|
59
|
+
.if (\n(rF:(\n(.g==0)) \{\
|
60
|
+
. if \nF \{\
|
61
61
|
. de IX
|
62
62
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
63
63
|
..
|
64
|
-
. if !\nF==2 \{
|
64
|
+
. if !\nF==2 \{\
|
65
65
|
. nr % 0
|
66
66
|
. nr F 2
|
67
67
|
. \}
|
@@ -133,7 +133,7 @@
|
|
133
133
|
.\" ========================================================================
|
134
134
|
.\"
|
135
135
|
.IX Title "DTAS-SINKEDIT 1"
|
136
|
-
.TH DTAS-SINKEDIT 1 "1994-10-02" "dtas 0.
|
136
|
+
.TH DTAS-SINKEDIT 1 "1994-10-02" "dtas 0.18.1" "dtas user manual"
|
137
137
|
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
138
138
|
.\" way too many mistakes in technical documents.
|
139
139
|
.if n .ad l
|
@@ -146,10 +146,10 @@ dtas-sinkedit \s-1SINKNAME\s0
|
|
146
146
|
.SH "DESCRIPTION"
|
147
147
|
.IX Header "DESCRIPTION"
|
148
148
|
dtas-sinkedit spawns an editor to allow editing of a sink as a \s-1YAML\s0 file.
|
149
|
-
See \
|
149
|
+
See \fBdtas\-player_protocol\fR\|(7) for details on \s-1SINKARGS.\s0
|
150
150
|
.PP
|
151
|
-
On Linux machines
|
152
|
-
is used to monitor the file for changes while the text
|
151
|
+
On Linux machines, \fBinotify\fR\|(7)
|
152
|
+
is used to monitor the file for changes while the text editor is running.
|
153
153
|
Each time a user finishes saving a file, changes are committed immediately.
|
154
154
|
This behavior may be disabled by using the \-N or \-\-no\-watch command-line
|
155
155
|
switch.
|
@@ -157,7 +157,7 @@ switch.
|
|
157
157
|
.IX Header "OPTIONS"
|
158
158
|
.IP "\-N, \-\-no\-watch" 4
|
159
159
|
.IX Item "-N, --no-watch"
|
160
|
-
Disable \
|
160
|
+
Disable \fBinotify\fR\|(7) support on Linux systems
|
161
161
|
.IP "\-n, \-\-dry\-run" 4
|
162
162
|
.IX Item "-n, --dry-run"
|
163
163
|
Only print commands which would be sent to dtas-player
|
@@ -184,23 +184,23 @@ Successfully exiting your text editor will send the changes to the
|
|
184
184
|
running dtas-player.
|
185
185
|
.SH "ENVIRONMENT"
|
186
186
|
.IX Header "ENVIRONMENT"
|
187
|
-
\&\s-1VISUAL / EDITOR
|
187
|
+
\&\s-1VISUAL / EDITOR\s0 \- your favorite *nix text editor, defaults to 'vi' if unset.
|
188
188
|
.PP
|
189
|
-
\&\s-1DTAS_PLAYER_SOCK
|
189
|
+
\&\s-1DTAS_PLAYER_SOCK\s0 \- the path to the dtas-player control socket.
|
190
190
|
This defaults to ~/.dtas/player.sock
|
191
191
|
.SH "CONTACT"
|
192
192
|
.IX Header "CONTACT"
|
193
193
|
All feedback welcome via plain-text mail to: <mailto:dtas\-all@nongnu.org>
|
194
194
|
.PP
|
195
195
|
Mailing list archives available at <https://80x24.org/dtas\-all/>
|
196
|
-
and <
|
196
|
+
and <https://lists.gnu.org/archive/html/dtas\-all/>
|
197
197
|
.PP
|
198
198
|
No subscription is necessary to post to the mailing list.
|
199
199
|
.SH "COPYRIGHT"
|
200
200
|
.IX Header "COPYRIGHT"
|
201
|
-
Copyright 2013\-
|
201
|
+
Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
|
202
202
|
.PP
|
203
|
-
License: \s-1GPL\-3.0
|
203
|
+
License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
|
204
204
|
.SH "SEE ALSO"
|
205
205
|
.IX Header "SEE ALSO"
|
206
|
-
\&\
|
206
|
+
\&\fBdtas\-player\fR\|(1), \fBdtas\-player_protocol\fR\|(7), \fBdtas\-ctl\fR\|(1)
|
data/man/dtas-sourceedit.1
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
.\" Automatically generated by Pod::Man
|
1
|
+
.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
|
2
2
|
.\"
|
3
3
|
.\" Standard preamble:
|
4
4
|
.\" ========================================================================
|
@@ -46,7 +46,7 @@
|
|
46
46
|
.ie \n(.g .ds Aq \(aq
|
47
47
|
.el .ds Aq '
|
48
48
|
.\"
|
49
|
-
.\" If the F register is
|
49
|
+
.\" If the F register is >0, we'll generate index entries on stderr for
|
50
50
|
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
51
51
|
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
52
52
|
.\" output yourself in some meaningful fashion.
|
@@ -56,12 +56,12 @@
|
|
56
56
|
..
|
57
57
|
.nr rF 0
|
58
58
|
.if \n(.g .if rF .nr rF 1
|
59
|
-
.if (\n(rF:(\n(.g==0)) \{
|
60
|
-
. if \nF \{
|
59
|
+
.if (\n(rF:(\n(.g==0)) \{\
|
60
|
+
. if \nF \{\
|
61
61
|
. de IX
|
62
62
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
63
63
|
..
|
64
|
-
. if !\nF==2 \{
|
64
|
+
. if !\nF==2 \{\
|
65
65
|
. nr % 0
|
66
66
|
. nr F 2
|
67
67
|
. \}
|
@@ -133,7 +133,7 @@
|
|
133
133
|
.\" ========================================================================
|
134
134
|
.\"
|
135
135
|
.IX Title "DTAS-SOURCEEDIT 1"
|
136
|
-
.TH DTAS-SOURCEEDIT 1 "1994-10-02" "dtas 0.
|
136
|
+
.TH DTAS-SOURCEEDIT 1 "1994-10-02" "dtas 0.18.1" "dtas user manual"
|
137
137
|
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
138
138
|
.\" way too many mistakes in technical documents.
|
139
139
|
.if n .ad l
|
@@ -146,13 +146,13 @@ dtas-sourceedit {sox | av | ff}
|
|
146
146
|
.SH "DESCRIPTION"
|
147
147
|
.IX Header "DESCRIPTION"
|
148
148
|
dtas-sourceedit spawns an editor to allow editing of a source as a \s-1YAML\s0 file.
|
149
|
-
See \
|
150
|
-
a pipe or file, it is parsed as \s-1YAML\s0 and fed to the \
|
149
|
+
See \fBdtas\-player_protocol\fR\|(7) for details on \s-1SOURCEARGS.\s0 If standard input is
|
150
|
+
a pipe or file, it is parsed as \s-1YAML\s0 and fed to the \fBdtas\-player\fR\|(1) instance
|
151
151
|
non-interactively. This is useful for loading various profiles from the
|
152
152
|
filesystem.
|
153
153
|
.PP
|
154
|
-
On Linux machines
|
155
|
-
is used to monitor the file for changes while the text
|
154
|
+
On Linux machines, \fBinotify\fR\|(7)
|
155
|
+
is used to monitor the file for changes while the text editor is running.
|
156
156
|
Each time a user finishes saving a file, changes are committed immediately.
|
157
157
|
This behavior may be disabled by using the \-N or \-\-no\-watch command-line
|
158
158
|
switch.
|
@@ -160,7 +160,7 @@ switch.
|
|
160
160
|
.IX Header "OPTIONS"
|
161
161
|
.IP "\-N, \-\-no\-watch" 4
|
162
162
|
.IX Item "-N, --no-watch"
|
163
|
-
Disable \
|
163
|
+
Disable \fBinotify\fR\|(7) support on Linux systems
|
164
164
|
.IP "\-n, \-\-dry\-run" 4
|
165
165
|
.IX Item "-n, --dry-run"
|
166
166
|
Only print commands which would be sent to dtas-player
|
@@ -195,23 +195,23 @@ To change the way dtas-player calls ffmpeg (lightly-tested):
|
|
195
195
|
.Ve
|
196
196
|
.SH "ENVIRONMENT"
|
197
197
|
.IX Header "ENVIRONMENT"
|
198
|
-
\&\s-1VISUAL / EDITOR
|
198
|
+
\&\s-1VISUAL / EDITOR\s0 \- your favorite *nix text editor, defaults to 'vi' if unset.
|
199
199
|
.PP
|
200
|
-
\&\s-1DTAS_PLAYER_SOCK
|
200
|
+
\&\s-1DTAS_PLAYER_SOCK\s0 \- the path to the dtas-player control socket.
|
201
201
|
This defaults to ~/.dtas/player.sock
|
202
202
|
.SH "CONTACT"
|
203
203
|
.IX Header "CONTACT"
|
204
204
|
All feedback welcome via plain-text mail to: <mailto:dtas\-all@nongnu.org>
|
205
205
|
.PP
|
206
206
|
Mailing list archives available at <https://80x24.org/dtas\-all/>
|
207
|
-
and <
|
207
|
+
and <https://lists.gnu.org/archive/html/dtas\-all/>
|
208
208
|
.PP
|
209
209
|
No subscription is necessary to post to the mailing list.
|
210
210
|
.SH "COPYRIGHT"
|
211
211
|
.IX Header "COPYRIGHT"
|
212
|
-
Copyright 2013\-
|
212
|
+
Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
|
213
213
|
.PP
|
214
|
-
License: \s-1GPL\-3.0
|
214
|
+
License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
|
215
215
|
.SH "SEE ALSO"
|
216
216
|
.IX Header "SEE ALSO"
|
217
|
-
\&\
|
217
|
+
\&\fBdtas\-player\fR\|(1), \fBdtas\-player_protocol\fR\|(7), \fBdtas\-ctl\fR\|(1)
|
data/man/dtas-splitfx.1
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
.\" Automatically generated by Pod::Man
|
1
|
+
.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
|
2
2
|
.\"
|
3
3
|
.\" Standard preamble:
|
4
4
|
.\" ========================================================================
|
@@ -46,7 +46,7 @@
|
|
46
46
|
.ie \n(.g .ds Aq \(aq
|
47
47
|
.el .ds Aq '
|
48
48
|
.\"
|
49
|
-
.\" If the F register is
|
49
|
+
.\" If the F register is >0, we'll generate index entries on stderr for
|
50
50
|
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
51
51
|
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
52
52
|
.\" output yourself in some meaningful fashion.
|
@@ -56,12 +56,12 @@
|
|
56
56
|
..
|
57
57
|
.nr rF 0
|
58
58
|
.if \n(.g .if rF .nr rF 1
|
59
|
-
.if (\n(rF:(\n(.g==0)) \{
|
60
|
-
. if \nF \{
|
59
|
+
.if (\n(rF:(\n(.g==0)) \{\
|
60
|
+
. if \nF \{\
|
61
61
|
. de IX
|
62
62
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
63
63
|
..
|
64
|
-
. if !\nF==2 \{
|
64
|
+
. if !\nF==2 \{\
|
65
65
|
. nr % 0
|
66
66
|
. nr F 2
|
67
67
|
. \}
|
@@ -133,7 +133,7 @@
|
|
133
133
|
.\" ========================================================================
|
134
134
|
.\"
|
135
135
|
.IX Title "DTAS-SPLITFX 1"
|
136
|
-
.TH DTAS-SPLITFX 1 "1994-10-02" "dtas 0.
|
136
|
+
.TH DTAS-SPLITFX 1 "1994-10-02" "dtas 0.18.1" "dtas user manual"
|
137
137
|
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
138
138
|
.\" way too many mistakes in technical documents.
|
139
139
|
.if n .ad l
|
@@ -149,10 +149,10 @@ dtas-splitfx reads as \s-1YAML\s0 file and can apply effects (including
|
|
149
149
|
resampling/dither), split, tag, and encode files in parallel.
|
150
150
|
dtas-splitfx is intended for splitting recordings from vinyl and live
|
151
151
|
concerts into separate files. dtas-splitfx is inspired by cuesheets for
|
152
|
-
\&\s-1CD\s0 audio and the \
|
152
|
+
\&\s-1CD\s0 audio and the \fBmake\fR\|(1) build tool.
|
153
153
|
.PP
|
154
|
-
dtas-splitfx primarily uses \
|
155
|
-
to use \
|
154
|
+
dtas-splitfx primarily uses \fBsox\fR\|(1), but it is possible to define targets
|
155
|
+
to use \fBecasound\fR\|(1), too.
|
156
156
|
.SH "OPTIONS"
|
157
157
|
.IX Header "OPTIONS"
|
158
158
|
.IP "\-j, \-\-jobs [\s-1JOBS\s0]" 4
|
@@ -168,7 +168,12 @@ Silent operation, commands are not printed as executed
|
|
168
168
|
.IP "\-D, \-\-no\-dither" 4
|
169
169
|
.IX Item "-D, --no-dither"
|
170
170
|
Disable automatic setting of the \s-1DITHERFX\s0 env. This also passes
|
171
|
-
the option to \
|
171
|
+
the option to \fBsox\fR\|(1) via \s-1SOX_OPTS.\s0
|
172
|
+
.IP "\-E, \-\-err\-suffix \s-1SUFFIX\s0" 4
|
173
|
+
.IX Item "-E, --err-suffix SUFFIX"
|
174
|
+
Write the contents of \f(CW\*(C`stderr\*(C'\fR. This is useful for capturing
|
175
|
+
the per-track output of the \fBsox\fR\|(1) \f(CW\*(C`stats\*(C'\fR effect when
|
176
|
+
combined with parallel \f(CW\*(C`\-\-jobs\*(C'\fR.
|
172
177
|
.IP "\-O, \-\-outdir \s-1OUTDIR\s0" 4
|
173
178
|
.IX Item "-O, --outdir OUTDIR"
|
174
179
|
Set output directory instead of current directory.
|
@@ -177,7 +182,7 @@ User-created targets must allow a placeholder for the
|
|
177
182
|
in the output command.
|
178
183
|
.IP "\-C, \-\-compression \s-1FACTOR\s0" 4
|
179
184
|
.IX Item "-C, --compression FACTOR"
|
180
|
-
Set the compression factor passed to \
|
185
|
+
Set the compression factor passed to \fBsox\fR\|(1). See \fBsoxformat\fR\|(7)
|
181
186
|
for more information on how it works across different formats.
|
182
187
|
.IP "\-r, \-\-rate \s-1RATE\s0" 4
|
183
188
|
.IX Item "-r, --rate RATE"
|
@@ -196,7 +201,7 @@ argument are automatically expanded to spaces when passed to sox.
|
|
196
201
|
.IP "\-p, \-\-sox\-pipe" 4
|
197
202
|
.IX Item "-p, --sox-pipe"
|
198
203
|
Used in place of an output target to specify outputting audio data in
|
199
|
-
the native \*(L"sox\*(R" format to another \
|
204
|
+
the native \*(L"sox\*(R" format to another \fBsox\fR\|(1) or \fBplay\fR\|(1) command. This
|
200
205
|
moves printing of output to stderr and disables parallel job invocation.
|
201
206
|
.SH "FILE FORMAT"
|
202
207
|
.IX Header "FILE FORMAT"
|
@@ -237,7 +242,7 @@ highest-numbered track. Default: true
|
|
237
242
|
.ie n .IP "targets \- hash, see ""\s-1TARGETS""\s0 section" 4
|
238
243
|
.el .IP "targets \- hash, see ``\s-1TARGETS''\s0 section" 4
|
239
244
|
.IX Item "targets - hash, see TARGETS section"
|
240
|
-
.IP "command \- used only by \
|
245
|
+
.IP "command \- used only by \fBdtas\-player\fR\|(1)" 4
|
241
246
|
.IX Item "command - used only by dtas-player"
|
242
247
|
.PD
|
243
248
|
.SH "TRACKS"
|
@@ -248,14 +253,14 @@ segment.
|
|
248
253
|
.IP "t \s-1TIME TITLE\s0 [fade_in/fade_out=FADE_ARGS]" 4
|
249
254
|
.IX Item "t TIME TITLE [fade_in/fade_out=FADE_ARGS]"
|
250
255
|
The start of a new track
|
251
|
-
at \s-1TIME\s0 with \s-1TITLE
|
256
|
+
at \s-1TIME\s0 with \s-1TITLE.\s0 An optional fade_in and fade_out may be specified
|
252
257
|
for the first/last tracks.
|
253
|
-
.IP "skip \s-1TIME
|
258
|
+
.IP "skip \s-1TIME\s0 \- skip a segment starting at \s-1TIME\s0" 4
|
254
259
|
.IX Item "skip TIME - skip a segment starting at TIME"
|
255
260
|
\&\*(L"skip\*(R" segments are
|
256
261
|
useful for skipping long gaps between tracks (such as flipping vinyl
|
257
262
|
or intermission at concerts)
|
258
|
-
.IP "stop \s-1TIME
|
263
|
+
.IP "stop \s-1TIME\s0 \- stop the last track" 4
|
259
264
|
.IX Item "stop TIME - stop the last track"
|
260
265
|
This should be the last directive in the \*(L"tracks\*(R" array.
|
261
266
|
.PP
|
@@ -272,7 +277,7 @@ An example of the tracks array for a 4 track \s-1EP\s0 follows:
|
|
272
277
|
.Ve
|
273
278
|
.SH "FADES"
|
274
279
|
.IX Header "FADES"
|
275
|
-
dtas-splitfx automatically sets up fade\-in/fade\-out effects for \
|
280
|
+
dtas-splitfx automatically sets up fade\-in/fade\-out effects for \fBsox\fR\|(1)
|
276
281
|
based on track times. These are to be used in \*(L"t\*(R" (track) directives in
|
277
282
|
the \*(L"tracks\*(R" array:
|
278
283
|
.ie n .IP "fade_in=""[\s-1TYPE\s0] \s-1LENGTH""\s0" 4
|
@@ -284,51 +289,51 @@ the \*(L"tracks\*(R" array:
|
|
284
289
|
.IX Item "fade_out=[TYPE] LENGTH"
|
285
290
|
.PD
|
286
291
|
.PP
|
287
|
-
\&\s-1TYPE\s0 is optional, but \s-1LENGTH\s0 is required. See \
|
292
|
+
\&\s-1TYPE\s0 is optional, but \s-1LENGTH\s0 is required. See \fBsox\fR\|(1) for a description
|
288
293
|
of the fade type.
|
289
294
|
.SH "ENVIRONMENT"
|
290
295
|
.IX Header "ENVIRONMENT"
|
291
296
|
dtas-splitfx sets several default environment variables for commands to
|
292
297
|
use in targets:
|
293
|
-
.ie n .IP "\s-1INFILE
|
294
|
-
.el .IP "\s-1INFILE
|
298
|
+
.ie n .IP "\s-1INFILE\s0 \- this matches the ""infile"" directive in the \s-1YAML\s0 file" 4
|
299
|
+
.el .IP "\s-1INFILE\s0 \- this matches the ``infile'' directive in the \s-1YAML\s0 file" 4
|
295
300
|
.IX Item "INFILE - this matches the infile directive in the YAML file"
|
296
301
|
.PD 0
|
297
|
-
.IP "\s-1INDIR
|
302
|
+
.IP "\s-1INDIR\s0 \- the directory \s-1INFILE\s0 belongs to, without trailing slash" 4
|
298
303
|
.IX Item "INDIR - the directory INFILE belongs to, without trailing slash"
|
299
|
-
.IP "\s-1INBASE
|
304
|
+
.IP "\s-1INBASE\s0 \- the basename of \s-1INFILE\s0" 4
|
300
305
|
.IX Item "INBASE - the basename of INFILE"
|
301
|
-
.IP "\s-1TBEG
|
306
|
+
.IP "\s-1TBEG\s0 \- the integer sample offset where the \fBsox\fR\|(1) trim effect starts" 4
|
302
307
|
.IX Item "TBEG - the integer sample offset where the sox trim effect starts"
|
303
|
-
.IP "\s-1TLEN
|
308
|
+
.IP "\s-1TLEN\s0 \- the integer sample count representing the length of the trim" 4
|
304
309
|
.IX Item "TLEN - the integer sample count representing the length of the trim"
|
305
|
-
.IP "\s-1TRIMFX
|
310
|
+
.IP "\s-1TRIMFX\s0 \- essential" 4
|
306
311
|
.IX Item "TRIMFX - essential"
|
307
312
|
.PD
|
308
|
-
Supplies the necessary \
|
313
|
+
Supplies the necessary \fBsox\fR\|(1) trim effect to
|
309
314
|
each track. In other words, this is: \*(L"trim ${\s-1TBEG\s0}s ${\s-1TLEN\s0}s\*(R"
|
310
|
-
.IP "\s-1COMMENTS
|
315
|
+
.IP "\s-1COMMENTS\s0 \- expands to \-\-comment\-file=PATH for \fBsox\fR\|(1)" 4
|
311
316
|
.IX Item "COMMENTS - expands to --comment-file=PATH for sox"
|
312
317
|
.PD 0
|
313
|
-
.IP "\s-1OUTDIR
|
318
|
+
.IP "\s-1OUTDIR\s0 \- placeholder for \-\-outdir, defaults to an empty string" 4
|
314
319
|
.IX Item "OUTDIR - placeholder for --outdir, defaults to an empty string"
|
315
|
-
.ie n .IP "\s-1SUFFIX
|
316
|
-
.el .IP "\s-1SUFFIX
|
320
|
+
.ie n .IP "\s-1SUFFIX\s0 \- the suffix of the output format without ""."" (e.g. ""flac"", ""ogg"")" 4
|
321
|
+
.el .IP "\s-1SUFFIX\s0 \- the suffix of the output format without ``.'' (e.g. ``flac'', ``ogg'')" 4
|
317
322
|
.IX Item "SUFFIX - the suffix of the output format without . (e.g. flac, ogg)"
|
318
|
-
.IP "\s-1TRACKNUMBER
|
323
|
+
.IP "\s-1TRACKNUMBER\s0 \- the track number, useful for comments and filenames" 4
|
319
324
|
.IX Item "TRACKNUMBER - the track number, useful for comments and filenames"
|
320
|
-
.IP "\s-1RATEFX
|
325
|
+
.IP "\s-1RATEFX\s0 \- rate effect and arguments for \fBsox\fR\|(1) resampling" 4
|
321
326
|
.IX Item "RATEFX - rate effect and arguments for sox resampling"
|
322
|
-
.IP "\s-1DITHERFX
|
327
|
+
.IP "\s-1DITHERFX\s0 \- dither effect and arguments for \fBsox\fR\|(1) dithering" 4
|
323
328
|
.IX Item "DITHERFX - dither effect and arguments for sox dithering"
|
324
|
-
.IP "\s-1FX
|
329
|
+
.IP "\s-1FX\s0 \- any user-specified sox effects which encompases the entire file." 4
|
325
330
|
.IX Item "FX - any user-specified sox effects which encompases the entire file."
|
326
331
|
.PD
|
327
332
|
(e.g. \*(L"highpass 35 gain 3 stats\*(R")
|
328
333
|
.SH "TARGETS"
|
329
334
|
.IX Header "TARGETS"
|
330
335
|
The default targets will split audio and avoid applying any effects.
|
331
|
-
They are named after common audio formats supported by \
|
336
|
+
They are named after common audio formats supported by \fBsox\fR\|(1):
|
332
337
|
.IP "flac" 4
|
333
338
|
.IX Item "flac"
|
334
339
|
.PD 0
|
@@ -369,9 +374,9 @@ imbalance in a live concert recording from the audience:
|
|
369
374
|
.Ve
|
370
375
|
.SH "COPYRIGHT"
|
371
376
|
.IX Header "COPYRIGHT"
|
372
|
-
Copyright 2013\-
|
377
|
+
Copyright 2013\-2020 all contributors <mailto:dtas\-all@nongnu.org>
|
373
378
|
.PP
|
374
|
-
License: \s-1GPL\-3.0
|
379
|
+
License: \s-1GPL\-3.0+\s0 <https://www.gnu.org/licenses/gpl\-3.0.txt>
|
375
380
|
.SH "SEE ALSO"
|
376
381
|
.IX Header "SEE ALSO"
|
377
|
-
\&\
|
382
|
+
\&\fBsox\fR\|(1), \fBecasound\fR\|(1), \fBflac\fR\|(1), \fBdtas\-player\fR\|(1)
|