Support individual historic listens submittion.

[musicbrainz.git] / README.org

diff --git a/README.org b/README.org
index d63d2463a377ad33b113b3e126b6b323d34cdff6..fd27076805ba3d17b9cb8259e1684ebd24384f33 100644 (file)
--- a/README.org
+++ b/README.org
@@ -3,11 +3,11 @@
 #+author:
 #+title:  MusicBrainz & ListenBrainz & others
 
 #+author:
 #+title:  MusicBrainz & ListenBrainz & others
 

-

 - [[#musicbrainz][MusicBrainz]]
     - [[#musicbrainz-api][MusicBrainz API]]
     - [[#searching--browsing][searching & browsing]]
     - [[#some-examples][some examples]]
 - [[#musicbrainz][MusicBrainz]]
     - [[#musicbrainz-api][MusicBrainz API]]
     - [[#searching--browsing][searching & browsing]]
     - [[#some-examples][some examples]]

+    - [[#cover-art][cover art]]

     - [[#mbid][MBID]]
     - [[#ambiguity][ambiguity]]
     - [[#incompleteness][incompleteness]]
     - [[#mbid][MBID]]
     - [[#ambiguity][ambiguity]]
     - [[#incompleteness][incompleteness]]


@@ -104,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]] |
 
 |  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
 
 
 ** MBID
 


@@ -119,6 +138,7 @@ returns =410c9baf-5469-44f6-9852-826524b80c61=
 (musicbrainz-mbid-p "410c9baf-5469-44f6-9852-826524b80c61")
 #+END_SRC
 
 (musicbrainz-mbid-p "410c9baf-5469-44f6-9852-826524b80c61")
 #+END_SRC
 

+

 ** ambiguity
 
 From the docs…
 ** ambiguity
 
 From the docs…


@@ -218,7 +238,6 @@ Search supports the full  [[https://lucene.apache.org/core/7_7_2/queryparser/org
 | (musicbrainz-lookup-work /MBID/)                        | [[https://musicbrainz.org/work/4ee2545d-2be5-3841-b568-0b4554eccc67][4ee2545d-2be5-3841-b568-0b4554eccc67]] |
 | (musicbrainz-lookup-url /MBID/)                         | …                                    |
 
 | (musicbrainz-lookup-work /MBID/)                        | [[https://musicbrainz.org/work/4ee2545d-2be5-3841-b568-0b4554eccc67][4ee2545d-2be5-3841-b568-0b4554eccc67]] |
 | (musicbrainz-lookup-url /MBID/)                         | …                                    |
 

-

 * ListenBrainz
 
 
 * ListenBrainz
 
 


@@ -367,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           | - |
 
 | 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/
 * otherBrainz
  - [[https://critiquebrainz.org/][CritiqueBrainz]]
  - [[https://bookbrainz.org/][BookBrainz]] → https://api.test.bookbrainz.org/1/docs/