From 72977765a3c30f2a8a89ccbf23fde8289c81bdf9 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 19 Jan 2015 07:05:00 +0000 Subject: doc: dtas-env(7) manpage for environment vars This rounds out the documentation a bit and hopefully introduces/encourages some commonality between the playback and processing/production components of dtas. Clarify some splitfx-related environment variables while we're at it. --- Documentation/dtas-env.txt | 60 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 Documentation/dtas-env.txt (limited to 'Documentation/dtas-env.txt') diff --git a/Documentation/dtas-env.txt b/Documentation/dtas-env.txt new file mode 100644 index 0000000..e081b7a --- /dev/null +++ b/Documentation/dtas-env.txt @@ -0,0 +1,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. "vol -6.0dB"). +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 \ +Mailing list archives available at +and \ +No subscription is necessary to post to the mailing list. + +# COPYRIGHT + +Copyright 2015, all contributors .\ +License: GPLv3 or later -- cgit v1.2.3-24-ge0c7