about summary refs log tree commit homepage
path: root/Documentation/dtas-env.txt
blob: 8cbbd0ad5d5c909d4fc094a21a4d52658ad033fc (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
% dtas-env(7) dtas user manual
%

# NAME

dtas-env - environment variables used through DTAS

# DESCRIPTION

As dtas uses Bourne shell and exposes it to users, dtas should have
a cohesive set of common environment variables across its audio
production and playback environments.  This attempts to document
them.  Most of these environments are set and managed by dtas
itself, but users editing commands (e.g. via dtas-sourcedit(1)
should be aware of them.

# ENVIRONMENT

ECAFMT - an snippet of command-line switches for ecasound describing
audio format parameters (such as word length, channels, sample rate),
see dtas-player_protocol(7) for more info. (e.g. "-fs32_le,2,44100")

INFILE - the primary input file for playback or processing.
(e.g. "/path/to/ex.flac")

RGFX - the sox effect used for applying ReplayGain compensation.
Only used during playback in dtas-player.  (e.g. "gain -6.0").
Removing this prevents ReplayGain from working and may damage
playback equipment with loudly mastered music.

SOXFMT - an snippet of command-line switches for sox describing
audio format parameters (such as word length, channels, sample rate),
see dtas-player_protocol(7) for more info. (e.g. "-ts32 -c2 -r44100")

TRIMFX - the sox effect used for seeking during playback with dtas-player
and track offsets for dtas-splitfx.  (e.g. "trim 36000s")

Additionally, dtas-splitfx(1) documents more environment variables
which are not used elsewhere.

# ENVIRONMENT FOR OTHER EXECUTABLES

By virtue of running other programs, dtas indirectly uses many
commonly-accepted environment variables such as EDITOR / VISUAL for
selecting a text editor, and SOX_OPTS, AUDIODEV, AUDIODRIVER for sox(1)
and play(1) commands and LADSPA_PATH for anything using LADSPA plugins
(including sox).  The TMPDIR environment variable controls where
temporary files are placed for most programs.

# CONTACT

All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
Mailing list archives available at <http://80x24.org/dtas-all/> and
<ftp://lists.gnu.org/dtas-all/>\
No subscription is necessary to post to the mailing list.

# COPYRIGHT

Copyright 2015-2016 all contributors <dtas-all@nongnu.org>.\
License: GPL-3.0+ <http://www.gnu.org/licenses/gpl-3.0.txt>