audioloom/README.md

53 lines
1.4 KiB
Markdown

# audioloom
![Image showing waveforms of two tracks interweaved together with audioloom](./img/audioloom.jpg)
Interweave slices of audio files together using sox
--------
## Requirements
Node.js 0.8.x +
This script requires `node.js` as the runtime and `sox` to export and stitch audio back together.
Installation instructions for sox here: https://sourceforge.net/projects/sox/files/sox/
## Installation
```
git clone https://github.com/sixteenmillimeter/audioloom.git
cd audioloom
npm install
chmod +x audioloom
```
## Basic Usage
```./audioloom -i /path/to/audio1:/path/to/audio2 -o /path/to/output```
## Options
Run `./audioloom -h` to display help screen.
```
Usage: audioloom [options]
Options:
-V, --version output the version number
-i, --input [files] Specify input audio files with paths seperated by colon
-o, --output [file] Specify output path of audio file
-p, --pattern [pattern] Specify a pattern for the alternating 1:1 is standard
-r, --realtime Specify if audio files should preserve realtime speed
-t, --tmp [dir] Specify tmp directory for exporting slices
-m, --ms [ms] Specify length of slices using length in milliseconds, will default to 1/24 sec
-R, --random Randomize slices. Ignores pattern if included
-h, --help output usage information
```
## TODO
* Generate example audiofiles automatically
* Publish example audio files