dtas.git  about / heads / tags
duct tape audio suite for *nix
$ git log --pretty=format:'%h %s (%cs)%d' v0.2.0 --
defbf90 dtas 0.2.0 - minor bugfixes and packaging cleanups (2013-08-28)
	(tag: v0.2.0)
a738d4f add license/copyright headers/footers to all files (2013-08-28)
cd6065b doc: protocol: question source ed tryorder, minor edits (2013-08-28)
e37e3d8 doc: cleanup makefile formatting/naming (2013-08-28)
d291980 Rakefile: use git set-file-times for consistent mtimes (2013-08-27)
0d4cafa doc: dtas-player_protocol: note proposed revamp (2013-08-27)
4679d5f doc: add more examples to dtas-player_sink_examples (2013-08-27)
3f8e20d av_ff_common: zero samples on streams of unknown length (2013-08-27)
ddcd67c doc: dtas-player_sink_examples manpage (2013-08-27)
0d3fe1c player: fix sink auto-restart on "sink ed" changes (2013-08-27)
...

$ git cat-file blob v0.2.0:README
# 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)

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

All scripts have some documentation in the Documentation/ directory or
manpages distributed with the gem.  Documentation is also available on
http://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
* tracklist support in dtas-player (maybe?)
* 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.

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

## Contact

Feedback (results, bug reports, patches, pull-requests) via plain-text
email is very much appreciated.

Please send plain-text email to Eric Wong <normalperson@yhbt.net>.
HTML will not be read.  dtas is for GUI-phobes, by GUI-phobes.
Public mailing list coming soon.

## Copyright

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 https://www.gnu.org/licenses/gpl-3.0.txt

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.

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.

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       dtas-splitfx: add --stats/-S switch (2024-02-01)
  mpd          mpd: beginnings of list support (2016-01-22)
  0.12.x-stable Rakefile: add Atom feed to website (2015-12-14)
  tfx-pu       buffer: allow limiting the amount of bytes output (2015-02-04)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v0.21.0      dtas 0.21.0 (2022-09-06) tar.gz
v0.20.0      dtas 0.20.0 - ruby 3.1+ compatibility, splitfx improvements (2022-02-03) tar.gz
v0.19.0      dtas 0.19.0 - odd pathname fixes (2021-09-05) tar.gz
v0.18.1      dtas 0.18.1 (2021-02-13) tar.gz
v0.18.0      dtas 0.18.0 (2020-02-03) tar.gz
v0.17.0      dtas 0.17.0 (2019-11-14) tar.gz
v0.16.1      dtas 0.16.1 (2019-01-02) tar.gz
v0.16.0      dtas 0.16.0 (2019-01-02) tar.gz
v0.15.0      dtas 0.15.0 (2017-04-07) tar.gz
v0.14.2      dtas 0.14.2 - several bugfixes (2016-03-18) tar.gz
...

# associated public inboxes:
# (number on the left is used for dev purposes)
            https://80x24.org/dtas-all

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