JACK-STDIN(1)						      General Commands Manual						     JACK-STDIN(1)

NAME

       jack-stdin - write JACK audio data to stdin

SYNOPSIS

       jack-stdin [OPTIONS] port1 [ port2 ...]

DESCRIPTION

       jack-stdin reads raw audio data from standard-input and writes it to a JACK audio port.

       The  number  of given ports detemine the number of audio channels that are used.  If more than one channel is given, the input audio-sample
       data needs to be interleaved.

OPTIONS

       -b, --bitdepth BITS
	      Specify the bit-depth of each sample. For integer-encoding this can be 16 or 24.	The default is 16.  This setting is only used  for
	      integer encoding: Floating-point samples will always be 32 bit wide.

       -d, --duration SEC
	      Specify  the time for which jack-stdin should run in seconds.  A value less than 1 means to run indefinitely. The default is 0 which
	      reads until end-of-file.

       -e, --encoding FORMAT
	      Set the input format of the data: signed-integer, unsigned-integer, floating-point (default: signed)

       -f, --file FILENAME
	      Read data from given file instead of standard-input.

       -h, --help
	      Print a brief usage information

       -p, --prebuffer PERCENT
	      Pre-fill the buffer before starting audio output to JACK (default 50.0%).  NOTE: disable pre-buffering (-p 0) or use a small  buffer
	      size to play back very short samples.

       -L, --little-endian
	      The input-data is in little-endian byte-order or native-byte-order float (this is the default)

       -B, --big-endian
	      Interpret input audio data in big-endian byte-order or swap the byte-order of floating-point.

       -q, --quiet
	      Inhibit usual output.  This affects information and buffer-overflow warnings but not setup-errors.

       -S, --bufsize SAMPLES
	      Choose the internal buffer-size in samples. The default size is 65536.  The given value will be multiplied by the number of channels
	      and bit-depth to get the size of the ring-buffer.  Note: the buffersize must be larger than JACK's period size.

EXAMPLES

	 jack-stdout vlc_31994:out_1 vlc_31994:out_2 
	    | sox -t raw -r 48k -e signed -b 16 -c 2 - 
		  -t raw -r 48k -e signed -b 16 -c 2 - 
	       tremolo 5 100 
	    | ./jack-stdin system:playback_1 system:playback_2

	 cat /dev/dsp 
	    | jack-stdin system:playback_1 system:playback_2

KNOWN ISSUES

       jack-stdin is not suitable to play-back files shorter than twice the jack-period size.

AUTHOR

       Robin Gareus <robin@gareus.org>.

SEE ALSO

       http://jackaudio.org/,

								   30 March 2011						     JACK-STDIN(1)