command: add command "getfingerprint"

A first use case for our libchromaprint integration added by commit 30e22b753b
2019-04-05 12:38:49 +02:00
parent 17dd334b82
commit 8e5e97bfed
6 changed files with 420 additions and 0 deletions
--- a/doc/protocol.rst
+++ b/doc/protocol.rst
@@ -824,6 +824,17 @@ The music database
    don't this group tag.  It exists only if at least one such song is
    found.

+:command:`getfingerprint {URI}`
+
+    Calculate the song's audio fingerprint.  Example (abbreviated fingerprint)::
+
+      getfingerprint "foo/bar.ogg"
+      chromaprint: AQACcEmSREmWJJmkIT_6CCf64...
+      OK
+
+    This command is only available if MPD was built with
+    :file:`libchromaprint` (``-Dchromaprint=enabled``).
+
 .. _command_find:

 :command:`find {FILTER} [sort {TYPE}] [window {START:END}]`