lyrics-fetcher.el

lyrics-fetcher.el

A package to fetch song lyrics and album covers. Integrates with EMMS.

The available backends are genius.com and music.163.com.

Installation

The package is available on MELPA. Install it however you normally install packages, I prefer use-package with straight:

(use-package lyrics-fetcher
  :straight t
  :after (emms))

Install imagemagick if you want to download covers.

If you want to use the genius backend, you have to set genius.com client access token. To do that, create a new client, click “Generate Access Token” and put the result to the lyrics-fetcher-genius-access-token variable. I do this with password-store:

(setq lyrics-fetcher-genius-access-token
      (password-store-get "My_Online/APIs/genius.com"))

But of course, you can just hardcode the string.

Usage

Available commands:

  • M-x lyrics-fetcher-show-lyrics - show lyrics for the current playing track.

    The resulting lyric files are saved to the lyrics-fetcher-lyrics-folder and have the lyrics-fetcher-lyrics-file-extension extension. The folder will be created if it doesn’t exist.

    By default, the function opens an already saved lyrics file if one exists, otherwise tries to fetch the lyrics.

    If called with C-u, then tries to fetch the text regardless of the latter.

    If called with C-u C-u, prompts the user to select a matching song. That is helpful when there are multiple songs with similar names, and the top one isn’t the right one.

    If called with C-u C-u C-u, edit the search query in minibuffer before sending. This is helpful when there is extra information in the song title which prevents the API from finding the song.

  • M-x lyrics-fetcher-show-lyrics-query - fetch lyrics by a text query.

    Modified by C-u the same way as lyrics-fetcher-show-lyrics.

  • M-x lyrics-fetcher-use-backend - select a backend to use.

EMMS integration:

  • M-x lyrics-fetcher-emms-browser-show-at-point - fetch data for the current point in EMMS browser.

    If the point contains just one song, it will be fetched the usual way and lyrics will be shown upon successful completion.

    If the point contains many songs (e.g. it’s an album), the lyrics will be fetched consequentially for every song. The process then will stop at the first failure.

    Modified by C-u the same way as lyrics-fetcher-show-lyrics.

  • M-x lyrics-fetcher-emms-browser-fetch-covers-at-point - fetch album covers for the current point in the EMMS browser.

    This functionality requires songs’ directories to be grouped by albums, i.e. one album per one folder.

    The files will be saved to the folder with names like “cover_small.jpg”, “cover_med.jpg”, “cover_large.jpg”.

    You can customize the sizes via the lyrics-fetcher-small-cover-size and lyrics-fetcher-medium-cover-size variables.

    Modified by C-u the same way as lyrics-fetcher-show-lyrics.

  • M-x lyrics-fetcher-emms-browser-open-large-cover-at-point - open large_cover for the current point in EMMS browser.

  • M-x lyrics-fetcher-lyrics-catchup - feed the LRC file for the current track to EMMS.

Lyric view mode keybindings:

  • q - close the lyrics buffer
  • r - refetch the lyrics in the buffer

Available backends

As of now, the available backends are genius and neteasecloud (thanks @Elilif). Backends can be switched with M-x lyrics-fetcher-use-backend, or from the Lisp code:

(lyrics-fetcher-use-backend 'neteasecloud)

The genius backend fetches lyrics in a simple text format.

neteasecloud fetches in the LRC format, which contains timestamps for each line of the lyrics text.

LRC files can also be read by emms-lyrics. lyrics-fetcher-use-backend sets up lyrics-fetcher and EMMS variables so that EMMS could see the lyrics, downloaded by lyrics-fetcher. Running M-x emms-lyrics then should enable lyric display for newly played tracks, or you can run M-x lyrics-fetcher-lyrics-catchup to manually feed the current LRC file to EMMS.

Customization and extension

Lyrics file naming and location

As was outlined above, lyrics files are saved to lyrics-fetcher-lyrics-folder and have an extension set in lyrics-fetcher-lyrics-file-extension.

Take a look at the lyrics-fetcher-format-song-name-method and lyrics-fetcher-format-file-name-method variables if you want to customize the lyrics buffer and file naming.

Also note that integration with emms-lyrics requires these variables to be set with lyrics-fetcher-use-backend

Using other player than EMMS

To use another player, customize lyrics-fetcher-current-track-method.

This variable contains a function that returns the current playing track. The return format has to be either a string or (recommended) an EMMS-like alist, which has to have the following fields:

  • info-artist or info-albumartist
  • info-title

Adding another backend

A function to perform the lyric fetching is set in lyrics-fetcher-fetch-method.

The function has to receive 3 arguments:

  • track - a string or alist, as outlined above.
  • callback - the function which has to be called with the resulting lyrics string
  • sync - if non-nil, inquire the user about the possible choices. This is called sync because then it is reasonable to perform the request synchronously, as otherwise, it won’t be nice to suddenly throw a prompt at the user.

The album cover fetching is similar. The corresponding function is set in lyrics-fetcher-download-cover-method and has to receive the following parameters:

  • track - as above
  • callback - has to be called with the path to the resulting file. This file should be named cover_large.<extension>.
  • folder - where the file has to be put
  • sync - as above.

The first argument is track because in EMMS all the required information is stored in tracks, and album data is deduced from tracks. So this package just takes a sample track in the album.

Troubleshooting

I’ve noticed that Genius can give pages with different DOMs to different people. If you have an empty buffer instead of lyrics, please attach the curl-cookie-jar file to the issue. It usually resides in .emacs.d/request.

Table of Contents