Support individual historic listens submittion.

[musicbrainz.git] / README.org

diff --git a/README.org b/README.org
index 686475f8481f396c1a501ad9b90a601c3b1eec7e..fd27076805ba3d17b9cb8259e1684ebd24384f33 100644 (file)
--- a/README.org
+++ b/README.org
@@ -3,6 +3,21 @@
 #+author:
 #+title:  MusicBrainz & ListenBrainz & others
 
+- [[#musicbrainz][MusicBrainz]]
+    - [[#musicbrainz-api][MusicBrainz API]]
+    - [[#searching--browsing][searching & browsing]]
+    - [[#some-examples][some examples]]
+    - [[#cover-art][cover art]]
+    - [[#mbid][MBID]]
+    - [[#ambiguity][ambiguity]]
+    - [[#incompleteness][incompleteness]]
+- [[#listenbrainz][ListenBrainz]]
+    - [[#listening][listening]]
+    - [[#examples][examples]]
+    - [[#incompleteness-1][incompleteness]]
+- [[#otherbrainz][otherBrainz]]
+- [[#further][further]]
+
 * MusicBrainz
 
 [[file:img/musicbrainz-logo.svg]]
@@ -89,6 +104,25 @@ The MBID can be used for specific lookups (and checked if needed using =musicbra
 |  91 | Universal Music | plain logo: “Universal Music” (ongoing)                                                               | [[https://musicbrainz.org/label/13a464dc-b9fd-4d16-a4f4-d4316f6a46c7][13a464dc-b9fd-4d16-a4f4-d4316f6a46c7]] |
 |  90 | ZYX Music       | (1992 ongoing)                                                                                        | [[https://musicbrainz.org/label/6844efda-a451-431e-8cc1-48ab111b4711][6844efda-a451-431e-8cc1-48ab111b4711]] |
 
+** cover art
+
+Cover art for a release may be available from the [[http://coverartarchive.org/][Cover Art Archive]] and can be accessed via the [[https://musicbrainz.org/doc/Cover_Art_Archive/API][API]]
+
+#+BEGIN_SRC emacs-lisp
+(musicbrainz-coverart "a929130a-535c-4827-8663-f048e1a7ca0d")
+#+END_SRC
+
+
+#+BEGIN_SRC emacs-lisp
+(musicbrainz-coverart-front "a929130a-535c-4827-8663-f048e1a7ca0d")
+#+END_SRC
+
+
+#+BEGIN_SRC emacs-lisp
+(musicbrainz-lookup-release "a929130a-535c-4827-8663-f048e1a7ca0d")
+#+END_SRC
+
+ | Head Cleaning Cassette | Cassette Case | [[https://musicbrainz.org/release/a929130a-535c-4827-8663-f048e1a7ca0d][a929130a-535c-4827-8663-f048e1a7ca0d]] |
 
 ** MBID
 
@@ -104,6 +138,7 @@ returns =410c9baf-5469-44f6-9852-826524b80c61=
 (musicbrainz-mbid-p "410c9baf-5469-44f6-9852-826524b80c61")
 #+END_SRC
 
+
 ** ambiguity
 
 From the docs…
@@ -164,6 +199,7 @@ Search supports the full  [[https://lucene.apache.org/core/7_7_2/queryparser/org
 | (musicbrainz-search-label /label/ &optional /limit/)         |   |
 | (musicbrainz-search-recording /query/ &optional /limit/)     |   |
 | (musicbrainz-search-release /query/ &optional /limit/)       |   |
+| (musicbrainz-search-work /query/ &optional /limit/)   |   |
 
 *** Lookup queries & subqueries
 
@@ -199,10 +235,9 @@ Search supports the full  [[https://lucene.apache.org/core/7_7_2/queryparser/org
 | (musicbrainz-lookup-release-group-artists /MBID/)       | …                                    |
 | (musicbrainz-lookup-release-group-releases /MBID/)      | …                                    |
 | (musicbrainz-lookup-series /MBID/)                      | …                                    |
-| (musicbrainz-lookup-work /MBID/)                        | …                                    |
+| (musicbrainz-lookup-work /MBID/)                        | [[https://musicbrainz.org/work/4ee2545d-2be5-3841-b568-0b4554eccc67][4ee2545d-2be5-3841-b568-0b4554eccc67]] |
 | (musicbrainz-lookup-url /MBID/)                         | …                                    |
 
-
 * ListenBrainz
 
 
@@ -351,7 +386,6 @@ https://listenbrainz.readthedocs.io/en/production/dev/api/#pinned-recording-api-
 | GET /1/(user_name)/pins/following | - |
 | GET /1/(user_name)/pins           | - |
 
-
 * otherBrainz
  - [[https://critiquebrainz.org/][CritiqueBrainz]]
  - [[https://bookbrainz.org/][BookBrainz]] → https://api.test.bookbrainz.org/1/docs/