https://github.com/deadendpl/emacs-mb-search
Emacs MusicBrainz searching
https://github.com/deadendpl/emacs-mb-search
emacs emacs-lisp musicbrainz musicbrainz-api
Last synced: about 2 months ago
JSON representation
Emacs MusicBrainz searching
- Host: GitHub
- URL: https://github.com/deadendpl/emacs-mb-search
- Owner: deadendpl
- License: gpl-3.0
- Created: 2024-08-17T06:25:34.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-01-29T17:36:14.000Z (3 months ago)
- Last Synced: 2025-01-29T18:31:12.825Z (3 months ago)
- Topics: emacs, emacs-lisp, musicbrainz, musicbrainz-api
- Language: Emacs Lisp
- Homepage:
- Size: 150 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.org
- License: LICENSE
Awesome Lists containing this project
README
* Description
This package allows doing MusicBrainz searches by using their [[https://musicbrainz.org/doc/MusicBrainz_API][API]].
It uses =completing-read= to choose from a list of candidates.
It's rather simple, most of the time only name and disambiguation are shown.
It will use [[https://curl.se/][curl]] by default for doing API requests, because using built-in url library resulted in characters not rendering correctly.
If you still want to use url library for API requests, you can change the value of =mb-search-curl-p= to nil.
* Screenshot
[[file:screenshot.png]]
* Installation
- With [[https://github.com/slotThe/vc-use-package][vc-use-package]] (installed manually)
#+begin_src emacs-lisp
(use-package mb-search
:vc (:fetcher github :repo "deadendpl/emacs-mb-search"))
#+end_src
- With [[https://github.com/slotThe/vc-use-package][vc-use-package]] (built into Emacs 30+)
#+begin_src emacs-lisp
(use-package mb-search
:vc (:url "https://github.com/deadendpl/emacs-mb-search"))
#+end_src
- Without [[https://github.com/slotThe/vc-use-package][vc-use-package]]
#+begin_src emacs-lisp
(package-vc-install "https://github.com/deadendpl/emacs-mb-search")
#+end_src
* Usage
There is a command for every type of search that API allows.
- =mb-search-annotation=
- =mb-search-area=
- =mb-search-artist=
- =mb-search-cdstub=
- =mb-search-event=
- =mb-search-instrument=
- =mb-search-label=
- =mb-search-place=
- =mb-search-recording=
- =mb-search-release=
- =mb-search-release-group=
- =mb-search-series=
- =mb-search-tag=
- =mb-search-url=
- =mb-search-work=
* Tips
You can set the amount of candidates in the =mb-search-limit= variable.
Values between 1 and 100 are allowed.
* Things to do [2/2]
- Search types [15/15]
- [X] Annotation
- [X] Area
- [X] Artist
- [X] Cdstub
- [X] Event
# - [ ] Genre (not implemented officially)
- [X] Instrument
- [X] Label
- [X] Place
- [X] Recording
- [X] Release
- [X] Release group
- [X] Series
- [X] Tag
- [X] URL
- [X] Work
- [X] Fix non latin symbols
- [X] Fix naming scheme
* Credits
[[http://www.youtube.com/watch?v=XjKtkEMUYGc][This YouTube video]] inspired me to create this package.