typos fixed

typo fixed and feature update
bugfix: playlist list
2025-10-16 21:01:42 +02:00 · 2025-10-15 20:38:00 +02:00 · 2025-10-15 15:22:40 +02:00 · 2025-10-15 09:12:02 +02:00 · 2025-10-14 22:38:36 +02:00 · 2025-10-14 22:33:36 +02:00
24 changed files with 921 additions and 179 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1 @@
-demo
 fuzic
--- a/7
+++ b/7
@@ -0,0 +1,7 @@
+Copyright © 2025 Ämin Baumeler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
--- a/README.md
+++ b/README.md
@@ -0,0 +1,217 @@
+🎧 Description and Use Case
+---------------------------
+This application allows for a keyboard-controlled maneuvering of your music library and the MusicBrainz database. 
+Your local library becomes "embedded" in MusicBrainz, and all metadata remains up-to-date without the need of tagging your files.
+Control playback from your terminal while browsing the vast world of music releases.
+
+🔍 Key Features
+---------------
+- [Fuzzily](https://github.com/junegunn/fzf) browse your music library
+- Treat your local library as part of the [MusicBrainz universe](https://musicbrainz.org)
+- Search the MusicBrainz database and discover music artists and releases
+- Handle metadata without touching your audio files
+- Fast and hackable application with [vim](https://www.vim.org)-like keybindings
+- Save and load playlists
+- Lyrics support
+
+🎞️ Screenshot
+-------------
+### Search Artist on MusicBrainz
+The MusicBrainz database is automatically searched after entering a query.
+In the screenshot below, the emoji 🔆 indicates that some tracks of _Mc Solaar_ are available in the local music library.
+They are played by hitting `<enter>`.
+![MusicBrainz artist search](./screenshots/search.png)
+
+### Browse Local Music Library
+Here, we fuzzily search an album of _Daft Punk._
+The LP _Random Access Memories_ can be appended to the playlist by pressing `ctrl-alt-m`.
+Alternatively, you may switch back to normal mode (`esc`) and then hit `;`.
+![Browse library](./screenshots/browse.png)
+
+### Playlist Control
+You can easily control playback and edit the playlist in the playlist view.
+![Playlist](./screenshots/playlist.png)
+
+🛠️ Requirements and Installation
+--------------------------------
+### Requirements
+This is an almost[^1] POSIX-compliant shell script with inline `awk` elements (GNU flavored, we couldn't resist) that makes calls to:
+- the command-line fuzzy finder [fzf](https://junegunn.github.io/fzf/),
+- the command-line data transferrer [curl](https://curl.se),
+- the command-line JSON processor [jq](https://jqlang.org),
+- the command-line media player [mpv](https://mpv.io), and
+- the command-line multipurpose relay [socat](http://www.dest-unreach.org/socat/).
+
+[^1]: It is written in POSIX style, but we make use of zero terminated strings.
+
+The following may improve your experience:
+- the command-line multimedia prober [ffprobe](https://ffmpeg.org/ffprobe.html) _(optional, for automatic release detection)_,
+- the command-line clipboard [xsel](http://www.kfish.org/software/xsel/) _(optional, for yanking urls)_,
+- Noto fonts _(optional, for emojis in your terminal)_.
+
+### Installation
+Run `./scripts/build.sh`, then copy `fuzic` to your preferred location, e.g., `~/.local/bin`, and make it executable.
+
+🧩 Configuration
+-----------------
+Although **no configuration** is needed, this application may be customized using environment variables.
+If the file `$XDG_CONFIG_HOME/fuzic/config` (defaults to `$HOME/.config/fuzic/config`) exists, then it will be sourced.
+You may also specify an alternative location of the configuration file with the environment variable `CONFIGFILE`.
+
+The **appearance** of the application is controlled using the environment variables defined in `src/sh/theme.sh`.
+The directory `share/theme` contains example themes.
+You may execute `CONFIGFILE=share/theme/plain.sh fuzic` to launch `fuzic` using an emojiless and colorless theme.
+
+Custom **filters** can be defined using the environment variables from `src/sh/filter.sh`.
+For instance, when you launch `F_2_LIST_ARTISTS="jazz" fuzic`, then the artist list can be queried for the word `jazz` by pressing `alt-2`.
+
+Also the **key bindings** can be reconfigured to your liking.
+For that, adjust the environment variables defined in `src/sh/keys.sh`.
+
+Finally, you can **sort** the artists according to their [sort name](https://musicbrainz.org/doc/Style/Artist/Sort_Name) by specifying `SORT_ARTIST_DEFAULT=sort-artist-sortname`,
+and the switch to alphabetical release-group sorting via `SORT_RG_DEFAULT=sort-rg-title`.
+
+
+▶️ Usage
+--------
+For a quick start, run the application and hit `alt-?` to display the available key-bindings.
+You may also open the application in one of the following predefined modes:
+```
+Usage: fuzic [OPTION]
+
+GENERAL OPTIONS:
+  --help                        Show this help and exit
+  --artists                     Default options, list artists of local music
+  --albums                      List albums of local music
+  --search-artist               Search artist on MusicBrainz
+  --search-album                Search album on MusicBrainz
+  --artist <mbid>               List release groups of given artist <mbid>
+  --releasegroup <mbid>         List releases in given release group <mbid>
+  --release <mbid>              Show release given by <mbid>
+  --playlists                   List stored playlists and exit
+  --load-playlist <playlist>    Load specified playlist
+
+MANAGE LOCAL MUSIC:
+  --decorate <path>             Decorate directory containing a tagged release
+  --decorate-as <path> <mbid>   Decorate directory as the relase <mbid>
+  --reload-database <path>      Populate database with decorated local music from <path>
+```
+
+
+🗄️ Local Music Library
+----------------------
+Instead of reading the tags from audio files, this application uses **decorations.**
+The decoration of a folder is a JSON file that stores the relevant MusicBrainz IDs of the release the folder corresponds to. 
+This assumes that complete releases are stored within separate folders.
+The application then fetches the relevant metadata, which is displayed to the user.
+Folders can be decorated using `fuzic --decorate <path>` or `fuzic --decorate-as <path> <mbid>` commands.
+The first version may be used on previously tagged files (using, e.g., [MusicBrainz Picard](https://picard.musicbrainz.org/)).
+With this command, the folder gets decorated with the MusicBrainz IDs extracted from the files.
+The latter version does not require the files to be tagged.
+Instead, it decorates the files found in that folder as the release given by the [MusicBrainz Release ID](https://musicbrainz.org/doc/MusicBrainz_Identifier) `<mbid>`.
+
+After decorating your folders, you may run `fuzic --reload-database <path>` to build your music library.
+This command searches the path specified for decorated folders.
+Once the local music library is built, it will display automatically when `fuzic` is launched.
+
+### Workflow Example
+```
+$ fuzic --decorate ~/Music/Daft\ Punk/Random\ Access\ Memories 
+Info: Decorating /home/amin/Music/Daft Punk/Random Access Memories as release 5000a285-b67e-4cfc-b54b-2b98f1810d2e
+$ fuzic --decorate-as ~/Music/Mc\ Solaar/Prose\ Combat 69e5cf67-7cea-4fe8-9129-9779f0a93d69
+Info: Decorating /home/amin/Music/Mc Solaar/Prose Combat as the release Prose Combat by MC Solaar
+Info: We discovered the following association:
+Track 'Aubade'                         File './01 Aubade.m4a'
+Track 'Obsolète'                       File './02 Obsolète.m4a'
+Track 'Nouveau western'                File './03 Nouveau western.m4a'
+Track 'À la claire fontaine'           File './04 À la claire fontaine.m4a'
+Track 'Superstarr'                     File './05 Superstarr.m4a'
+Track 'La Concubine de l’hémoglobine'  File './06 La Concubine de l’hémoglobine.m4a'
+Track 'Dévotion'                       File './07 Dévotion.m4a'
+Track 'Temps mort'                     File './08 Temps mort.m4a'
+Track 'L’NMIACCd’HTCK72KPDP'           File './09 L’NMIACCd’HTCK72KPDP.m4a'
+Track 'Séquelles'                      File './10 Séquelles.m4a'
+Track 'Dieu ait son âme'               File './11 Dieu ait son âme.m4a'
+Track 'À dix de mes disciples'         File './12 À dix de mes disciples.m4a'
+Track 'La fin justifie les moyens'     File './13 La fin justifie les moyens.m4a'
+Track 'Relations humaines'             File './14 Relations humaines.m4a'
+Track 'Prose combat'                   File './15 Prose combat.m4a'
+Info: Are the track correctly associated to the audio files? (yes/no) yes
+$ fuzic --reload-database ~/Music
+Info: Reloading information of local music directory /home/amin/Music
+Info: Fetching missing releases
+Info: 1/2 (5000a285-b67e-4cfc-b54b-2b98f1810d2e: Random Access Memories)
+Info: 2/2 (69e5cf67-7cea-4fe8-9129-9779f0a93d69: Prose Combat)
+Info: Fetching missing release groups
+Info: 1/2 (aa997ea0-2936-40bd-884d-3af8a0e064dc: Random Access Memories)
+Info: 2/2 (b199910b-0f90-3c88-b523-d6852b7612d3: Prose Combat)
+Info: Fetching missing artists
+Info: 1/2 (056e4f3e-d505-4dad-8ec1-d04f521cbb56: Daft Punk)
+Info: 2/2 (bbbd2644-b4cb-4bb5-a442-315310f68a0b: MC Solaar)
+Info: Done
+```
+
+⌨️ Basic Keys
+-------------
+As mentioned above, you may hit `alt-?` anytime to display the possible keys.
+Note that `fuzic` allows for two modes: _normal mode_ and _insert mode._
+Similar to `vim`, keys pressed in the _normal mode_ do not directly write to the input field, but are instead bound to other actions.
+For instance, the keys `j` and `k` can be used to navigate the list down and up.
+In the insert mode, triggered using `i`, `a`, or `/`, the keys directly modify the input field. 
+
+Some central keys are `<enter>` to start playback of the selected entry, `<space>` to pause playback, and `ctrl-p` to open the currently loaded playlist.
+
+📝 Playlist Store
+-----------------
+Playlists can be saved, loaded and _shared._
+To save a playlist, simply press `ctrl-s` when viewing your playlist.
+To load a playlist, open the playlist store using `ctrl-o` while viewing your playlist.
+Alternatively, you may start `fuzic` using the command-line parameters `fuzic --load-playlist <playlist>`.
+Under the hood, a playlist is not more than a sequence of MusicBrainz IDs.
+This means that `fuzic` users may share their playlists irrespective of the audio file locations and formats.
+Possibly even more importantly, this means that you can preserve your playlist even if you reorganize your local music library:
+You can safely share your playlists with your future self.
+
+Playlists are stored under `XDG_DATA_HOME/fuzic/playlists`, which defaults to `~/.local/share/fuzic/playlists`.
+You may also define the playlist directory using the `PLAYLIST_DIRECTORY` environment variable.
+In `share/playlists` you find example playlists.
+Thus, the command `PLAYLIST_DIRECTORY=share/playlists fuzic` launches this application with access to these example playlists.
+
+📜 Lyrics
+---------
+By using the key `L` (normal mode), the lyrics of the selected track are displayed.
+The lyrics are taken from (in that order)
+1. the lyrics stored using `fuzic`, or
+2. from the `.lrc` file with the same name as the audio file, or
+3. from the audio-file tags (requires `ffprobe`), or
+4. from a custom script.
+
+To specify the custom script, you can set the `LYRICS_FETCH_CUSTOM` environment variable to point to an executable.
+The executable reads a JSON string on the standard input, and is supposed to print the lyrics (see `share/lyrics/example.sh`).
+
+You may also skip the first three sources and directly make a call to your custom script by using the key `Y` (normal mode).
+
+The key `alt-L` opens the lyrics in a new window using the `EDITOR`.
+This requires one of the following terminal emulators (`kitty`, `x-terminal-emulator`, `gnome-terminal`, `xterm`).
+If you use another terminal emulator, you may specify the environment variable `EXTERNALEDIT` to hold the string such that
+```sh
+$ExTERNALEDIT "$file"
+```
+spawns a text editor with `$file` loaded inside a terminal emulator.
+
+🧭 Planned Features
+-------------------
+The following features are planned:
+- cover art and artist images
+- genre support
+- MusicBrainz collections and favorites
+
+🌐 Information Sources
+----------------------
+Main metadata is fetched from the MusicBrainz database.
+This application also access [wikidata](https://wikidata.org), [wikipedia](https://en.wikipedia.org), and [discogs](https://www.discogs.com).
+In the future, more sources may be added.
+
+License
+-------
+This project is licensed under the [MIT License](./LICENSE).
--- a/screenshots/browse.png
+++ b/screenshots/browse.png
--- a/screenshots/playlist.png
+++ b/screenshots/playlist.png
--- a/screenshots/search.png
+++ b/screenshots/search.png
--- a/scripts/build.sh
+++ b/scripts/build.sh
@@ -12,8 +12,10 @@ sed -E 's|\. "([^$].+)"$|cat src/\1|e' "$SRC" >"$tmpdir/1.sh"
 echo "🐔 ${GREEN}Internalize awk scripts${OFF}"
 sed -E 's|@@include (.+)$|cat src/\1|e' "$tmpdir/1.sh" >"$tmpdir/2.sh"
 echo "🥚 ${GREEN}Internalize awk libraries${OFF}"
-sed -E 's|@include "(.+)"$|cat src/\1|e' "$tmpdir/2.sh" >"$NAME"
-echo "🐔 ${GREEN}Make executable and cleanup${OFF}"
+sed -E 's|@include "(.+)"$|cat src/\1|e' "$tmpdir/2.sh" >"$tmpdir/3.sh"
+echo "🐔 ${GREEN}Strip comments${OFF}"
+grep -v "^ *# " "$tmpdir/3.sh" | grep -v "^ *#$" >"$NAME"
+echo "🥚 ${GREEN}Make executable and cleanup${OFF}"
 chmod +x "$NAME"
 rm -rf "$tmpdir"
 echo "🍳 ${GREEN}Done:${OFF} Sucessfully built ${BOLD}${GREEN}$NAME${OFF}"
--- a/share/lyrics/example.sh
+++ b/share/lyrics/example.sh
@@ -0,0 +1,25 @@
+#!/bin/sh
+
+# Example script for `fuzic` to display the lyrics of a track. This script
+# reads from stdin a JSON string and stores it in the variable `j`. The
+# variable `tj` contains the JSON string of the track.
+j="$(cat)"
+tj="$(echo "$j" | jq -r '.trackid as $tid | .release.media[].tracks[] | select(.id == $tid)')"
+# The following four variables are self-explanatory:
+track_name="$(echo "$tj" | jq -r '.title')"
+artist_name="$(echo "$tj" | jq -r '."artist-credit" | map([.name, .joinphrase] | join("")) | join("")')"
+album_name="$(echo "$j" | jq -r '.release.title')"
+duration="$(echo "$tj" | jq -r '.length / 1000 | round')"
+# Now, you may call an API to fetch the lyrics for this track,
+#
+# curl \
+#   --get \
+#   --silent \
+#   --data-urlencode "track_name=$track_name" \
+#   --data-urlencode "artist_name=$artist_name" \
+#   --data-urlencode "album_name=$album_name" \
+#   --data-urlencode "duration=$duration" \
+#   "$URL"
+#
+# or simply print a template to write the lyrics yourself:
+printf "Lyrics '%s' by '%s' (album: %s, duration: %s seconds)\n" "$track_name" "$artist_name" "$album_name" "$duration"
--- a/share/playlists/example
+++ b/share/playlists/example
@@ -0,0 +1,7 @@
+e2276744-afe0-4ecd-9340-9e34f1526cc5	56e2c4d2-01b2-4bc6-a11f-ee6a50be9fa6
+a75bb4c3-d1ce-4d35-aac5-2068f7c32805	8def9034-1cd7-4fe3-88c6-5c83fdc9537a
+60a90232-228c-4ee2-af2f-07706fa13bd8	f9f5c049-b2f2-3ce7-93e3-956ce2c77d2c
+13027e7b-340c-4478-8dda-df5fa4af3564	b2f18f14-7918-4856-bce3-b936fd628763
+ca2e4dca-0ec3-411a-b2a0-60bb97107c2c	d0c5cb23-ec7a-41ce-8a1c-3498aafdf527
+486239ef-0be2-435b-963a-b9451f8c8c57	c6c3b393-fede-489e-bb77-23e32951ebc9
+b3cf4db5-deb4-40b8-88bc-e016cca1104f	c90ec13c-b406-3c15-83d3-8443304ccc6f
--- a/share/theme/plain.sh
+++ b/share/theme/plain.sh
@@ -184,3 +184,7 @@ KBF_GROUP="%s"
 KBF_KEY="%s"
 # Format description
 KBF_DESC="%s"
+
+# Playlist title
+# ==============
+TITLE_PLYLST="  Playlist  "
--- a/src/awk/recordings.awk
+++ b/src/awk/recordings.awk
@@ -66,6 +66,8 @@ BEGIN {
    ds = dur % 60
    if (ds <= 9)
      ds = "0"ds
+    if (dh && dm <= 9)
+      dm = "0"dm
    dur = dh ? dh":"dm":"ds : dm":"ds
  } else {
    dur = "??:??"
--- a/src/main.sh
+++ b/src/main.sh
@@ -36,6 +36,8 @@ VIEW_LIST_ARTISTS="list-artists"
 VIEW_LIST_ALBUMS="list-albums"
 VIEW_SELECT_ARTIST="select-artist"
 VIEW_PLAYLIST="playlist"
+VIEW_PLAYLIST_PLAYLISTSTORE="playlist-list"
+VIEW_PLAYLIST_STORE="playlist-store"
 VIEW_QUIT="quit"
 MODE_NORMAL="hidden"
 MODE_INSERT="show"
@@ -47,21 +49,27 @@ MODE_INSERT="show"
 # Load logging methods
 . "sh/log.sh"

+# Load configuration
+. "sh/config.sh"
+
+# Load mpv methods
+. "sh/mpv.sh"
+
 # Load query methods
 . "sh/query.sh"

-# Load playback helper
-. "sh/playback.sh"
+# Load local file handling
+. "sh/local.sh"

 # Load playlist tools
 . "sh/playlist.sh"

+# Load playback helper
+. "sh/playback.sh"
+
 # Load MusicBrainz, Discogs, and wiki methods
 . "sh/api.sh"

-# Load mpv methods
-. "sh/mpv.sh"
-
 # Load preview methods
 . "sh/preview.sh"

@@ -71,9 +79,6 @@ MODE_INSERT="show"
 # Load MusicBrainz wrappers
 . "sh/mb.sh"

-# Load local file handling
-. "sh/local.sh"
-
 # Load list-generating methods
 . "sh/lists.sh"

@@ -83,9 +88,6 @@ MODE_INSERT="show"
 # Load keys
 . "sh/keys.sh"

-# Load configuration
-. "sh/config.sh"
-
 # Load sorting methods
 . "sh/sort.sh"

@@ -98,6 +100,12 @@ MODE_INSERT="show"
 # Load AWK scripts
 . "sh/awk.sh"

+# Load filters
+. "sh/filter.sh"
+
+# Load lyrics support
+. "sh/lyrics.sh"
+
 # Command-line options that may only be used internally.
 #   --lines
 #   --playback
@@ -110,6 +118,8 @@ MODE_INSERT="show"
 #   --preview
 #   --show-keybindings
 #   --remove-from-cache
+#   --edit-lyrics
+#   --lyrics-custom
 case "${1:-}" in
 "--lines")
  # Print lines that are fed into fzf.
@@ -225,30 +235,30 @@ case "${1:-}" in
  # @argument $5: MusicBrainz ID (optional)
  #
  # The argument `level` specifies the view relative to `view`: If `level` is
-  # set to +1, then the specified MusicBrainz ID is an ID of an object one level
-  # deeper than `view`. Alternatively, the argument `level` may be set to `-1`.
-  # Anything else is interpreted as "on the level of `view`".
+  # set to +1, then the specified MusicBrainz ID is an ID of an object one
+  # level deeper than `view`. Similarly, the argument `level` may be set to
+  # `-1`. Anything else is interpreted as "on the level of `view`".
  #
-  # The choice of possible arguments ($5) depends on the view.
-  # These views are independent of the MusicBrainz ID ($4) and of the argument
+  # The choice of possible levels ($4) depends on the view.
+  # These views are independent of the MusicBrainz ID ($5) and of the argument
  # ($5):
  # - VIEW_SEARCH_ARTIST: Get ready to query MusicBrainz for artists
  # - VIEW_SEARCH_ALBUM: Get ready to query MusicBrainz for albums
  # - VIEW_LIST_ARTISTS: List all locally available artists
  # - VIEW_LIST_ALBUMS: List al locally available albums
  #
-  # If no argument ($5) is specified, then the remaining views act as follows:
+  # If no level ($4) is specified, then the remaining views act as follows:
  # - VIEW_ARTIST: Display all release groups of that artist
  # - VIEW_RELEASEGROUP: Display all releases within that release group
  # - VIEW_RELEASE: Display track list of specified release
  #
-  # Here, if the argument is set to `-1`, then the parent entry is displayed:
+  # Here, if the level is set to `-1`, then the parent entry is displayed:
  # - VIEW_ARTIST: Divert view to VIEW_LIST_ARTISTS
  # - VIEW_RELEASEGROUP: For single-artist release groups, divert to
  #   VIEW_ARTIST of that artist, else display the artist selection.
  # - VIEW_RELEASE: Divert view to VIEW_LIST_RELEASEGROUP.
  #
-  # Alternatively, if the argument is set to `+1`, then the child entry is
+  # Alternatively, if the level is set to `+1`, then the child entry is
  # displayed:
  # - VIEW_ARTIST: Divert view to VIEW_LIST_ARTISTS
  # - VIEW_RELEASEGROUP: For single-artist release groups, divert to
@@ -281,6 +291,7 @@ case "${1:-}" in
    "$VIEW_SEARCH_ARTIST" | "$VIEW_LIST_ARTISTS") view="$VIEW_ARTIST" ;;
    "$VIEW_ARTIST" | "$VIEW_SEARCH_ALBUM" | "$VIEW_LIST_ALBUMS") view="$VIEW_RELEASEGROUP" ;;
    "$VIEW_RELEASEGROUP") view="$VIEW_RELEASE" ;;
+    "$VIEW_RELEASE") exit 0 ;;
    esac
    ;;
  *) ;;
@@ -364,6 +375,20 @@ case "${1:-}" in
  esac
  exit 0
  ;;
+"--edit-lyrics")
+  # Edit lyrics file in an external window
+  info "Call to $*"
+  mbid="${2:-}"
+  file="$(lyrics_file "$mbid")"
+  [ -f "$file" ] || echo "No lyrics" | store_lyrics "$mbid"
+  [ "$EXTERNALEDIT" ] && $EXTERNALEDIT "$file" || err "Failed to externally edit the file $file"
+  exit 0
+  ;;
+"--lyrics-custom")
+  # Use custom command to (re-)fetch the lyrics
+  store_lyrics_custom "$2" "$3"
+  exit 0
+  ;;
 esac

 # Non-interactive user commands intended to the user. These commands do not
@@ -416,6 +441,22 @@ case "${1:-}" in
  info "Done"
  exit 0
  ;;
+"--playlists")
+  # List available playlists
+  stored_playlists | cut -d "$(printf '\t')" -f 1
+  exit 0
+  ;;
+"--print-playlist")
+  # Pretty print playlist
+  list_playlist_stored "${2:-}" |
+    cut -d "$(printf '\t')" -f 1
+  exit 0
+  ;;
+"--lyrics")
+  shift
+  lyrics "$@"
+  exit 0
+  ;;
 "--help")
  # Print help string
  cat <<EOF
@@ -430,6 +471,10 @@ GENERAL OPTIONS:
  --artist <mbid>               List release groups of given artist <mbid>
  --releasegroup <mbid>         List releases in given release group <mbid>
  --release <mbid>              Show release given by <mbid>
+  --playlists                   List stored playlists and exit
+  --load-playlist <playlist>    Load specified playlist
+  --print-playlist <playlist>   Print specified playlist and exit
+  --lyrics <relid> <mbid>       Show lyrics of track <mbid> in release <relid> and exit

 MANAGE LOCAL MUSIC:
  --decorate <path>             Decorate directory containing a tagged release
@@ -482,14 +527,23 @@ case "${1:-}" in
  MODE="$MODE_NORMAL"
  MBID=""
  ;;
+"--load-playlist")
+  # We will load and play later
+  VIEW="$VIEW_PLAYLIST"
+  MODE="$MODE_NORMAL"
+  MBID=""
+  ;;
 *)
  err "Unknown option $1 (see --help)"
  exit 1
  ;;
 esac

+# For history purpose: previous view is always:
+LASTVIEW="$VIEW_LIST_ARTISTS"
+LASTARG=""
+
 # Start application:
-# - load and export preset filters
 # - set title
 # - check for missing data from MusicBrainz
 # - precompute main views
@@ -497,9 +551,6 @@ esac
 # - start mpv daemon
 # - enter main loop and start fzf

-# Load filters
-. "sh/filter.sh"
-
 # Set window title
 printf '\033]0;%s\007' "$WINDOW_TITLE"

@@ -522,24 +573,31 @@ export LOCKFILE RESULTS PIDFILE
 # Start mpv
 mpv_start

+# Playback possible now
+if [ "${1:-}" = "--load-playlist" ]; then
+  sleep 1
+  $0 --playlist "$PLAYLIST_CMD_LOAD" "${2:-}"
+fi
+
 # main loop
 # states are stored in (in)visible labels
 #
 # mode: [$MODE_NORMAL, $MODE_INSERT]
-# The mode is reflected on the input visibility. The variable $FZF_INPUT_STATE
-# is set to "hidden" if and only if the mode is `normal`. To swtich to `normal`
-# mode, we call `hide-input`. To switch to insert mode, we call `show-input`.
+# The mode is reflected on the input visibility. The variable
+# `FZF_INPUT_STATE`` is set to "hidden" if and only if the mode is `normal`. To
+# swtich to `normal` mode, we call `hide-input`. To switch to insert mode, we
+# call `show-input`.
 #
 # view: [$VIEW_*]
-# The view is stored in $FZF_LIST_LABEL. To set the view, call
+# The view is stored in `FZF_LIST_LABEL`. To set the view, call
 # `change-list-label($VIEW)`.
 #
-# argument: string
-# The argument is stored in $FZF_LIST_LABEL. To set the argument, call
-# `change-list-label($arg)`.
+# mbid:
+# The MusicBrainz ID of the current object is stored in `FZF_BORDER_LABEL`.
 IN_NORMAL_MODE="[ \$FZF_INPUT_STATE = hidden ]"
 IN_VIEW_PATTERN="[ \$FZF_LIST_LABEL = %s ]"
 IN_LIST_ARTISTS_VIEW="$(printf "$IN_VIEW_PATTERN" "$VIEW_LIST_ARTISTS")"
+IN_RELEASE_VIEW="$(printf "$IN_VIEW_PATTERN" "$VIEW_RELEASE")"
 FZF_CURRENT_MODE="\$FZF_INPUT_STATE"
 FZF_CURRENT_VIEW="\$FZF_LIST_LABEL"
 FZF_CURRENT_MBID="\$FZF_BORDER_LABEL"
@@ -595,15 +653,80 @@ while true; do
    LASTVIEW="$VIEW_SELECT_ARTIST"
    LASTARG="$ARGS"
    ;;
+  "$VIEW_PLAYLIST_STORE")
+    VIEW="$VIEW_PLAYLIST"
+    ARGS=""
+    MBID=""
+    tmpf=$(mktemp)
+    list_playlist | cut -d "$(printf '\t')" -f "3,4" >"$tmpf"
+    # Make sure we store only nonempty playlists
+    [ -s "$tmpf" ] || continue
+    while true; do
+      infonn "Enter playlist name:"
+      read -r playlistname
+      [ "$playlistname" ] || continue
+      case "$playlistname" in
+      *[!a-zA-Z0-9._-]*)
+        info "Please use only alaphnumeric symbols and any of \".-_\" for the playlist name."
+        ;;
+      *)
+        f="$PLAYLIST_DIRECTORY/$playlistname"
+        if [ -s "$f" ]; then
+          while true; do
+            infonn "Playlist with name \"$playlistname\" already exists. Do you want to overwrite it? (yes/no)"
+            read -r yn
+            case $yn in
+            "yes" | "no") break ;;
+            *) info "Please answer \"yes\" or \"no\"." ;;
+            esac
+          done
+          [ "$yn" = "yes" ] || continue
+        fi
+        break
+        ;;
+      esac
+    done
+    mv "$tmpf" "$f"
+    ;;
+  "$VIEW_PLAYLIST_PLAYLISTSTORE")
+    sel=$(
+      stored_playlists | $FZF \
+        --border=double \
+        --border-label="$TITLE_PLYLST_STORE" \
+        --margin="2%,10%" \
+        --bind="$KEYS_I_NORMAL:" \
+        --bind="$KEYS_DOWN:down" \
+        --bind="$KEYS_UP:up" \
+        --bind="$KEYS_HALFPAGE_DOWN:half-page-down" \
+        --bind="$KEYS_HALFPAGE_UP:half-page-up" \
+        --bind="$KEYS_OUT,$KEYS_QUIT:accept" \
+        --bind="$KEYS_KEYBINDINGS:preview:$0 --show-keybindings $VIEW_PLAYLIST_PLAYLISTSTORE" \
+        --bind="$KEYS_SCROLL_PREVIEW_DOWN:preview-down" \
+        --bind="$KEYS_SCROLL_PREVIEW_UP:preview-up" \
+        --bind="$KEYS_PREVIEW_TOGGLE_WRAP:toggle-preview-wrap" \
+        --bind="$KEYS_PREVIEW_TOGGLE_SIZE:change-preview-window(right,90%,border-line,nowrap|$FZF_DEFAULT_PREVIEW_WINDOW)" \
+        --bind="$KEYS_PREVIEW_OPEN:show-preview" \
+        --bind="$KEYS_PREVIEW_CLOSE:hide-preview" \
+        --bind="$KEYS_PLAYLISTSTORE_SELECT:transform:[ {1} ] && $0 --playlist $PLAYLIST_CMD_LOAD {2} && echo accept" \
+        --bind="$KEYS_PLAYLISTSTORE_DELETE:transform:[ {1} ] && rm \"$PLAYLIST_DIRECTORY/{r2}\" && echo \"reload($0 --playlists\)\"" \
+        --preview="$0 --print-playlist {2}" \
+        --preview-window="$FZF_DEFAULT_PREVIEW_WINDOW" \
+        --with-nth="{1}" \
+        --delimiter="\t" \
+        --wrap-sign="" || true
+    )
+    VIEW="$VIEW_PLAYLIST"
+    ;;
  "$VIEW_PLAYLIST")
    sel=$(
      list_playlist | $FZF \
        --reverse \
        --no-sort \
        --border=double \
-        --border-label="╢   Playlist   ╟" \
+        --border-label="$TITLE_PLYLST" \
        --no-input \
        --margin="2%,10%" \
+        --bind="$KEYS_I_NORMAL:" \
        --bind="$KEYS_DOWN,$KEYS_N_DOWN:down" \
        --bind="$KEYS_UP,$KEYS_N_UP:up" \
        --bind="$KEYS_HALFPAGE_DOWN:half-page-down" \
@@ -623,9 +746,11 @@ while true; do
        --bind="$KEYS_KEYBINDINGS:preview:$0 --show-keybindings $VIEW_PLAYLIST" \
        --bind="$KEYS_SCROLL_PREVIEW_DOWN:preview-down" \
        --bind="$KEYS_SCROLL_PREVIEW_UP:preview-up" \
+        --bind="$KEYS_PREVIEW_TOGGLE_WRAP:toggle-preview-wrap" \
+        --bind="$KEYS_PREVIEW_TOGGLE_SIZE:change-preview-window(right,90%,border-line,nowrap|$FZF_DEFAULT_PREVIEW_WINDOW)" \
        --bind="$KEYS_PREVIEW_CLOSE:hide-preview" \
        --bind="$KEYS_PLAYBACK,$KEYS_N_PLAYBACK:transform($0 --playback $VIEW_PLAYLIST {3} {4} {5})+$FZF_RELOAD_PLAYLIST+$FZF_POS_PLAYLIST" \
-        --bind="$KEYS_PLAYLIST_RELOAD:$FZF_RELOAD_PLAYLIST+$FZF_POS_PLAYLIST" \
+        --bind="$KEYS_PLAYLIST_RELOAD,$KEYS_SHOW_PLAYLIST:$FZF_RELOAD_PLAYLIST+$FZF_POS_PLAYLIST" \
        --bind="$KEYS_PLAYLIST_REMOVE:execute-silent($0 --playlist $PLAYLIST_CMD_REMOVE)+$FZF_RELOAD_PLAYLIST" \
        --bind="$KEYS_PLAYLIST_UP:execute-silent($0 --playlist $PLAYLIST_CMD_UP)+up+$FZF_RELOAD_PLAYLIST" \
        --bind="$KEYS_PLAYLIST_DOWN:execute-silent($0 --playlist $PLAYLIST_CMD_DOWN)+down+$FZF_RELOAD_PLAYLIST" \
@@ -635,6 +760,13 @@ while true; do
        --bind="$KEYS_PLAYLIST_SHUFFLE:execute-silent($0 --playlist $PLAYLIST_CMD_SHUFFLE)+$FZF_RELOAD_PLAYLIST" \
        --bind="$KEYS_PLAYLIST_UNSHUFFLE:execute-silent($0 --playlist $PLAYLIST_CMD_UNSHUFFLE)+$FZF_RELOAD_PLAYLIST" \
        --bind="$KEYS_PLAYLIST_GOTO_RELEASE:print($VIEW_RELEASE)+accept" \
+        --bind="$KEYS_PLAYLIST_STORE:print($VIEW_PLAYLIST_STORE)+print("")+print($LASTVIEW)+print($LASTARG)+accept" \
+        --bind="$KEYS_PLAYLIST_OPEN_STORE:print($VIEW_PLAYLIST_PLAYLISTSTORE)+print("")+print($LASTVIEW)+print($LASTARG)+accept" \
+        --bind="$KEYS_N_LYRICS:show-preview+preview:$0 --lyrics {3} {4}" \
+        --bind="$KEYS_LYRICS_EDIT:execute-silent:$0 --edit-lyrics {4}" \
+        --bind="$KEYS_N_LYRICS_FETCH_CUSTOM:execute-silent($0 --lyrics-custom {3} {4})+show-preview+preview:$0 --lyrics {3} {4}" \
+        --preview-window="hidden" \
+        --wrap-sign="" \
        --delimiter="\t" \
        --with-nth="{1}" \
        --accept-nth="{3}" || true
@@ -668,7 +800,7 @@ while true; do
        --info="inline-right" \
        --header-first \
        --header-border="bottom" \
-        --bind="start:transform:$0 --action-draw $MODE $VIEW "0" $MBID" \
+        --bind="start:transform:$0 --action-draw $MODE $VIEW 0 $MBID" \
        --bind="$KEYS_I_NORMAL:transform:$IN_NORMAL_MODE || echo hide-input" \
        --bind="$KEYS_N_INSERT:transform:$IN_NORMAL_MODE && echo show-input || $PUT_FZF_KEY_LOGIC" \
        --bind="$KEYS_DOWN:down" \
@@ -683,7 +815,7 @@ while true; do
        --bind="$KEYS_OUT:transform:$0 --action-draw $FZF_CURRENT_MODE $FZF_CURRENT_VIEW \"-1\" $FZF_CURRENT_MBID" \
        --bind="$KEYS_N_IN:transform:$IN_NORMAL_MODE && ([ {4} ] && $0 --action-draw $FZF_CURRENT_MODE $FZF_CURRENT_VIEW \"+1\" {4}) || $PUT_FZF_KEY_LOGIC" \
        --bind="$KEYS_N_OUT:transform:$IN_NORMAL_MODE && ($0 --action-draw $FZF_CURRENT_MODE $FZF_CURRENT_VIEW \"-1\" $FZF_CURRENT_MBID) || $PUT_FZF_KEY_LOGIC" \
-        --bind="$KEYS_SELECT_ARTIST:transform:$0 --action-gotoartist $FZF_CURRENT_MODE $FZF_CURRENT_VIEW $FZF_CURRENT_MBID {4}" \
+        --bind="$KEYS_SELECT_ARTIST:transform:$0 --action-gotoartist $FZF_CURRENT_MODE $FZF_CURRENT_VIEW \"$FZF_CURRENT_MBID\" {4}" \
        --bind="$KEYS_LIST_ARTISTS:transform:$0 --action-draw \$FZF_INPUT_STATE $VIEW_LIST_ARTISTS \"0\"" \
        --bind="$KEYS_LIST_ALBUMS:transform:$0 --action-draw \$FZF_INPUT_STATE $VIEW_LIST_ALBUMS \"0\"" \
        --bind="$KEYS_SEARCH_ARTIST:transform:$0 --action-draw $MODE_INSERT $VIEW_SEARCH_ARTIST \"0\"" \
@@ -717,7 +849,7 @@ open \"\$(dirname {5})\"" \
        --bind="$KEYS_YANK_CURRENT:execute-silent:printf $FZF_CURRENT_MBID | $CLIP" \
        --bind="$KEYS_SHOW_PLAYLIST:transform:echo \"print($VIEW_PLAYLIST)+print()+print($FZF_CURRENT_VIEW)+print($FZF_CURRENT_MBID)+accept\"" \
        --bind="$KEYS_KEYBINDINGS:preview:$0 --show-keybindings $FZF_CURRENT_VIEW" \
-        --bind="$KEYS_REFRESH:execute-silent($0 --remove-from-cache $FZF_CURRENT_VIEW $FZF_CURRENT_MBID {4})+transform:$0 --action-draw $FZF_CURRENT_MODE $FZF_CURRENT_VIEW \"0\" $FZF_CURRENT_MBID" \
+        --bind="$KEYS_REFRESH:execute-silent($0 --remove-from-cache $FZF_CURRENT_VIEW \"$FZF_CURRENT_MBID\" {4})+transform:$0 --action-draw $FZF_CURRENT_MODE $FZF_CURRENT_VIEW \"0\" $FZF_CURRENT_MBID" \
        --bind="$KEYS_QUIT:print($VIEW_QUIT)+accept" \
        --bind="$KEYS_N_QUIT:transform:$IN_NORMAL_MODE && ($IN_LIST_ARTISTS_VIEW && echo \"print($VIEW_QUIT)+accept\" || $0 --action-draw $MODE_NORMAL $VIEW_LIST_ARTISTS \"0\") || $PUT_FZF_KEY_LOGIC" \
        --bind="$KEYS_SCROLL_PREVIEW_DOWN:preview-down" \
@@ -726,8 +858,11 @@ open \"\$(dirname {5})\"" \
        --bind="$KEYS_PREVIEW_TOGGLE_SIZE:change-preview-window(right,90%,border-line,nowrap|$FZF_DEFAULT_PREVIEW_WINDOW)" \
        --bind="$KEYS_PREVIEW_OPEN:show-preview" \
        --bind="$KEYS_PREVIEW_CLOSE:hide-preview" \
-        --bind="$KEYS_PLAYBACK:transform:$0 --playback $FZF_CURRENT_VIEW $FZF_CURRENT_MBID {4} {5}" \
-        --bind="$KEYS_N_PLAYBACK:transform:$IN_NORMAL_MODE && $0 --playback $FZF_CURRENT_VIEW $FZF_CURRENT_MBID {4} {5} || $PUT_FZF_KEY_LOGIC" \
+        --bind="$KEYS_PLAYBACK:transform:$0 --playback $FZF_CURRENT_VIEW \"$FZF_CURRENT_MBID\" {4} {5}" \
+        --bind="$KEYS_N_PLAYBACK:transform:$IN_NORMAL_MODE && $0 --playback $FZF_CURRENT_VIEW \"$FZF_CURRENT_MBID\" {4} {5} || $PUT_FZF_KEY_LOGIC" \
+        --bind="$KEYS_N_LYRICS:transform:$IN_NORMAL_MODE && $IN_RELEASE_VIEW && printf \"show-preview+preview:%s --lyrics %s %s\" \"$0\" {3} {4}" \
+        --bind="$KEYS_LYRICS_EDIT:transform:$IN_RELEASE_VIEW && printf \"execute-silent:%s --edit-lyrics %s\" \"$0\" {4}" \
+        --bind="$KEYS_N_LYRICS_FETCH_CUSTOM:transform:$IN_NORMAL_MODE && $IN_RELEASE_VIEW && {$0 --lyrics-custom {3} {4};printf \"show-preview+preview:%s --lyrics %s %s\" \"$0\" {3} {4}}" \
        --bind="change:execute-silent($0 --mbsearch $FZF_CURRENT_VIEW &)+reload:$0 --lines $FZF_CURRENT_VIEW" \
        --preview-window="$FZF_DEFAULT_PREVIEW_WINDOW" \
        --wrap-sign="" \
--- a/src/sh/awk.sh
+++ b/src/sh/awk.sh
@@ -115,6 +115,7 @@ awk_releasegroups() {
      -v hassecondary_yes="$RGV_FMT_HASSECONDARY_YES" \
      -v hassecondary_no="$RGV_FMT_HASSECONDARY_NO" \
      -v fmtsecondary="$RGV_FMT_SECONDARY" \
+      -v secondary_compilation="$RGV_FMT_SECONDARY_COMPILATION" \
      -v secondary_soundtrack="$RGV_FMT_SECONDARY_SOUNDTRACK" \
      -v secondary_spokenword="$RGV_FMT_SECONDARY_SPOKENWORD" \
      -v secondary_interview="$RGV_FMT_SECONDARY_INTERVIEW" \
--- a/src/sh/cache.sh
+++ b/src/sh/cache.sh
@@ -238,6 +238,18 @@ cache_get_file_batch() {
    awk -v dir="$CACHEDIR/$1/" -v f="/$fn" '{ print dir $0 f }'
 }

+# Detect missing cache files
+#
+# @argument $1: type
+# @argument $2: path to list with MusicBrainz IDs
+#
+# This method returns a nonzero value if some MusicBrainz objects listed in $2
+# are not cached.
+cached() {
+  cache_get_file_batch "$1" <"$2" |
+    xargs -d '\n' ls >/dev/null 2>&1 || return 1
+}
+
 # Print MusicBrainz ID associated to the file paths
 #
 # This reads from stdin any number of paths (one per line)
@@ -295,3 +307,41 @@ cache_rm_release() {
  info "Removing $d from cache"
  rm -rf "$d"
 }
+
+# Load missing cache entries (batch mode)
+#
+# argument $1: type
+#
+# This method reads one MusicBrainz IDs of the specified type from stdin (one
+# per line), and fetches the missing items.
+batch_load_missing() {
+  tmpf=$(mktemp)
+  cat |
+    cache_get_file_batch "$1" |
+    xargs -d '\n' \
+      sh -c 'for f; do [ -e "$f" ] || echo "$f"; done' _ |
+    cache_mbid_from_path_batch >"$tmpf"
+  lines=$(wc -l "$tmpf" | cut -d ' ' -f 1)
+  if [ "$lines" -gt 0 ]; then
+    case "$1" in
+    "$TYPE_ARTIST") tt="artists" ;;
+    "$TYPE_RELEASEGROUP") tt="release groups" ;;
+    "$TYPE_RELEASE") tt="releases" ;;
+    esac
+    info "Fetching missing $tt"
+    cnt=0
+    while IFS= read -r mbid; do
+      case "$1" in
+      "$TYPE_ARTIST")
+        name=$(mb_artist "$mbid" | $JQ '.name')
+        ;;
+      "$TYPE_RELEASEGROUP") name=$(mb_releasegroup "$mbid" | $JQ '.title') ;;
+      "$TYPE_RELEASE") name=$(mb_release "$mbid" | $JQ '.title') ;;
+      esac
+      cnt=$((cnt + 1))
+      info "$(printf "%d/%d (%s: %s)" "$cnt" "$lines" "$mbid" "$name")"
+      sleep 1
+    done <"$tmpf"
+  fi
+  rm -f "$tmpf"
+}
--- a/src/sh/fzf.sh
+++ b/src/sh/fzf.sh
@@ -16,6 +16,10 @@ fzf_command_set_header() {
        $JQ '[.id, type, .name, .disambiguation] | join("\t")' |
        awk_artist_header
    )"
+    if [ ! "$header" ]; then
+      header="Possibly $mbid is not a MusicBrainz Artist ID"
+      err "$header"
+    fi
    ;;
  "$VIEW_RELEASEGROUP")
    header="$(
@@ -30,6 +34,10 @@ fzf_command_set_header() {
        ] | join("\t")' |
        awk_releasegroup_header
    )"
+    if [ ! "$header" ]; then
+      header="Possibly $mbid is not a MusicBrainz Release-Group ID"
+      err "$header"
+    fi
    ;;
  "$VIEW_RELEASE")
    header="$(
@@ -48,7 +56,15 @@ fzf_command_set_header() {
          ] | join("\t")' |
        awk_release_header
    )"
+    if [ ! "$header" ]; then
+      header="Possibly $mbid is not a MusicBrainz Release ID"
+      err "$header"
+    fi
+    ;;
+  *)
+    header="We entered an unknown state"
+    err "$header"
    ;;
  esac
-  printf "+change-header(%s)" "${header:-"???"}"
+  printf "+change-header(%s)" "$header"
 }
--- a/src/sh/info.sh
+++ b/src/sh/info.sh
@@ -3,7 +3,7 @@ if [ ! "${INFO_LOADED:-}" ]; then
  APP_NAME="fuzic"
  APP_VERSION="0.1"
  APP_WEBSITE="https://git.indyfac.ch/amin/fuzic"
-  WINDOW_TITLE="🔎🎶 $APP_NAME | a simple music finder and player"
+  WINDOW_TITLE="🔎🎶 $APP_NAME | a simple music browser and player"
  export APP_NAME APP_VERSION APP_WEBSITE WINDOW_TITLE

  export INFO_LOADED=1
--- a/src/sh/keys.sh
+++ b/src/sh/keys.sh
@@ -63,6 +63,11 @@
 # - KEYS_PREVIEW_TOGGLE_SIZE: Toggle size (small, large) of preview window
 # - KEYS_REFRESH: Refresh current entry
 #
+# Lyrics:
+# - KEYS_N_LYRICS: Show lyrics of selected track
+# - KEYS_LYRICS_EDIT: Edit lyrics of selected track
+# - KEYS_N_LYRICS_FETCH_CUSTOM: Fetch lyrics using custom command
+#
 # Playback:
 # - KEYS_PLAY: Play selected release or selected track
 # - KEYS_QUEUE: Queue selected release or selected track
@@ -87,7 +92,10 @@
 # - KEYS_PLAYLIST_GOTO_RELEASE: Jump to release or selected entry
 # - KEYS_PLAYLIST_STORE: Store current playlist as file
 # - KEYS_PLAYLIST_LOAD: Load playlist from file
-# - KEYS_PLAYLIST_QUIT: Quit playlist view
+#
+# Playlist store (here, we don't have a `normal` mode):
+# - KEYS_PLAYLISTSTORE_SELECT: Use selected playlist
+# - KEYS_PLAYLISTSTORE_DELETE: Delete stored playlist

 if [ ! "${KEYS_LOADED:-}" ]; then
  # Mode selection:
@@ -103,7 +111,7 @@ if [ ! "${KEYS_LOADED:-}" ]; then
  KEYS_N_DOWN="${KEYS_N_DOWN:-"j"}"
  KEYS_N_UP="${KEYS_N_UP:-"k"}"
  KEYS_N_BOT="${KEYS_N_BOT:-"G"}"
-  KEYS_N_TOP="${KEYS_N_TOP:-"g"}"
+  KEYS_N_TOP="${KEYS_N_TOP:-"1,g"}"
  export KEYS_DOWN KEYS_UP KEYS_HALFPAGE_DOWN KEYS_HALFPAGE_UP KEYS_N_DOWN \
    KEYS_N_UP KEYS_N_BOT KEYS_N_TOP

@@ -162,6 +170,12 @@ if [ ! "${KEYS_LOADED:-}" ]; then
    KEYS_PREVIEW_OPEN KEYS_PREVIEW_TOGGLE_WRAP KEYS_PREVIEW_TOGGLE_SIZE \
    KEYS_REFRESH

+  # Lyrics:
+  KEYS_N_LYRICS="${KEYS_N_LYRICS:-"L"}"
+  KEYS_LYRICS_EDIT="${KEYS_LYRICS_EDIT:-"alt-L"}"
+  KEYS_N_LYRICS_FETCH_CUSTOM="${KEYS_N_LYRICS_FETCH_CUSTOM:-"Y"}"
+  export KEYS_N_LYRICS KEYS_LYRICS_EDIT KEYS_N_LYRICS_FETCH_CUSTOM
+
  # Playback:
  KEYS_PLAY="${KEYS_PLAY:-"enter"}"
  KEYS_QUEUE="${KEYS_QUEUE:-"ctrl-alt-m"}" # That's actually alt-enter
@@ -199,11 +213,17 @@ if [ ! "${KEYS_LOADED:-}" ]; then
  KEYS_PLAYLIST_UNSHUFFLE="${KEYS_PLAYLIST_UNSHUFFLE:-"S"}"
  KEYS_PLAYLIST_GOTO_RELEASE="${KEYS_PLAYLIST_GOTO_RELEASE:-"ctrl-g"}"
  KEYS_PLAYLIST_STORE="${KEYS_PLAYLIST_STORE:-"ctrl-s"}"
-  KEYS_PLAYLIST_LOAD="${KEYS_PLAYLIST_LOAD:-"ctrl-o"}"
+  KEYS_PLAYLIST_OPEN_STORE="${KEYS_PLAYLIST_LOAD:-"ctrl-o"}"
+  KEYS_PLAYLIST_DELETE="${KEYS_PLAYLIST_DELETE:-"del"}"
  export KEYS_PLAYLIST_RELOAD KEYS_PLAYLIST_REMOVE KEYS_PLAYLIST_UP \
    KEYS_PLAYLIST_DOWN KEYS_PLAYLIST_CLEAR KEYS_PLAYLIST_CLEAR_ABOVE \
    KEYS_PLAYLIST_CLEAR_BELOW KEYS_PLAYLIST_SHUFFLE KEYS_PLAYLIST_UNSHUFFLE \
-    KEYS_PLAYLIST_GOTO_RELEASE KEYS_PLAYLIST_STORE KEYS_PLAYLIST_LOAD
+    KEYS_PLAYLIST_GOTO_RELEASE KEYS_PLAYLIST_STORE KEYS_PLAYLIST_OPEN_STORE
+
+  # Playlist store (here, we don't have a `normal` mode):
+  KEYS_PLAYLISTSTORE_SELECT="${KEYS_PLAYLISTSTORE_SELECT:-"enter"}"
+  KEYS_PLAYLISTSTORE_DELETE="${KEYS_PLAYLISTSTORE_DELETE:-"del"}"
+  export KEYS_PLAYLISTSTORE_SELECT KEYS_PLAYLISTSTORE_DELETE

  export KEYS_LOADED=1
 fi
@@ -281,7 +301,8 @@ print_keybindings() {
      "$KEYS_N_TOP" "Go to first entry" \
      "$KEYS_N_BOT" "Go to last entry" \
      "$KEYS_OUT,$KEYS_N_OUT,$KEYS_QUIT,$KEYS_N_QUIT" "Leave playlist view" \
-      "$KEYS_SELECT_ARTIST" "Go to artist of selected item"
+      "$KEYS_SELECT_ARTIST" "Go to artist of selected item" \
+      "$KEYS_PLAYLIST_GOTO_RELEASE" "Show release of selected track"
    __keybindinggroup_from_args "Views" \
      "$KEYS_LIST_ARTISTS" "Display artists in local database" \
      "$KEYS_LIST_ALBUMS" "Display albums in local database" \
@@ -297,7 +318,7 @@ print_keybindings() {
      "$KEYS_PLAYLIST_CLEAR_BELOW" "Remove all tracks below" \
      "$KEYS_PLAYLIST_SHUFFLE" "Shuffle" \
      "$KEYS_PLAYLIST_UNSHUFFLE" "Undo shuffle" \
-      "$KEYS_PLAYLIST_GOTO_RELEASE" "Show release of selected track"
+      "$KEYS_PLAYLIST_OPEN_STORE" "Manage stored playlists"
    __keybindinggroup_from_args "Playback" \
      "$KEYS_PLAY,$KEYS_N_PLAY" "Play selected item" \
      "$KEYS_QUEUE,$KEYS_N_QUEUE" "Queue selected item" \
@@ -307,12 +328,35 @@ print_keybindings() {
      "$KEYS_PLAY_PREV,$KEYS_N_PLAY_PREV" "Play previous track" \
      "$KEYS_SEEK_FORWARD,$KEYS_N_SEEK_FORWARD" "Seek forward" \
      "$KEYS_SEEK_BACKWARD,$KEYS_N_SEEK_BACKWARD" "Seek backward"
+    __keybindinggroup_from_args "Lyrics" \
+      "$KEYS_N_LYRICS" "Show lyrics" \
+      "$KEYS_LYRICS_EDIT" "Edit lyrics" \
+      "$KEYS_N_LYRICS_FETCH_CUSTOM" "Fetch lyrics using custom command"
    __keybindinggroup_from_args "Special operations" \
      "$KEYS_BROWSE" "Open selected item in browser" \
      "$KEYS_OPEN" "Open selected item in file manager" \
      "$KEYS_N_YANK" "Copy MusicBrainz track ID" \
      "$KEYS_YANK_CURRENT" "Copy MusicBrainz release ID"
    ;;
+  "$VIEW_PLAYLIST_PLAYLISTSTORE")
+    __keybindinggroup_from_args "Previews" \
+      "$KEYS_SCROLL_PREVIEW_DOWN" "Scroll preview down" \
+      "$KEYS_SCROLL_PREVIEW_UP" "Scroll preview up" \
+      "$KEYS_KEYBINDINGS" "Show these keybindings" \
+      "$KEYS_PREVIEW_TOGGLE_WRAP" "Toggle preview wrapping" \
+      "$KEYS_PREVIEW_TOGGLE_SIZE" "Toggle preview size" \
+      "$KEYS_PREVIEW_OPEN" "Open preview window" \
+      "$KEYS_PREVIEW_CLOSE" "Close preview window"
+    __keybindinggroup_from_args "Navigation" \
+      "$KEYS_DOWN" "Down" \
+      "$KEYS_UP" "Up" \
+      "$KEYS_HALFPAGE_DOWN" "Down half a page" \
+      "$KEYS_HALFPAGE_UP" "Up half a page" \
+      "$KEYS_OUT,$KEYS_QUIT" "Leave playlist store"
+    __keybindinggroup_from_args "Playlist store" \
+      "$KEYS_PLAYLISTSTORE_SELECT" "Load playlist" \
+      "$KEYS_PLAYLISTSTORE_DELETE" "Delete playlist"
+    ;;
  *)
    __keybindinggroup_from_args "Switch between modes" \
      "$KEYS_I_NORMAL" "Swtich to normal mode (insert)" \
@@ -376,6 +420,10 @@ print_keybindings() {
      "$KEYS_N_PLAY_PREV" "Play previous track" \
      "$KEYS_N_SEEK_FORWARD" "Seek forward" \
      "$KEYS_N_SEEK_BACKWARD" "Seek backward"
+    __keybindinggroup_from_args "Lyrics" \
+      "$KEYS_N_LYRICS" "Show lyrics (normal mode)" \
+      "$KEYS_LYRICS_EDIT" "Edit lyrics" \
+      "$KEYS_N_LYRICS_FETCH_CUSTOM" "Fetch lyrics using custom command (normal)"
    __keybindinggroup_from_args "Special operations" \
      "$KEYS_SHOW_PLAYLIST" "Show playlist" \
      "$KEYS_BROWSE" "Open selected item in browser" \
--- a/src/sh/lists.sh
+++ b/src/sh/lists.sh
@@ -98,6 +98,7 @@ list_artists_from_json() {
 # Print playlist currently loaded
 list_playlist() {
  count=$(mpv_playlist_count)
+  [ "$count" ] || return 0
  [ "$count" -eq 0 ] && return 0
  mpvquery=""
  for i in $(seq 0 $((count - 1))); do
@@ -105,3 +106,17 @@ list_playlist() {
  done
  __mpv_get "$mpvquery" | grep '.' | awk_playlist
 }
+
+# List stored playlist
+#
+# @argument $1: paylist name
+list_playlist_stored() {
+  t=$(mktemp)
+  r=$(mktemp)
+  generate_playlist_stored "$PLAYLIST_DIRECTORY/$1" |
+    grep "$(printf '\t')" |
+    cut -d "," -f 2- >"$t"
+  grep -v "/dev/null$" "$t" | cut -d "$(printf '\t')" -f 2 >"$r"
+  awk_recordings "$r" <"$t"
+  rm -f "$t" "$r"
+}
--- a/src/sh/local.sh
+++ b/src/sh/local.sh
@@ -157,7 +157,7 @@ END { for (i in id) print title[i], id[i], fname[i] }
 ' "$tmpj" "$tmpf" >"$assocfile"
  rm -f "$tmpj" "$tmpf"
  # Ask user if this is ok
-  info "We discovered the following associatoin:"
+  info "We discovered the following association:"
  while IFS= read -r line; do
    t="$(echo "$line" | cut -d "$(printf '\t')" -f 1)"
    f="$(echo "$line" | cut -d "$(printf '\t')" -f 3)"
@@ -183,44 +183,6 @@ END { for (i in id) print title[i], id[i], fname[i] }
  return 0
 }

-# Load missing cache entries (batch mode)
-#
-# argument $1: type
-#
-# This method reads one MusicBrainz IDs of the specified type from stdin (one
-# per line), and fetches the missing items.
-__batch_load_missing() {
-  tmpf=$(mktemp)
-  cat |
-    cache_get_file_batch "$1" |
-    xargs \
-      sh -c 'for f; do [ -e "$f" ] || echo "$f"; done' _ |
-    cache_mbid_from_path_batch >"$tmpf"
-  lines=$(wc -l "$tmpf" | cut -d ' ' -f 1)
-  if [ "$lines" -gt 0 ]; then
-    case "$1" in
-    "$TYPE_ARTIST") tt="artists" ;;
-    "$TYPE_RELEASEGROUP") tt="release groups" ;;
-    "$TYPE_RELEASE") tt="releases" ;;
-    esac
-    info "Fetching missing $tt"
-    cnt=0
-    while IFS= read -r mbid; do
-      case "$1" in
-      "$TYPE_ARTIST")
-        name=$(mb_artist "$mbid" | $JQ '.name')
-        ;;
-      "$TYPE_RELEASEGROUP") name=$(mb_releasegroup "$mbid" | $JQ '.title') ;;
-      "$TYPE_RELEASE") name=$(mb_release "$mbid" | $JQ '.title') ;;
-      esac
-      cnt=$((cnt + 1))
-      info "$(printf "%d/%d (%s: %s)" "$cnt" "$lines" "$mbid" "$name")"
-      sleep 1
-    done <"$tmpf"
-  fi
-  rm -f "$tmpf"
-}
-
 # Precompute lists
 #
 # The main views (VIEW_ARTIST and TYPE_RELEASEGROUP) for locally available
@@ -229,7 +191,7 @@ __batch_load_missing() {
 # theme-independent fashion. The lists are stored in the files
 # `LOCALDATA_ARTISTS_LIST` and `LOCALDATA_RELEASEGROUPS_LIST`.
 __precompute_lists() {
-  cache_get_file_batch "$TYPE_ARTIST" <"$LOCALDATA_ARTISTS" | xargs \
+  cache_get_file_batch "$TYPE_ARTIST" <"$LOCALDATA_ARTISTS" | xargs -d "\n" \
    $JQ '[
      .id,
      .type,
@@ -239,7 +201,7 @@ __precompute_lists() {
      .["life-span"].begin,
      .["life-span"].end
      ] | join("\t")' >"$LOCALDATA_ARTISTS_LIST" &
-  cache_get_file_batch "$TYPE_RELEASEGROUP" <"$LOCALDATA_RELEASEGROUPS" | xargs \
+  cache_get_file_batch "$TYPE_RELEASEGROUP" <"$LOCALDATA_RELEASEGROUPS" | xargs -d "\n" \
    $JQ '[
      .id,
      ."primary-type",
@@ -259,8 +221,6 @@ __precompute_lists() {
 precompute_views() {
  awk_artists "$SORT_ARTIST_DEFAULT" <"$LOCALDATA_ARTISTS_LIST" >"$LOCALDATA_ARTISTS_VIEW"
  awk_releasegroups "$SORT_RG_DEFAULT" <"$LOCALDATA_RELEASEGROUPS_LIST" >"$LOCALDATA_RELEASEGROUPS_VIEW"
-  #column -t -s "$(printf '\t')" |
-  #sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\)$|\t\1\t\2|' >"$LOCALDATA_RELEASEGROUPS_VIEW"
 }

 # Load local music
@@ -280,11 +240,11 @@ reloaddb() {
  tmpreleases=$(mktemp)
  cut -d "$(printf '\t')" -f 1 "$LOCALDATA_RELEASES" |
    tee "$tmpreleases" |
-    __batch_load_missing "$TYPE_RELEASE"
+    batch_load_missing "$TYPE_RELEASE"
  tmpreleasefiles=$(mktemp)
  cache_get_file_batch "$TYPE_RELEASE" <"$tmpreleases" >"$tmpreleasefiles"
  (
-    xargs \
+    xargs -d "\n" \
      $JQ '."release-group".id' \
      <"$tmpreleasefiles" >"$LOCALDATA_RELEASEGROUPS"
    tf1=$(mktemp)
@@ -292,7 +252,7 @@ reloaddb() {
    mv "$tf1" "$LOCALDATA_RELEASEGROUPS"
  ) &
  (
-    xargs \
+    xargs -d "\n" \
      $JQ '."release-group"."artist-credit" | map(.artist.id) | join("\n")' \
      <"$tmpreleasefiles" >"$LOCALDATA_ARTISTS"
    tf2=$(mktemp)
@@ -301,8 +261,8 @@ reloaddb() {
  ) &
  wait
  rm -f "$tmpreleases" "$tmpreleasefiles"
-  __batch_load_missing "$TYPE_RELEASEGROUP" <"$LOCALDATA_RELEASEGROUPS"
-  __batch_load_missing "$TYPE_ARTIST" <"$LOCALDATA_ARTISTS"
+  batch_load_missing "$TYPE_RELEASEGROUP" <"$LOCALDATA_RELEASEGROUPS"
+  batch_load_missing "$TYPE_ARTIST" <"$LOCALDATA_ARTISTS"
  __precompute_lists
 }

@@ -313,10 +273,8 @@ reloaddb() {
 # derivation of the MusicBrainz artist IDs and MusicBrainz release-group IDs
 # from the MusicBrainz releases (see the `reloaddb` method above).
 local_files_present() {
-  cache_get_file_batch "$TYPE_ARTIST" <"$LOCALDATA_ARTISTS" | xargs ls >/dev/null 2>&1 || return 1
-  cache_get_file_batch "$TYPE_RELEASEGROUP" <"$LOCALDATA_RELEASEGROUPS" | xargs ls >/dev/null 2>&1 || return 1
-  #cut -d "$(printf '\t')" -f 1 "$LOCALDATA_RELEASES" | cache_get_file_batch "$TYPE_RELEASE" | xargs ls >/dev/null 2>&1 || return 1
-  return 0
+  cached "$TYPE_ARTIST" "$LOCALDATA_ARTISTS" || return 1
+  cached "$TYPE_RELEASEGROUP" "$LOCALDATA_RELEASEGROUPS" || return 1
 }

 # Load missing files
@@ -324,7 +282,6 @@ local_files_present() {
 # If missing files were detected with `local_files_present`, then these missing
 # files may be cached using the present method.
 load_missing_files() {
-  __batch_load_missing "$TYPE_ARTIST" <"$LOCALDATA_ARTISTS"
-  __batch_load_missing "$TYPE_RELEASEGROUP" <"$LOCALDATA_RELEASEGROUPS"
-  #cut -d "$(printf '\t')" -f 1 "$LOCALDATA_RELEASES" | __batch_load_missing "$TYPE_RELEASE"
+  batch_load_missing "$TYPE_ARTIST" <"$LOCALDATA_ARTISTS"
+  batch_load_missing "$TYPE_RELEASEGROUP" <"$LOCALDATA_RELEASEGROUPS"
 }
--- a/src/sh/lyrics.sh
+++ b/src/sh/lyrics.sh
@@ -0,0 +1,121 @@
+# Methods and constants for lyrics handling
+#
+# Lyrics are retrieved as following:
+# 1. Check if the lyrics are already stored in this store
+# 2. If the track is playable, check if an accompanying `.lrc` file is present.
+# 3. If the track is playable, read lyrics from the tags
+# 4. Call custom fetch command
+#
+# The path to the lyrics is `__radix(mbid)/mbid.lrc` where `mbid` is the
+# MusicBrainz ID of the track.
+
+if [ ! "${LYRICS_LOADED:-}" ]; then
+  # Folder to store lyrics
+  LYRICS_DIRECTORY="${LYRICS_DIRECTORY:-"$LOCALDATADIR/lyrics"}"
+  [ -d "$LYRICS_DIRECTORY" ] || mkdir -p "$LYRICS_DIRECTORY"
+  export LYRICS_DIRECTORY
+
+  # Custom command to fetch lyrics
+  #
+  # This command reads from stdin the json object of the release and prints the
+  # lyrics of the track.
+  LYRICS_FETCH_CUSTOM="${LYRICS_FETCH_CUSTOM:-""}"
+  export LYRICS_FETCH_CUSTOM
+
+  export LYRICS_LOADED=1
+fi
+
+# File path for lyrics file
+#
+# @argument $1: MusicBrainz track ID
+lyrics_file() {
+  mbid="${1:-}"
+  echo "$LYRICS_DIRECTORY/$(__radix "$mbid").lrc"
+}
+
+# Store lyrics
+#
+# @argument $1: MusicBrainz track ID
+#
+# This methods reads from stdin and stores it.
+store_lyrics() {
+  mbid="${1:-}"
+  file="$(lyrics_file "$mbid")"
+  dir="$(dirname "$file")"
+  [ -d "$dir" ] || mkdir -p "$dir"
+  cat >"$file"
+}
+
+# Fetch lyrics using custom command and store them
+#
+# @argument $1: MusicBrainz release ID
+# @argument $2: MusicBrainz track ID
+#
+# The custom script is executed only if the environment variable is set. Else
+# the message stored in `$LYRICS_NO_LYRICS` is saved.
+store_lyrics_custom() {
+  rlid="${1:-}"
+  mbid="${2:-}"
+  if [ "$LYRICS_FETCH_CUSTOM" ]; then
+    mb_release "$rlid" |
+      $JQ --arg mbid "$mbid" '{release: ., trackid: $mbid}' |
+      sh -c "$LYRICS_FETCH_CUSTOM" |
+      store_lyrics "$mbid"
+  else
+    echo "$LYRICS_NO_LYRICS" |
+      store_lyrics "$mbid"
+  fi
+}
+
+# Print lyrics
+#
+# @argument $1: MusicBrainz release ID
+# @argument $2: MusicBrainz track ID
+lyrics() {
+  rlid="${1:-}"
+  mbid="${2:-}"
+  # 1. Check if lyrics has already been stored
+  file="$(lyrics_file "$mbid")"
+  if [ -f "$file" ]; then
+    cat "$file"
+    return
+  fi
+  # 2. & 3.: For playable tracks only
+  decoration="$(grep "^$rlid" "$LOCALDATA_RELEASES" | cut -d "$(printf '\t')" -f 2)"
+  if [ "$decoration" ] && [ -f "$decoration" ]; then
+    afname="$($JQ --arg mbid "$mbid" '.tracks | to_entries[] | select(.key == $mbid) | .value' "$decoration")"
+    af="$(dirname "$decoration")/$afname"
+    # Check if `.lrc` file exists
+    lf="$(echo "$af" | rev | cut -d "." -f 2- | rev).lrc"
+    if [ -f "$lf" ]; then
+      store_lyrics "$mbid" <"$lf"
+      cat "$file"
+      return
+    fi
+    # Read lyrics from tag
+    if [ "$FFPROBE" ]; then
+      lyrics="$($FFPROBE -v error -show_entries format_tags -print_format json "$af" |
+        $JQ '.format.tags | ."USLT:description" // ."LYRICS" // ."Lyrics" // ."©lyr" // ."WM/Lyrics" // ""')"
+      if [ "$lyrics" ]; then
+        echo "$lyrics" | store_lyrics "$mbid"
+        cat "$file"
+        return
+      fi
+    fi
+  fi
+  # Make call to external command
+  store_lyrics_custom "$rlid" "$mbid"
+  cat "$file"
+}
+
+# Reload lyrics file
+#
+# @argument $1: MusicBrainz release ID
+# @argument $2: MusicBrainz track ID
+reload_lyrics() {
+  rlid="${1:-}"
+  mbid="${2:-}"
+  file="$(lyrics_file "$mbid")"
+  rm -f "$file"
+  lyrics "$rlid" "$mbid"
+}
--- a/src/sh/playback.sh
+++ b/src/sh/playback.sh
@@ -43,51 +43,6 @@ __playback_cmd_from_key() {
  case ",$KEYS_N_SEEK_BACKWARD," in *",$key,"*) echo "$PLAYBACK_CMD_SEEK_BACKWARD" && return ;; esac
 }

-# Generate playlist from MB release ID and path to decoration
-#
-# @argument $1: MusicBrainz release ID
-# @argument $2: Path to decoration file
-# @argument $3: MusicBrainz track ID to select (optional)
-__generate_playlist() {
-  printf "#EXTM3U\n"
-  dir="$(dirname "$2")"
-  mb_release "$1" |
-    $JQ \
-      --slurpfile decofile "$2" \
-      --arg base "$dir" \
-      --arg deco "$2" \
-      --arg tid "${3:-}" \
-      '$decofile[].tracks as $filenames |
-        . |
-        .id as $rid |
-        .media |
-        length as $l |
-        .[] |
-        .position as $pos |
-        .tracks |
-        if ($tid == "") then . else map(select(.id == $tid)) end |
-        map({
-          t: [
-          $rid,
-          .id,
-          $l,
-          $pos,
-          .number,
-          .length,
-          .title,
-          (."artist-credit" | map([.name, .joinphrase] | join("")) | join("")),
-          $deco
-          ] | join("\t"),
-          length: (.length // 0 / 1000 | round | tostring),
-          $pos,
-          number: .number,
-          file: $filenames[.id]
-        }) |
-        map(if(.number | type == "string" and test("^[0-9]+$")) then .number |= tonumber else . end) |
-        sort_by([.pos, .number]) |
-        map("#EXTINF:" + .length + "," + .t + "\n" + $base + "/" + .file)[]'
-}
-
 # Main playback method
 #
 # @argument $1: view
@@ -122,10 +77,10 @@ playback() {
              rpath="$(echo "$line" | cut -d "$(printf '\t')" -f 5)"
              [ "$rpath" ] || continue
              if [ ! "$queue" ]; then
-                __generate_playlist "$rmbid" "$rpath" | mpv_play_list >/dev/null
+                generate_playlist "$rmbid" "$rpath" | mpv_play_list >/dev/null
                queue=1
              else
-                __generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
+                generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
              fi
            done
          queue=1
@@ -138,15 +93,15 @@ playback() {
          rpath="$(echo "$line" | cut -d "$(printf '\t')" -f 5)"
          [ "$rpath" ] || continue
          if [ ! "${queue:-}" ]; then
-            __generate_playlist "$rmbid" "$rpath" | mpv_play_list >/dev/null
+            generate_playlist "$rmbid" "$rpath" | mpv_play_list >/dev/null
            queue=1
          else
-            __generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
+            generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
          fi
        done
      ;;
-    "$VIEW_RELEASEGROUP") __generate_playlist "$mbid" "$path" | mpv_play_list >/dev/null ;;
-    "$VIEW_RELEASE") __generate_playlist "$mbid_current" "$path" "$mbid" | mpv_play_list >/dev/null ;;
+    "$VIEW_RELEASEGROUP") generate_playlist "$mbid" "$path" | mpv_play_list >/dev/null ;;
+    "$VIEW_RELEASE") generate_playlist "$mbid_current" "$path" "$mbid" | mpv_play_list >/dev/null ;;
    "$VIEW_PLAYLIST") mpv_play_index $((FZF_POS - 1)) >/dev/null ;;
    esac
    ;;
@@ -164,7 +119,7 @@ playback() {
              rmbid="$(echo "$line" | cut -d "$(printf '\t')" -f 4)"
              rpath="$(echo "$line" | cut -d "$(printf '\t')" -f 5)"
              [ "$rpath" ] || continue
-              __generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
+              generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
            done
        done
      ;;
@@ -174,12 +129,12 @@ playback() {
          rmbid="$(echo "$line" | cut -d "$(printf '\t')" -f 4)"
          rpath="$(echo "$line" | cut -d "$(printf '\t')" -f 5)"
          [ "$rpath" ] || continue
-          __generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
+          generate_playlist "$rmbid" "$rpath" | mpv_queue_list >/dev/null
        done
      ;;
-    "$VIEW_RELEASEGROUP") __generate_playlist "$mbid" "$path" | mpv_queue_list >/dev/null ;;
-    "$VIEW_RELEASE") __generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_list >/dev/null ;;
-    "$VIEW_PLAYLIST") __generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_list >/dev/null ;;
+    "$VIEW_RELEASEGROUP") generate_playlist "$mbid" "$path" | mpv_queue_list >/dev/null ;;
+    "$VIEW_RELEASE") generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_list >/dev/null ;;
+    "$VIEW_PLAYLIST") generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_list >/dev/null ;;
    esac
    ;;
  "$PLAYBACK_CMD_QUEUE_NEXT")
@@ -196,7 +151,7 @@ playback() {
              rmbid="$(echo "$line" | cut -d "$(printf '\t')" -f 4)"
              rpath="$(echo "$line" | cut -d "$(printf '\t')" -f 5)"
              [ "$rpath" ] || continue
-              __generate_playlist "$rmbid" "$rpath" | mpv_queue_next_list >/dev/null
+              generate_playlist "$rmbid" "$rpath" | mpv_queue_next_list >/dev/null
            done
        done
      ;;
@@ -206,12 +161,12 @@ playback() {
          rmbid="$(echo "$line" | cut -d "$(printf '\t')" -f 4)"
          rpath="$(echo "$line" | cut -d "$(printf '\t')" -f 5)"
          [ "$rpath" ] || continue
-          __generate_playlist "$rmbid" "$rpath" | mpv_queue_next_list >/dev/null
+          generate_playlist "$rmbid" "$rpath" | mpv_queue_next_list >/dev/null
        done
      ;;
-    "$VIEW_RELEASEGROUP") __generate_playlist "$mbid" "$path" | mpv_queue_next_list >/dev/null ;;
-    "$VIEW_RELEASE") __generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_next_list >/dev/null ;;
-    "$VIEW_PLAYLIST") __generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_next_list >/dev/null ;;
+    "$VIEW_RELEASEGROUP") generate_playlist "$mbid" "$path" | mpv_queue_next_list >/dev/null ;;
+    "$VIEW_RELEASE") generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_next_list >/dev/null ;;
+    "$VIEW_PLAYLIST") generate_playlist "$mbid_current" "$path" "$mbid" | mpv_queue_next_list >/dev/null ;;
    esac
    ;;
  "$PLAYBACK_CMD_TOGGLE_PLAYBACK") mpv_toggle_pause ;;
--- a/src/sh/playlist.sh
+++ b/src/sh/playlist.sh
@@ -3,6 +3,7 @@
 # This files provides an interface to manipulate the playlist. The available
 # commands are defined in the following variables.
 if [ ! "${PLAYLIST_LOADED:-}" ]; then
+  # Playlist commands
  PLAYLIST_CMD_REMOVE="rm"
  PLAYLIST_CMD_UP="up"
  PLAYLIST_CMD_DOWN="down"
@@ -11,13 +12,151 @@ if [ ! "${PLAYLIST_LOADED:-}" ]; then
  PLAYLIST_CMD_CLEAR_BELOW="clear-below"
  PLAYLIST_CMD_SHUFFLE="shuffle"
  PLAYLIST_CMD_UNSHUFFLE="unshuffle"
+  PLAYLIST_CMD_LOAD="load"
  export PLAYLIST_CMD_REMOVE PLAYLIST_CMD_UP PLAYLIST_CMD_DOWN \
    PLAYLIST_CMD_CLEAR PLAYLIST_CMD_CLEAR_ABOVE PLAYLIST_CMD_CLEAR_BELOW \
-    PLAYLIST_CMD_SHUFFLE PLAYLIST_CMD_UNSHUFFLE
+    PLAYLIST_CMD_SHUFFLE PLAYLIST_CMD_UNSHUFFLE PLAYLIST_CMD_LOAD
+
+  # Storage and loading of playlists
+  PLAYLIST_DIRECTORY="${PLAYLIST_DIRECTORY:-"$LOCALDATADIR/playlists"}"
+  [ -d "$PLAYLIST_DIRECTORY" ] || mkdir -p "$PLAYLIST_DIRECTORY"
+  export PLAYLIST_DIRECTORY

  export PLAYLIST_LOADED=1
 fi

+# List stored playlists
+#
+# This prints the names of the stored playlists.
+stored_playlists() {
+  find "$PLAYLIST_DIRECTORY" -mindepth 1 -maxdepth 1 -type f -printf "$PLYSTORE_PLAYLIST\t%f\n" |
+    sort
+}
+
+# Generate playlist from MB release ID and path to decoration
+#
+# @argument $1: MusicBrainz release ID
+# @argument $2: Path to decoration file
+# @argument $3: MusicBrainz track ID to select (optional)
+generate_playlist() {
+  printf "#EXTM3U\n"
+  dir="$(dirname "$2")"
+  mb_release "$1" |
+    $JQ \
+      --slurpfile decofile "$2" \
+      --arg base "$dir" \
+      --arg deco "$2" \
+      --arg tid "${3:-}" \
+      '$decofile[].tracks as $filenames |
+        . |
+        .id as $rid |
+        .media |
+        length as $l |
+        .[] |
+        .position as $pos |
+        .tracks |
+        if ($tid == "") then . else map(select(.id == $tid)) end |
+        map({
+          t: [
+          $rid,
+          .id,
+          $l,
+          $pos,
+          .number,
+          .length,
+          .title,
+          (."artist-credit" | map([.name, .joinphrase] | join("")) | join("")),
+          $deco
+          ] | join("\t"),
+          length: (.length // 0 / 1000 | round | tostring),
+          $pos,
+          number: .number,
+          file: $filenames[.id]
+        }) |
+        map(if(.number | type == "string" and test("^[0-9]+$")) then .number |= tonumber else . end) |
+        sort_by([.pos, .number]) |
+        map("#EXTINF:" + .length + "," + .t + "\n" + $base + "/" + .file)[]'
+}
+
+# Generate m3u playlist from stored playlist
+#
+# @argument $1: Playlist file
+generate_playlist_stored() {
+  f="${1:-}"
+  [ -s "$f" ] || return
+  # Check that we have all releases cached, else fetch missing ones
+  relf=$(mktemp)
+  cut -d "$(printf '\t')" -f 1 "$f" >"$relf"
+  cached "$TYPE_RELEASE" "$relf" || batch_load_missing "$TYPE_RELEASE" <"$relf"
+  jrelf=$(mktemp)
+  # Write json file with all releases
+  cache_get_file_batch "$TYPE_RELEASE" <"$relf" |
+    xargs -d '\n' cat >"$jrelf"
+  # Get associated decorations and write json file with all decorations
+  jpf=$(mktemp)
+  jdecf=$(mktemp)
+  awk -F '\t' \
+    -v rfile="$LOCALDATA_RELEASES" \
+    'BEGIN {
+      OFS="\t"
+      while ((getline < rfile) == 1)
+        release[$1] = $2
+      close(rfile)
+      print "["
+    }
+    NR > 1 { print "," }
+    { print "{\"rid\":\"" $1 "\",\"tid\":\"" $2 "\",\"deco\":\"" (release[$1] ? release[$1] : "") "\"}" }
+  END {print "]"}' <"$f" >"$jpf"
+  $JQ 'map(.deco) | join("\n")' "$jpf" |
+    grep '.' |
+    xargs -d '\n' cat >"$jdecf"
+  # Merge all data using jq and print playlist
+  printf "#EXTM3U\n"
+  $JQ \
+    --slurpfile deco "$jdecf" \
+    --slurpfile mb "$jrelf" \
+    '$deco as $decorations |
+      $mb as $releases |
+      map(
+        . as $item |
+        first(
+          if ($item.deco | length) > 0 then
+            ($item.deco | sub("/[^/]+$"; "")) as $base |
+              first($deco[] | select(.releaseid == $item.rid).tracks | to_entries[] | select(.key == $item.tid).value) as $fn |
+            $base + "/" + $fn
+          else
+            "/dev/null"
+          end
+        ) as $p |
+        first(
+          $mb[] | select(.id == $item.rid).media[].tracks[] | select(.id == $item.tid)
+        ) as $track |
+        (
+          $track.length // 0 / 1000 | round | tostring
+        ) as $length |
+        ( if ($item.deco | length) > 0 then $item.deco else "/dev/null" end) as $d |
+        $item + {
+          path: $p,
+          length: $length,
+          t: [
+            $item.rid,
+            $item.tid,
+            "",
+            "",
+            "",
+            $length,
+            $track.title,
+            ($track."artist-credit" | map([.name, .joinphrase] | join("")) | join("")),
+            $d
+          ] | join("\t")
+        }
+      ) |
+      map("#EXTINF:" + .length + "," + .t + "\n" + .path)[]' \
+    "$jpf"
+  # Clean up
+  rm -f "$relf" "$jrelf" "$jpf" "$jdecf"
+}
+
 # Run playback commands
 #
 # @argument $1: playlist command
@@ -43,5 +182,10 @@ playlist() {
    ;;
  "$PLAYLIST_CMD_SHUFFLE") mpv_playlist_shuffle ;;
  "$PLAYLIST_CMD_UNSHUFFLE") mpv_playlist_unshuffle ;;
+  "$PLAYLIST_CMD_LOAD")
+    f="$PLAYLIST_DIRECTORY/${2:-}"
+    [ -s "$f" ] || return
+    generate_playlist_stored "$f" | mpv_play_list >/dev/null
+    ;;
  esac
 }
--- a/src/sh/theme.sh
+++ b/src/sh/theme.sh
@@ -19,6 +19,7 @@ if [ ! "${THEME_LOADED:-}" ]; then
  CNOTE="${ESC}[38;5;242m"
  CXXX="${ESC}[38;5;109m"
  CDESC="${ESC}[38;5;254m"
+  CPURPLE="${ESC}[38;5;213m"
  CKB="${ESC}[38;5;224m"
  OFF="${ESC}[m"

@@ -99,6 +100,7 @@ if [ ! "${THEME_LOADED:-}" ]; then
  RGV_FMT_HASSECONDARY_YES="${RGV_FMT_HASSECONDARY_YES:-"☼"}"
  RGV_FMT_HASSECONDARY_NO="${RGV_FMT_HASSECONDARY_NO:-""}"
  RGV_FMT_SECONDARY="${RGV_FMT_SECONDARY:-"${CNOTE}[☼: %s]${OFF}"}"
+  RGV_FMT_SECONDARY_COMPILATION="${RGV_FMT_SECONDARY_COMPILATION:-"🧩 compilation"}"
  RGV_FMT_SECONDARY_SOUNDTRACK="${RGV_FMT_SECONDARY_SOUNDTRACK:-"🎬 soundtrack"}"
  RGV_FMT_SECONDARY_SPOKENWORD="${RGV_FMT_SECONDARY_SPOKENWORD:-"📖 spokenword"}"
  RGV_FMT_SECONDARY_INTERVIEW="${RGV_FMT_SECONDARY_INTERVIEW:-"💬 interview"}"
@@ -117,12 +119,13 @@ if [ ! "${THEME_LOADED:-}" ]; then
    RGV_FMT_FLAG_NO_LOCAL RGV_FMT_TYPE_SINGLE RGV_FMT_TYPE_ALBUM \
    RGV_FMT_TYPE_EP RGV_FMT_TYPE_BROADCAST RGV_FMT_TYPE_OTHER \
    RGV_FMT_TYPE_UNKNOWN RGV_FMT_HASSECONDARY_YES RGV_FMT_HASSECONDARY_NO \
-    RGV_FMT_SECONDARY RGV_FMT_SECONDARY_SOUNDTRACK \
-    RGV_FMT_SECONDARY_SPOKENWORD RGV_FMT_SECONDARY_INTERVIEW \
-    RGV_FMT_SECONDARY_AUDIOBOOK RGV_FMT_SECONDARY_AUDIODRAMA \
-    RGV_FMT_SECONDARY_LIVE RGV_FMT_SECONDARY_REMIX RGV_FMT_SECONDARY_DJMIX \
-    RGV_FMT_SECONDARY_MIXTAPE RGV_FMT_SECONDARY_DEMO \
-    RGV_FMT_SECONDARY_FIELDREC RGV_FMT_TITLE RGV_FMT_ARTIST RGV_FMT_YEAR
+    RGV_FMT_SECONDARY RGV_FMT_SECONDARY_COMPILATION \
+    RGV_FMT_SECONDARY_SOUNDTRACK RGV_FMT_SECONDARY_SPOKENWORD \
+    RGV_FMT_SECONDARY_INTERVIEW RGV_FMT_SECONDARY_AUDIOBOOK \
+    RGV_FMT_SECONDARY_AUDIODRAMA RGV_FMT_SECONDARY_LIVE \
+    RGV_FMT_SECONDARY_REMIX RGV_FMT_SECONDARY_DJMIX \
+    RGV_FMT_SECONDARY_MIXTAPE RGV_FMT_SECONDARY_DEMO RGV_FMT_SECONDARY_FIELDREC \
+    RGV_FMT_TITLE RGV_FMT_ARTIST RGV_FMT_YEAR

  # Release view
  # ============
@@ -172,7 +175,7 @@ if [ ! "${THEME_LOADED:-}" ]; then
  # <<duration>>   string   Track duration
  REC_FMT="${REC_FMT:-"<<flag>>\t<<media>>\t<<nr>>\t<<title>>\t<<artist>>\t<<duration>>"}"
  REC_FMT_CNT=$(($(printf "$REC_FMT" | tr -cd '\t' | wc -c) + 1))
-  REC_FMT_RIGHTALIGN="${REC_FMT_RIGHTALIGN:-"1,2,3,6"}"
+  REC_FMT_RIGHTALIGN="${REC_FMT_RIGHTALIGN:-"1,2,3"}"
  REC_FMT_FLAG_LOCAL="${REC_FMT_FLAG_LOCAL:-"$FORMAT_LOCAL"}"
  REC_FMT_FLAG_NO_LOCAL="${REC_FMT_FLAG_NO_LOCAL:-""}"
  REC_FMT_MEDIA="${REC_FMT_MEDIA:-"${CNOTE}${FAINT}%s${OFF}"}"
@@ -237,6 +240,7 @@ if [ ! "${THEME_LOADED:-}" ]; then
  HEADER_RG_FMT_HASSECONDARY_YES="${HEADER_RG_FMT_HASSECONDARY_YES:-"$RGV_FMT_HASSECONDARY_YES"}"
  HEADER_RG_FMT_HASSECONDARY_NO="${HEADER_RG_FMT_HASSECONDARY_NO:-"$RGV_FMT_HASSECONDARY_NO"}"
  HEADER_RG_FMT_SECONDARY="${HEADER_RG_FMT_SECONDARY:-"$RGV_FMT_SECONDARY"}"
+  HEADER_RG_FMT_SECONDARY_COMPILATION="${HEADER_RG_FMT_SECONDARY_COMPILATION:-"$RGV_FMT_SECONDARY_COMPILATION"}"
  HEADER_RG_FMT_SECONDARY_SOUNDTRACK="${HEADER_RG_FMT_SECONDARY_SOUNDTRACK:-"$RGV_FMT_SECONDARY_SOUNDTRACK"}"
  HEADER_RG_FMT_SECONDARY_SPOKENWORD="${HEADER_RG_FMT_SECONDARY_SPOKENWORD:-"$RGV_FMT_SECONDARY_SPOKENWORD"}"
  HEADER_RG_FMT_SECONDARY_INTERVIEW="${HEADER_RG_FMT_SECONDARY_INTERVIEW:-"$RGV_FMT_SECONDARY_INTERVIEW"}"
@@ -257,13 +261,13 @@ if [ ! "${THEME_LOADED:-}" ]; then
    HEADER_RG_FMT_TYPE_BROADCAST HEADER_RG_FMT_TYPE_OTHER \
    HEADER_RG_FMT_TYPE_UNKNOWN HEADER_RG_FMT_HASSECONDARY_YES \
    HEADER_RG_FMT_HASSECONDARY_NO HEADER_RG_FMT_SECONDARY \
-    HEADER_RG_FMT_SECONDARY_SOUNDTRACK HEADER_RG_FMT_SECONDARY_SPOKENWORD \
-    HEADER_RG_FMT_SECONDARY_INTERVIEW HEADER_RG_FMT_SECONDARY_AUDIOBOOK \
-    HEADER_RG_FMT_SECONDARY_AUDIODRAMA HEADER_RG_FMT_SECONDARY_LIVE \
-    HEADER_RG_FMT_SECONDARY_REMIX HEADER_RG_FMT_SECONDARY_DJMIX \
-    HEADER_RG_FMT_SECONDARY_MIXTAPE HEADER_RG_FMT_SECONDARY_DEMO \
-    HEADER_RG_FMT_SECONDARY_FIELDREC HEADER_RG_FMT_TITLE HEADER_RG_FMT_ARTIST \
-    HEADER_RG_FMT_YEAR
+    HEADER_RG_FMT_SECONDARY_COMPILATION HEADER_RG_FMT_SECONDARY_SOUNDTRACK \
+    HEADER_RG_FMT_SECONDARY_SPOKENWORD HEADER_RG_FMT_SECONDARY_INTERVIEW \
+    HEADER_RG_FMT_SECONDARY_AUDIOBOOK HEADER_RG_FMT_SECONDARY_AUDIODRAMA \
+    HEADER_RG_FMT_SECONDARY_LIVE HEADER_RG_FMT_SECONDARY_REMIX \
+    HEADER_RG_FMT_SECONDARY_DJMIX HEADER_RG_FMT_SECONDARY_MIXTAPE \
+    HEADER_RG_FMT_SECONDARY_DEMO HEADER_RG_FMT_SECONDARY_FIELDREC \
+    HEADER_RG_FMT_TITLE HEADER_RG_FMT_ARTIST HEADER_RG_FMT_YEAR

  # Header that displays the release (based on release view)
  HEADER_R_FMT="${HEADER_R_FMT:-"🎤\t<<artist>> 》<<title>> 〉<<tracks>> ${CRELINFO}tx${OFF} <<media>> | <<label>> <<country>> <<year>>"}"
@@ -387,5 +391,18 @@ if [ ! "${THEME_LOADED:-}" ]; then
  KBF_DESC="${KBF_DESC:-"${CKB}%s${OFF}"}"
  export KBF_GROUP KBF_KEY KBF_DESC

+  # Playlist title and playlist store
+  # =================================
+  TITLE_PLYLST="${TITLE_PLYLST:-"  🎶 ${CARTIST}Playlist${OFF}  "}"
+  TITLE_PLYLST_STORE="${TITLE_PLYLST_STORE:-"  🎶 ${CARTIST}Stored Playlists${OFF}  "}"
+  # In the following %f is the file name
+  PLYSTORE_PLAYLIST="${PLYSTORE_PLAYLIST:-"🎼 ${CPURPLE}%f${OFF}"}"
+  export TITLE_PLYLST TITLE_PLYLST_STORE PLYSTORE_PLAYLIST
+
+  # Lyrics
+  # ======
+  LYRICS_NO_LYRICS="${LYRICS_NO_LYRICS:-"(no lyrics)"}"
+  export LYRICS_NO_LYRICS
+
  export THEME_LOADED=1
 fi
--- a/src/sh/tools.sh
+++ b/src/sh/tools.sh
@@ -55,5 +55,25 @@ if [ ! "${TOOLS_LOADED:-}" ]; then
  command -v "xsel" >/dev/null && CLIP="xsel" || CLIP="true"
  export CLIP

+  # Detect external editor
+  editor="${EDITOR:-vi}"
+  if command -v "$editor" >/dev/null; then
+    if command -v "kitty" >/dev/null; then
+      extedit=$(printf "kitty %s" "$editor")
+    elif command -v "x-terminal-emulator" >/dev/null; then
+      extedit=$(printf "x-terminal-emulator -e %s" "$editor")
+    elif command -v "gnome-terminal" >/dev/null; then
+      extedit=$(printf "gnome-terminal -- %s" "$editor")
+    elif command -v "xterm" >/dev/null; then
+      extedit=$(printf "xterm -e %s" "$editor")
+    else
+      extedit=""
+    fi
+  else
+    extedit=""
+  fi
+  EXTERNALEDIT="${EXTERNALEDIT:-"$extedit"}"
+  export EXTERNALEDIT
+
  export TOOLS_LOADED=1
 fi
Author	SHA1	Message	Date
Ämin Baumeler	ed12cef7e4	typos fixed	2025-10-16 21:01:42 +02:00
Ämin Baumeler	06485fbce7	typo fixed and feature update	2025-10-15 20:38:00 +02:00
Ämin Baumeler	214a1cda4c	bugfix: playlist list	2025-10-15 15:22:40 +02:00
Ämin Baumeler	d13436b963	feat: lyrics support readme and examples	2025-10-15 09:12:02 +02:00
Ämin Baumeler	4343521a46	bugfix: enter past releases	2025-10-14 22:38:36 +02:00
Ämin Baumeler	6db95d3feb	feat: lyrics support	2025-10-14 22:33:36 +02:00
Ämin Baumeler	a0f8e79665	bugfix: xargs delim	2025-10-13 22:30:04 +02:00
Ämin Baumeler	fde3b6edcb	added example playlist	2025-10-13 22:14:27 +02:00
Ämin Baumeler	c0463c0d5e	imprv: faster playlist handling and a few bugs fixed	2025-10-13 22:07:26 +02:00
Ämin Baumeler	3b66faed6f	updated planned features	2025-10-11 23:06:19 +02:00
Ämin Baumeler	13f40e9720	feat: playlist store	2025-10-11 23:01:48 +02:00
Ämin Baumeler	2bf0506351	bugfix: right-align duration in playlist view	2025-10-10 11:01:43 +02:00
Ämin Baumeler	57ed2f6d0e	minor typos fixed	2025-10-10 10:53:48 +02:00
Ämin Baumeler	6bfb7f0399	improved readme	2025-10-10 10:50:16 +02:00
Ämin Baumeler	05661c0d98	minor improvements	2025-10-10 10:17:53 +02:00
Ämin Baumeler	08ea6cf56c	minor improvements	2025-10-10 09:55:49 +02:00
Ämin Baumeler	a4cb7d5c72	bugfix	2025-10-09 16:22:56 +02:00
Ämin Baumeler	8c67085f05	added screenshots	2025-10-09 16:22:04 +02:00
Ämin Baumeler	11446031bf	readme improved	2025-10-09 16:10:39 +02:00
Ämin Baumeler	1c4611e833	typo in readme	2025-10-09 16:10:13 +02:00
Ämin Baumeler	076e3c0c5e	added readme and licences	2025-10-09 16:05:42 +02:00
Ämin Baumeler	acb6ff7e1d	bugfix: fzf call with empty current mbid	2025-10-08 17:26:34 +02:00
Ämin Baumeler	e1aaf14814	configuratble playlist title	2025-10-08 17:16:47 +02:00