.TH dtas-sourceedit 1 "" "dtas user manual"
.SH NAME
.PP
dtas-sourceedit - edit parameters of a source decoder
.SH SYNOPSYS
.PP
dtas-sourceedit {sox | av | ff}
.SH DESCRIPTION
.PP
dtas-sourceedit spawns an editor to allow editing of a source as a YAML
file.
See dtas-player_protocol(7) for details on SOURCEARGS.
If standard input is a pipe or file, it is parsed as YAML and fed to the
dtas-player(1) instance non-interactively.
This is useful for loading various profiles from the filesystem.
.PP
On Linux machines with the sleepy_penguin RubyGem installed, inotify(7)
is used to monitor the file for changes while the text exitor is
running.
Each time a user finishes saving a file, changes are committed
immediately.
This behavior may be disabled by using the -N or --no-watch command-line
switch.
.SH OPTIONS
.TP
.B -N, --no-watch
Disable inotify(7) support on Linux systems
.RS
.RE
.TP
.B -n, --dry-run
Only print commands which would be sent to dtas-player
.RS
.RE
.TP
.B -V, --verbose
Print out commands as they are sent to dtas-player
.RS
.RE
.SH EXAMPLES
.PP
Invoking dtas-sourceedit will spawn your favorite text editor on "sox":
.IP
.nf
\f[C]
$\ dtas-sourceedit\ sox
\f[]
.fi
.PP
To load an existing YAML profile for sox.
saved.yml could be the output of a previous "dtas-ctl source cat sox"
invocation:
.IP
.nf
\f[C]
$\ dtas-sourceedit\ sox\ <\ saved.yml
\f[]
.fi
.PP
To change the way dtas-player calls avconv (part of libav):
.IP
.nf
\f[C]
$\ dtas-sourceedit\ av
\f[]
.fi
.PP
To change the way dtas-player calls ffmpeg (lightly-tested):
.IP
.nf
\f[C]
$\ dtas-sourceedit\ ff
\f[]
.fi
.SH ENVIRONMENT
.PP
VISUAL / EDITOR - your favorite *nix text editor, defaults to
\[aq]vi\[aq] if unset.
.PP
DTAS_PLAYER_SOCK - the path to the dtas-player control socket.
This defaults to ~/.dtas/player.sock
.SH CONTACT
.PP
All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>
.PD 0
.P
.PD
Mailing list archives available at <http://80x24.org/dtas-all/> and
<ftp://lists.gnu.org/dtas-all/>
.PD 0
.P
.PD
No subscription is necessary to post to the mailing list.
.SH COPYRIGHT
.PP
Copyright 2013-2016 all contributors <dtas-all@nongnu.org>.
.PD 0
.P
.PD
License: GPL-3.0+ <http://www.gnu.org/licenses/gpl-3.0.txt>
.SH SEE ALSO
.PP
dtas-player(1), dtas-player_protocol(7), dtas-ctl(1)