# dtas - duct tape audio suite for *nix

Free Software command-line tools for audio playback, mastering, and whatever else related to audio. dtas follows the worse-is-better philosophy and acts as duct tape to combine existing command-line tools for flexibility and ease-of-development. dtas is currently implemented in Ruby (and some embedded shell), but may use other languages in the future.

Primary executables available are:

  • dtas-player - gapless music player (or pipeline/process manager :P)

  • dtas-cueedit - embedded cuesheet editor (FLAC-only for now)

  • dtas-splitfx - split audio and apply effects to all tracks

The centerpiece is dtas-player, a gapless music player designed to aid in writing scripts for sox/ecasound use. Unlike monolithic music players, dtas-player is close to a *nix shell in functionality, allowing for the execution of arbitrary commands as sources, filters, and sinks for audio. dtas-player supports:

  • any DSP effects offered by SoX, ecasound, LADSPA, LV2, etc..

  • multiple outputs for playback (including dumping audio to files or piping to arbitrary commands)

  • ReplayGain (including fallback gain and peak normalization)

dtas-player is a *nix pipeline and process manager. It may be used spawn and pipe to abitrary Unix commands, not just audio-related commands. It can interactively restart/replace the source (audio decoder) component of a pipeline while keeping the sink (playback endpoint) running.

Users of dtas-player will also be interested in the following scripts:

  • dtas-ctl - “raw” command-line scripting interface for dtas-player

  • dtas-enq - enqueue files/commands for dtas-player

  • dtas-msinkctl - enable/disable multiple sinks with one command

  • dtas-console - rudimentary curses interface for dtas-player

  • dtas-sinkedit - edit sinks (playback targets) for dtas-player

  • dtas-sourceedit - edit source (decoder process parameters) for dtas-player

  • dtas-xdelay - alternative sink for dtas-player

  • dtas-tl - command-line helpers for tracklist functionality in dtas-player

All scripts have some documentation in the Documentation/ directory or manpages distributed with the gem. Documentation is also available on dtas.80x24.org/$COMMAND.txt in plain-text form.

dtas exposes no public APIs outside of command-line and YAML text. dtas is aimed at users familiar with the *nix command-line and editing text files. Familiarity with the Ruby programming language is absolutely NOT required.

Coming:

  • MPRIS/MPRIS 2.0 bridge for partial dtas-player control

  • whatever command-line tools come to mind…

  • better error handling, many bugfixes, etc…

  • better documentation

## Source code

git clone git://80x24.org/dtas

Please use git-format-patch(1) and git-send-email(1) distributed with the git(7) suite for generating and sending patches. Please format pull requests with the git-request-pull(1) script (also distributed with git(7)) and send them via email to <[email protected]>.

See www.git-scm.com/ for more information on git.

## Contact

All feedback (comments, results, feature requests, bug reports, patches, pull-requests) via plain-text mail to the mailing list is very much appreciated.

Please send plain-text mail to the list at <[email protected]>\ HTML will not be read. dtas is for GUI-phobes, by GUI-phobes.\ Mailing list archives available at <lists.gnu.org/dtas-all> or <80x24.org/dtas-all/> No subscription is necessary to post to the mailing list.

## Copyright

Copyright 2013-2014, Eric Wong <[email protected]> and all contributors.\ License: GPLv3 or later <www.gnu.org/licenses/gpl-3.0.txt>

dtas is copyrighted Free Software by all contributors, see logs in revision control for names and email addresses of all of them.

dtas is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

dtas is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see www.gnu.org/licenses/gpl-3.0.txt

Note: The GPL does not and can not apply to external commands run by dtas scripts, so users may run any non-Free Software you want via dtas (just like one may do so via bash). However, the dtas project does not endorse nor support the use of any non-Free Software.