summaryrefslogtreecommitdiff
path: root/nncmpp.adoc
diff options
context:
space:
mode:
authorPřemysl Eric Janouch <p@janouch.name>2021-07-03 23:58:05 +0200
committerPřemysl Eric Janouch <p@janouch.name>2021-07-05 01:10:46 +0200
commita439a56ee9c4cbf92817bd5bd1c89c59c4e5964b (patch)
treea3aace0b50fe1662a05833817d1cf64a1b293646 /nncmpp.adoc
parent120a11ca1b4644d9761ebba2e0341cf59411cf89 (diff)
downloadnncmpp-a439a56ee9c4cbf92817bd5bd1c89c59c4e5964b.tar.gz
nncmpp-a439a56ee9c4cbf92817bd5bd1c89c59c4e5964b.tar.xz
nncmpp-a439a56ee9c4cbf92817bd5bd1c89c59c4e5964b.zip
Add an optional spectrum visualiser
This is really more of a demo. It's doable, just rather ugly. It would deserve some further tuning, if anyone cared enough.
Diffstat (limited to 'nncmpp.adoc')
-rw-r--r--nncmpp.adoc22
1 files changed, 22 insertions, 0 deletions
diff --git a/nncmpp.adoc b/nncmpp.adoc
index fd4f888..0909dd3 100644
--- a/nncmpp.adoc
+++ b/nncmpp.adoc
@@ -55,6 +55,7 @@ colors = {
odd = ""
selection = "reverse"
multiselect = "-1 6"
+ defocused = "ul"
scrollbar = ""
}
streams = {
@@ -70,6 +71,27 @@ schemes in the _contrib_ directory.
// TODO: it seems like liberty should contain an includable snippet about
// the format, which could form a part of nncmpp.conf(5).
+Spectrum visualiser
+-------------------
+When built against the FFTW library, *nncmpp* can make use of MPD's "fifo"
+output plugin to show the audio spectrum. This has some caveats, namely that
+it may not be properly synchronized, only one instance of a client can read from
+a given named pipe at a time, it will cost you some CPU time, and finally you'll
+need to set it up manually to match your MPD configuration, e.g.:
+
+....
+settings = {
+ ...
+ spectrum_path = "~/.mpd/mpd.fifo" # "path"
+ spectrum_format = "44100:16:2" # "format" (samplerate:bits:channels)
+ spectrum_bars = 8 # beware of exponential complexity
+ ...
+}
+....
+
+The sample rate should be greater than 40 kHz, the number of bits 8 or 16,
+and the number of channels doesn't matter, as they're simply averaged together.
+
Files
-----
*nncmpp* follows the XDG Base Directory Specification.