pcmprint

commit 6d0a9b8859219f11f2cf1a2c73a798730ef416e2
parent e0212198dd7ab453a0616bdeda6a395a1811f204
Author: zavok <an2qzavok@gmail.com>
Date:   Tue, 19 Mar 2019 15:48:23 +0300

readme

Diffstat:
A
README.md
 | 
22
++++++++++++++++++++++

1 file changed, 22 insertions(+), 0 deletions(-)
diff --git a/README.md b/README.md
@@ -0,0 +1,22 @@
+Pcmprint, as the name suggests, prints PCM data to stdout in what
+could be considered human-readable form.
+
+Input data is assumed to be in "CD-Audio" format, i.e signed 16-bit
+integer, little-endian, stereo, 44100 samplerate.
+
+You can use it, for example, for live view of music wavform:
+
+* with sndio:
+	tee /dev/audio0 < music.pcm | pcmprint
+* with aplay:
+	mkfifo /tmp/fifo
+	(tee /tmp/fifo < music.pcm | pcmrpint)&
+	aplay -f cd < /tmp/fifo
+
+Features considered and rejected:
+---------------------------------
+
+* more than 2 levels of "intensity"
+* using non-ASCII characters for output
+* automatic width setting
+* configurable input format