about summary refs log tree commit homepage
DateCommit message (Collapse)
2015-05-21splitfx: simplify output display
No point in executing echo and wasting CPU cycles. We'll only waste cycles now during dry-runs
2015-05-20splitfx: documentation for subclasses
2015-05-20splitfx: drop unnecessary variable
We no longer use it since commit 7b47191aa4c88b3daa4c980013f0047cb7ae7f6d ("splitfx: avoid double-truncation with user command")
2015-05-19source/splitfx: allow watching extra external scripts
Since writing nested shell commands inside YAML is subject to all sorts of strange quoting rules, encourage users to rely on external scripts which the YAML file refers to instead. These scripts can be written in any reasonable scripting language capable of executing other commands. This allows transparently monitoring things such as `my-script.rb' in the below example when playing my-splitfx.yml via dtas-player: --------------------- my-splitfx.yml ----------------------- infile: input.flac command: $INDIR/my-script.rb "$INFILE" ... --------------------- my-script.rb -------------------------- #!/usr/bin/ruby require 'shellwords' infile = ARGV.shift ch = %W(sox #{infile} -p).concat((ENV['TRIMFX'] || '').shellsplit) fx = %W(highpass 25 gain 9) l = ch.dup.concat(%W(remix 1v1)).concat(fx).concat(%w(contrast 30)) r = ch.dup.concat(%W(remix 2v1)).concat(fx).concat(%w(contrast 0)) cmd = %W(sox -M |#{l.shelljoin} |#{r.shelljoin}) cmd.concat((ENV['SOXFMT'] || '-p').shellsplit) cmd.concat(%w(- stats)) warn cmd.inspect exec *cmd
2015-05-19splitfx: avoid double-truncation with user command
It's probably harmless as the sub (second) command is usually innocuous as fars a modifying dynamic range, but it makes the command-line output confusing.
2015-05-19dtas-console: bind "o" to display time in absolute seconds
It can be useful to display time as absolute seconds to ease arithmetic for tracking files.
2015-05-18splitfx: remove support for encoding opus
Lossy file encoding has too many tunable variables and it is not a good fit for an audio production tool such as dtas-splitfx. This was becoming a maintenance burden for me and is a sign of featuritis.
2015-05-18splitfx: show correct command for output
2015-05-17process: implement array expansion to preserve spaces
This can make it easier to specify mcompand parameters in socks, as those require separate levels of parameter parsing and require quoting in shell.
2015-05-17dtas-splitfx: support --trim argument
It can often be useful to expose only part of a track for quick inspection. This lets us do that.
2015-05-17dtas-splitfx: no arguments for quiet and --no-dither
2015-05-17use monotonic clock on Ruby 2.1+
The monotonic clock is immune to stepping adjustments so it is more suitable for tracking elapsed time differences. Process.clock_gettime also generates less garbage on 64-bit systems due to the use of Flonum.
2015-05-10splitfx: fix non-generic, user-specified targets
Regression appeared in the previous commit, oops. commit ab63c7bb1b69423f8c39a60dd00230c560eecfc4 (splitfx: fix lossy output with player command is in use)
2015-05-10splitfx: fix lossy output with player command is in use
We must ensure lossy encodings do not get lossily-encoded twice, only once at the final stage. There is no effect for lossless outputs as lossless is the common case for splitfx users.
2015-05-10INSTALL: update documentation for 0.11.0 release
2015-05-10dtas 0.11.0 - bugfixes and splitfx features v0.11.0
dtas-player: There is one dtas-player bugfix to fix an infinite loop on missing files when repeating a single track. commit b6515b3a8abab6dcc56166da825e01e2c083bfc9 ReplayGain also uses the "gain" effect instead of "vol", allowing compatibility with "gain -h" to provide extra headroom in user effects. commit 403ed90e2e7bed3e017938d76e17037b0d5059b6 dtas-splitfx: Dither is no longer applied when outputting bit-depths above 16-bit. The --bits/-b/--rate/-r/-C/--compression command-line flags are passed to sox(1) for output and allow overriding any targets specified in the output. commit e6a2ff2a3984320b1b83f5051709880a8b9d3708 commit 03b1303b1c7511fdd1a6b2f63d7c509e822a6a38) The -O/--outdir switch allows specifying a different output directory, useful for splitting from read-only checkouts or to a faster tmpfs filesystem to avoid SSD wear. commit 619b08c9d4e43d94bac39cd395c1def6fa796f06 dtas-splitfx is still a work-in-progress and rapidly improving :)
2015-05-10splitfx: --bits and --rate for quick-n-dirty generic targets
generic targets (e.g. "wav") is useful for quickly checking if clipping is introduced by dither and resampling, so we'll support changing the sample rate and bits-per-sample from the command-line so users don't need to setup their own targets or wait on FLAC encoding.
2015-05-10splitfx: pass compression factor to sox(1)
This can be useful for speeding up splitfx during development, as sox defaults to maximum compression with FLAC and that is extremely slow.
2015-05-10doc: favor the "gain" effect over "vol"
Followup-to commit 403ed90e2e7bed3e017938d76e17037b0d5059b6 (replaygain uses the "gain" effect instead of "vol") The `gain' effect seems superior as it can "see" across the effects chain to take into account extra/lost headroom.
2015-05-10splitfx: support -O/--outdir switch to control output dir
It is useful to force output to a writable directory if the YAML file is on a read-only mount point or to force the output to a large tmpfs mount point to avoid SSD/HDD wear.
2015-05-10splitfx: fix typo for dither application
We do not need to dither unless we output to 16-bit or less. This bug caused us to unnecessarily apply dither on 24-bit output files. Oops!
2015-05-10tracklist: fix inf loop on ENOENT with repeat==1
If a file is missing, we must not respect the repeat option set by the user to avoid infinite looping
2015-05-07replaygain uses the "gain" effect instead of "vol"
The `gain' effect seems superior as it can "see" across the effects chain to take into account extra/lost headroom. For example, this allows me to add the the "gain -h" effect at the start of my effects chain before the RGFX placeholder in my source command, so when I play a file requiring a -6dB ReplayGain adjustment, I will only need an additional -4dB of headroom to accomodate the 10dB boost at 20Hz I use (for listening through headphones): Before: RGFX='vol -6dB' sox "$INFILE" $SOXFMT - $TRIMFX $RGFX vol -10dB equalizer 20 0.7071q 10 After: RGFX='gain -6' sox "$INFILE" $SOXFMT - $TRIMFX gain -h $RGFX equalizer 20 0.7071q 10
2015-04-13Rakefile: use version sort for NEWS file
Otherwise it's not very readable since our version numbers are no longer lexographically sortable.
2015-04-13dtas 0.10.0 - major features and small fixes v0.10.0
Bug fixes: * Exported INFILE environment variable is always shell-escaped This prevent screw-ups when users are using funky filenames. * dtas-player: enqueued commands cannot use audio format bypass (the audio format cannot be known ahead-of-time from raw commands) * YAML omap (ordered map) is explicitly used for all env hashes for user editing. Normal (unordered hashes) are still allowed if loading existing files. This does not affect Ruby 1.9+ users, but allows easier processing for users of other languages. New features (all platforms): * dtas-player now plays dtas-splitfx YAML files support cue sheet emulation based on the track list. Under Linux[1], changes to the YAML file are reflected in real-time as the file is edited and saved in an $EDITOR. This feature is useful for dialing in EQ, compressor, and limiter effects on tracks. * dtas-player supports the "source restart" command for restarting playback on modified files for systems without inotify support. * dtas-splitfx now exports the INDIR and INBASE environment variables which are intended to act like `$(@D)' and `$(@F)' in GNU make(1). It should ease managing temporary files for some effects (e.g. noiseprof + noisered in sox) * dtas-console supports '!' and '@' hotkeys keys for moving within files with embedded cue sheets. * dtas-player supports the "trim" command to focus on a particular portion of a track. It may be useful when combined with the existing "tl repeat" command for dialing in audio editing parameters (via a splitfx YAML file): To continuously repeat a 5 second part of the current track starting at 1 minute into the track: dtas-ctl tl repeat 1 && dtas-ctl trim 1:00 5 Passing "off" as the parameter disables trim: dtas-ctl trim off * dtas-env(7) manpage added for common environment variables across the suite * dtas-sinkedit shows default parameters in addition to user-changed parameters New features (Linux-only) * dtas-sourceedit and dtas-sinkedit support inotify[1] when editing the YAML text file. This allows real-time updates on $EDITOR file save as the user edits the parameters of the commands used for decoding and playback. * dtas-archive - paranoid archival script for copying and (re-reading) files. This is useful when transferring files from removable devices to computers without ECC memory (or any other bit errors in transport before main memory is accessed). This requires Ruby 1.9.3 or later (no 3rd-party RubyGems) on Linux for IO#advise support. There are also many internal cleanups and more work-in-progress for dtas-splitfx features. [1] feature requires the sleepy_penguin RubyGem to be installed.
2015-04-13doc: update for dtas-sinkedit inotify support
New features need to be documented.
2015-04-13cleanup: avoid redundant Array conversion for escapes
We already convert xs arg to be an Array, so avoid bloating our code with redundancy.
2015-04-13escape INFILE and related environment variables
We may expand them, so ensure they're properly escaped, first for use in shell snippets.
2015-04-13xs: allow taking a string as input
This allows us to avoid unnecessary Array conversions in call sites
2015-04-12dtas-sinkedit: catch up to inotify/pipe changes in sourceedit
This is mainly for consistency in behavior with dtas-sourceedit. Using dtas-sourcedit is still more common and recommended as it is less likely to introduce audible gaps and pauses.
2015-04-07dtas-archive: paranoid archival script
This archives audio files (typically .wav from a portable devices) as FLAC and performs a best-effort verification the file was transferred succesfully without bit errors by dropping kernel caches and rechecking the result.
2015-02-13source/common: document dst_zero_byte attr
For seeking, the name might be a little confusing, but this is zero relative to the current queued source.
2015-02-04buffer: allow limiting the amount of bytes output tfx-pu
This will aid in allowing us to create effects which affect only a certain part of a track.
2015-02-04buffer/splice: prepare for IO::Splice::WAITALL removal
This feature in the io_splice was probably a bad idea and slated for removal at some point in the future. Anyways, do not rely on it since it is undocumented.
2015-02-04fadefx: effects chain generation
We need to generate a coherent command set for wrapping portions together, this sets us up for that.
2015-01-28player: fix queue skipping on player errors
Oops, introduced in the previous commit: commit 37eae22446feb5a805d9cd59f6ad54362829189f (player: support the "trim" parameter)
2015-01-28player: support the "trim" parameter
This feature is intended to allow users to "zoom-in" on a particular portion of a track to tweak parameters (either with dtas-sourceedit(1) or via playback of splitfx YAML files). This may be combined with looping the tracklist (via "tl repeat").
2015-01-25use omap (ordered map) for env hashes
While the Ruby Hash class is ordered in 1.9+, the YAML specifications do not specify hashes as ordered by default. Thus we must explicitly declare ordering via !omap for interopability with non-Ruby tools. This makes the YAML output of dtas-sourcedit and dtas-sinkedit slightly more verbose Users of dtas-splitfx are also encouraged to declare !omap when creating their YAML files for interoperability. Ordering env is important because any implementation of built-in variable expansion is dependent on it.
2015-01-23watchable: simplify check
@on_readable is always set, so there's no point in checking it again when we need to call it.
2015-01-23sourcedit: do not wait indefinitely if $EDITOR is stopped
Users may hit Ctrl-Z to stop their editor during editing and trigger SICHLD, do not waitpid2 indefinitely in that case. This prevents missed "source ed" calls for inotify users.
2015-01-20rename the TrimFX class to TFX
TrimFX was too ambiguous with the common environment variable we use throughout dtas. Since TFX is more limited in scope but should be more frequently-typed by users (of -splitfx) we'll use the shorter name here.
2015-01-20doc: describe most classes a bit
Hopefully this makes the code less daunting to newcomers
2015-01-20drop Rubinius workaround
I'm done with dealing with proprietary bug trackers.
2015-01-19update copyright years and links to mailing list archives
The documentation part is managed by the new Documentation/update-copyright script. For the future, the rest may be managed by the update-copyright tool in gnulib
2015-01-19Revert "fadefx: remove module"
This reverts commit 3471463325be6c990b3abd18b4d34f723440d19a. While not strictly necessary, it makes the user syntax in splitfx files much terser. Changes from the original version should make it easier-to-read and the diagram should help a lot with understanding.
2015-01-19consolidate spawn fix for Ruby [Bug #8770]
Ensure we can apply the workaround to dtas-sourceedit and our test cases while also simplifying the existing call sites a little. This will also make for less code churn in 3-5 years down the line when we drop <= 2.1 support.
2015-01-19avoid aliasing global "spawn" method
This makes debugging, grepping, and following code confusing at times and also unexpected breaks usage of the global "spawn" method.
2015-01-19splitfx: export TBEG and TLEN variables
These are the raw sample counts for the "trim" effect and may be useful for arithmetic in the shell.
2015-01-19doc: 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.
2015-01-19sinkedit: flesh out all parameters
dtas-sinkedit now shows default parameters in addition to user-changed parameters, allowing easier editing. Also, we need to be able to revert back to using the default pipe_size on Linux by setting pipe_size to nil (as an empty field in YAML).