cleaned up

from VIEW_PLAYLIST and VIEW_SELECT_ARTIST we can now go "back"

.gitignore

@@ -1,2 +1,3 @@
 demo
 muf
+muf.debug.log

share/theme/bw.sh

@@ -0,0 +1,117 @@
+# Simple black-and-white theme
+
+# Pointers
+# ========
+# Sign that indicates the existence of audio files
+FORMAT_LOCAL="|>"
+# Pointer to the track currently playing (playlist)
+FORMAT_CURRENT="->"
+
+# Input prompts
+# =============
+# General search prompt
+SEARCH_PROMPT="search> "
+# Prompt that takes an artist name as argument
+ARTIST_PROMPT="%s > "
+# Prompt that takes an artist name and a release name as arguments (in that
+# order)
+FULL_PROMPT="%s > %s > "
+
+# Visual representation of current mode
+# =====================================
+# Sign to indicate `normal` mode
+PROMPT_NORMAL="n  "
+# Sign to indicate `insert` mode
+PROMPT_INSERT="i  "
+
+# Artist view
+# ===========
+# Artist string for persons
+AV_PERSON="<<name>>"
+# Artist string for groups
+AV_GROUP="<<name>>"
+# Artist disambiguation string
+AV_DISAMBIGUATION=" (<<disambiguation>>)"
+
+# Release-group view
+# ==================
+# Default release group string
+RGV_RELEASE="<<title>>"
+# Release group string if the artist name differs from the current artist
+RGV_RELEASE_W_ARTIST="<<title>> by <<artist>>"
+# Year of the release group
+RGV_YEAR="[<<year>>]"
+
+# Release-group types
+# ===================
+# Album
+FORMAT_TYPE_ALBUM="[LP]"
+# EP
+FORMAT_TYPE_EP="[EP]"
+# Single
+FORMAT_TYPE_SINGLE="[single]"
+# Broadcast
+FORMAT_TYPE_BROADCAST="[broadcast]"
+# Other
+FORMAT_TYPE_OTHER="[other]"
+# Flag to indicate that the given release group has associated secondary types.
+FORMAT_TYPE_HAS_SECONDARY="%s xx"
+# Style to represent secondary types (takes one %s placeholder)
+FORMAT_TYPE_SECONDARY="(%s)"
+# Secondary types
+FORMAT_TYPE_SECONDARY_COMPILATION="compilation"
+FORMAT_TYPE_SECONDARY_SOUNDTRACK="OST"
+FORMAT_TYPE_SECONDARY_SPOKENWORD="spokenword"
+FORMAT_TYPE_SECONDARY_INTERVIEW="interview"
+FORMAT_TYPE_SECONDARY_AUDIOBOOK="book"
+FORMAT_TYPE_SECONDARY_AUDIODRAMA="drama"
+FORMAT_TYPE_SECONDARY_LIVE="live"
+FORMAT_TYPE_SECONDARY_REMIX="remix"
+FORMAT_TYPE_SECONDARY_DJMIX="DJ"
+FORMAT_TYPE_SECONDARY_MIXTAPE="mixtape"
+FORMAT_TYPE_SECONDARY_DEMO="demo"
+FORMAT_TYPE_SECONDARY_FIELDREC="field rec"
+
+# Artist Preview
+# ==============
+# Main preview format. Takes two %s placeholder. The first is for the artist
+# biography. The second for the life span.
+APV_FORMAT="\n\n%s\n\n%s"
+# Specification of a date
+APV_DATE="%s"
+# Specification of a place
+APV_PLACE="%s"
+# Specification of a date and a place (in that order)
+APV_DATEPLACE="%s in %s"
+# String to represent when/where a person is born
+APV_BORN="Born: %s"
+# String to represent when/where a person died
+APV_DIED="Died: %s"
+
+# Release view
+# ============
+# Format of a string that represents a release.
+RV_FORMAT="<<status>>\t<<tracks>> tracks\t<<media>>\t<<year>>\t<<country>>\t<<label>>"
+# Additional string to display the release title and artist name
+RV_TITLE_ARTIST="<<artist>> - <<title>>"
+# Additional string to display the release title
+RV_TITLE="<<title>>"
+# Additional string to display the artist
+RV_ARTIST="<<artist>>"
+
+# Release Status
+# ==============
+FORMAT_STATUS_OFFICIAL="official"
+FORMAT_STATUS_PROMO="promo"
+FORMAT_STATUS_BOOTLEG="bootleg"
+FORMAT_STATUS_PSEUDO="psuedo"
+FORMAT_STATUS_WITHDRAWN="withdrawn"
+FORMAT_STATUS_EXPUNGED="expunged"
+FORMAT_STATUS_CANCELLED="cancelled"
+
+# Recording view
+# ==============
+# Format of a track in a release
+REC_FORMAT="<<med>>\t<<nr>>\t<<title>>\t<<artist>>\t<<duration>>"
+# Format of a track in the playlist
+REC_FORMAT_NO_NUMBER="<<title>>\t<<artist>>\t<<duration>>"

share/theme/simple.sh

@@ -0,0 +1,118 @@
+# Simple theme without emojis
+
+# Colors (internal only)
+ESC=$(printf '\033')
+RED="${ESC}[31m"
+GREEN="${ESC}[32m"
+YELLOW="${ESC}[33m"
+BLUE="${ESC}[34m"
+PURPLE="${ESC}[35m"
+CYAN="${ESC}[36m"
+WHITE="${ESC}[37m"
+OFF="${ESC}[m"
+
+# Pointers
+# ========
+# Sign that indicates the existence of audio files
+FORMAT_LOCAL="${BLUE}|>$OFF"
+# Pointer to the track currently playing (playlist)
+FORMAT_CURRENT="${WHITE}-->$OFF"
+
+# Input prompts
+# =============
+# General search prompt
+SEARCH_PROMPT="search: "
+# Prompt that takes an artist name as argument
+ARTIST_PROMPT="artist: %s: "
+# Prompt that takes an artist name and a release name as arguments (in that
+# order)
+FULL_PROMPT="artist: %s / %s: "
+
+# Visual representation of current mode
+# =====================================
+# Sign to indicate `normal` mode
+PROMPT_NORMAL="n)"
+# Sign to indicate `insert` mode
+PROMPT_INSERT="i)"
+
+# Artist view
+# ===========
+# Artist string for persons
+AV_PERSON="(P) ${CYAN}<<name>>$OFF"
+# Artist string for groups
+AV_GROUP="(G) ${CYAN}<<name>>$OFF"
+# Artist disambiguation string
+AV_DISAMBIGUATION="// <<disambiguation>>"
+
+# Release-group view
+# ==================
+# Default release group string
+RGV_RELEASE="${PURPLE}<<title>>$OFF"
+# Release group string if the artist name differs from the current artist
+RGV_RELEASE_W_ARTIST="${PURPLE}<<title>>$OFF by ${CYAN}<<artist>>$OFF"
+# Year of the release group
+RGV_YEAR="[<<year>>]"
+
+# Release-group types
+# ===================
+# Album
+FORMAT_TYPE_ALBUM="${YELLOW}LP$OFF"
+# EP
+FORMAT_TYPE_EP="${YELLOW}EP$OFF"
+# Single
+FORMAT_TYPE_SINGLE="${YELLOW}Single$OFF"
+# Broadcast
+FORMAT_TYPE_BROADCAST="${YELLOW}Broadcast$OFF"
+# Other
+FORMAT_TYPE_OTHER=""
+# Flag to indicate that the given release group has associated secondary types.
+FORMAT_TYPE_HAS_SECONDARY="%s ${RED}xx${OFF}"
+# Style to represent secondary types (takes one %s placeholder)
+FORMAT_TYPE_SECONDARY="${RED}(${OFF}%s${RED})${OFF}"
+# Secondary types
+FORMAT_TYPE_SECONDARY_COMPILATION="${YELLOW}compilation$OFF"
+FORMAT_TYPE_SECONDARY_SOUNDTRACK="${YELLOW}soundtrack$OFF"
+FORMAT_TYPE_SECONDARY_SPOKENWORD="${YELLOW}spokenword$OFF"
+FORMAT_TYPE_SECONDARY_INTERVIEW="${YELLOW}interview$OFF"
+FORMAT_TYPE_SECONDARY_AUDIOBOOK="${YELLOW}audiobook$OFF"
+FORMAT_TYPE_SECONDARY_AUDIODRAMA="${YELLOW}audio drama$OFF"
+FORMAT_TYPE_SECONDARY_LIVE="${YELLOW}live$OFF"
+FORMAT_TYPE_SECONDARY_REMIX="${YELLOW}remix$OFF"
+FORMAT_TYPE_SECONDARY_DJMIX="${YELLOW}DJ-mix$OFF"
+FORMAT_TYPE_SECONDARY_MIXTAPE="${YELLOW}mixtape$OFF"
+FORMAT_TYPE_SECONDARY_DEMO="${YELLOW}demo$OFF"
+FORMAT_TYPE_SECONDARY_FIELDREC="${YELLOW}field recording$OFF"
+
+# Artist Preview
+# ==============
+# Main preview format. Takes two %s placeholder. The first is for the artist
+# biography. The second for the life span.
+APV_FORMAT="\n\nBio:\n%s\n\n${WHITE}%s${OFF}"
+# Specification of a date
+APV_DATE="%s"
+# Specification of a place
+APV_PLACE="%s"
+# Specification of a date and a place (in that order)
+APV_DATEPLACE="%s in %s"
+# String to represent when/where a person is born
+APV_BORN="Born: %s"
+# String to represent when/where a person died
+APV_DIED="Died: %s"
+
+# Release view
+# ============
+# Format of a string that represents a release.
+RV_FORMAT="<<media>> (<<tracks>>, yr: <<year>>)\t<<label>>"
+# Additional string to display the release title and artist name
+RV_TITLE_ARTIST="${CYAN}<<artist>>$OFF - ${PURPLE}<<title>>$OFF"
+# Additional string to display the release title
+RV_TITLE="${PURPLE}<<title>>$OFF"
+# Additional string to display the artist
+RV_ARTIST="${CYAN}<<artist>>$OFF"
+
+# Recording view
+# ==============
+# Format of a track in a release
+REC_FORMAT="<<med>>\t${RED}<<nr>>$OFF\t${GREEN}<<title>>$OFF\t${CYAN}<<artist>>$OFF\t${WHITE}<<duration>>$OFF"
+# Format of a track in the playlist
+REC_FORMAT_NO_NUMBER="${GREEN}<<title>>$OFF\t${CYAN}<<artist>>$OFF\t${WHITE}<<duration>>$OFF"

src/awk/artists.awk

@@ -16,5 +16,5 @@ BEGIN {
     name = name " " format_disambiguation
   sub("<<disambiguation>>", $4, name)
   sub("<<name>>", $3, name)
-  print l, name, $1
+  print l, name, "0", $1
 }

src/awk/recordings.awk

@@ -4,18 +4,20 @@ BEGIN {
   delete local_recordings[0]
   if (file_local_recordings) {
     while ((getline < file_local_recordings) == 1)
-      local_recordings[$1] = $2
+      local_recordings[$1] = 1
     close(file_local_recordings)
   }
 }
 {
   gsub("&", "\\\\&")
-  id = $1
-  med = $2
-  nr = $3
-  dur = $4
-  title = $5
-  artist = $6
+  parentid = $1
+  id = $2
+  med = $3
+  nr = $4
+  dur = $5
+  title = $6
+  artist = $7
+  deco = local_recordings[id] ? $8 : ""
   # Parse duration
   if (dur) {
     dur = int(dur / 1000)
@@ -36,6 +38,7 @@ BEGIN {
   sub("<<artist>>", artist, line)
   sub("<<duration>>", dur, line)
   l = local_recordings[id] ? format_local : ""
+  c = id == current_id ? format_current : ""
   sortk = med" "nr
-  print sortk, l, line, id ":" local_recordings[id]
+  print sortk, l, c, line, parentid, id ":" deco
 }

src/awk/releasegroups.awk

@@ -58,5 +58,5 @@ BEGIN {
   line_year = year ? format_year : ""
   sub("<<year>>", year, line_year)
   sortk = year ? year : 0
-  print sortk, l, line_type, line_release, line_year, line_sectype, id
+  print sortk, l, line_type, line_release, line_year, line_sectype, artistid ? artistid : "0", id
 }

src/awk/releases.awk

@@ -53,5 +53,5 @@ BEGIN {
   sub("<<country>>", country, line)
   sortk = year ? year : 0
   l = local_releases[id] ? format_local : ""
-  print sortk, l, line, id ":" local_releases[id]
+  print sortk, l, line, rgid ? rgid : "0", id ":" local_releases[id]
 }

src/sh/api.sh

@@ -2,80 +2,6 @@ MB_MAX_RETRIES=10
 MB_BROWSE_STEPS=100
 USER_AGENT="$APP_NAME/$APP_VERSION ($APP_WEBSITE)"
 SLEEP_ON_ERROR=1
-export MB_BROWSE_STEPS
-
-__mpv_command() {
-  echo "mpv_command: $*" >>/tmp/foo
-  printf "{ \"command\": [\"%s\"] }\n" "$1" | $SOCAT - "$MPV_SOCKET"
-}
-
-__mpv_command_with_arg() {
-  echo "mpv_command_1: $*" >>/tmp/foo
-  printf "{ \"command\": [\"%s\", \"%s\"] }\n" "$1" "$2" | $SOCAT - "$MPV_SOCKET"
-}
-
-__mpv_command_with_args2() {
-  echo "mpv_command_2: $*" >>/tmp/foo
-  printf "{ \"command\": [\"%s\", \"%s\", \"%s\"] }\n" "$1" "$2" "$3" | $SOCAT - "$MPV_SOCKET"
-}
-
-__mpv_get() {
-  __mpv_command_with_arg "expand-text" "$2" | $JQ -r '.data'
-}
-
-mpv_playlist_count() {
-  __mpv_get '${playlist/count}'
-}
-
-mpv_playlist_position() {
-  __mpv_get '${playlist-pos}'
-}
-
-mpv_quit() {
-  __mpv_command "quit"
-}
-
-mpv_start() {
-  MPV_SOCKET="$(mktemp --suffix=.sock)"
-  trap 'mpv_quit; rm -f "$MPV_SOCKET"' EXIT INT
-  $MPV --no-config --no-terminal --input-ipc-server="$MPV_SOCKET" --idle --no-osc --no-input-default-bindings &
-}
-
-mpv_play_file() {
-  __mpv_command_with_arg "loadfile" "$1"
-}
-
-mpv_queue_file() {
-  __mpv_command_with_args2 "loadfile" "$1" "append-play"
-}
-
-mpv_play_list() {
-  __mpv_command_with_arg "loadlist" "$1"
-}
-
-mpv_queue_list() {
-  __mpv_command_with_arg "loadlist" "$1" "append-play"
-}
-
-mpv_next() {
-  __mpv_command "playlist-next"
-}
-
-mpv_prev() {
-  __mpv_command "playlist-prev"
-}
-
-mpv_seek_forward() {
-  __mpv_command_with_arg "seek" "10"
-}
-
-mpv_seek_backward() {
-  __mpv_command_with_arg "seek" "-10"
-}
-
-mpv_toggle_pause() {
-  __mpv_command_with_arg "cycle" "pause"
-}
 
 __api_mb() {
   tmpout=$(mktemp)

src/sh/awk.sh

@@ -1,3 +1,4 @@
+if [ ! "${AWK_LOADED:-}" ]; then
   AWK_ARTISTS=$(
     cat <<'EOF'
 @@include awk/artists.awk
@@ -25,3 +26,6 @@ AWK_RECORDINGS=$(
 EOF
   )
   export AWK_RECORDINGS
+
+  export AWK_LOADED=1
+fi

src/sh/cache.sh

@@ -82,7 +82,7 @@ cache_append_artist_releasegroups() {
   cat >"$tmpf"
   updated=$(mktemp)
   f="$CACHEDIR/$TYPE_ARTIST/$(__radix "$1")/$artist_releasegroups_filename"
-  $JQ -r --slurpfile n "$tmpf" '."release-groups" += ($n[0]|."release-groups")' "$f" >"$updated" && mv "$updated" "$f"
+  $JQ --slurpfile n "$tmpf" '."release-groups" += ($n[0]|."release-groups")' "$f" >"$updated" && mv "$updated" "$f"
   rm -f "$tmpf"
 }
 
@@ -120,7 +120,7 @@ cache_append_releasegroup_releases() {
   cat >"$tmpf"
   updated=$(mktemp)
   f="$CACHEDIR/$TYPE_RELEASEGROUP/$(__radix "$1")/$releasegroup_releases_filename"
-  $JQ -r --slurpfile n "$tmpf" '."releases" += ($n[0]|."releases")' "$f" >"$updated" && mv "$updated" "$f"
+  $JQ --slurpfile n "$tmpf" '."releases" += ($n[0]|."releases")' "$f" >"$updated" && mv "$updated" "$f"
   rm -f "$tmpf"
 }
 

src/sh/config.sh

@@ -1,4 +1,6 @@
-if [ "${CONFIGFILE:-}" ]; then
-  [ ! -f "$CONFIGFILE" ] && err "Configuration $CONFIGFILE not found." && exit 1
-  . "$CONFIGFLIE"
-fi
+# Configuration capabilities
+CONFIGFILE_DEFAULT="$HOME/.config/$APP_NAME/config"
+CONFIGFILE="${CONFIGFILE:-"$CONFIGFILE_DEFAULT"}"
+[ "$CONFIGFILE" != "$CONFIGFILE_DEFAULT" ] && [ ! -f "$CONFIGFILE" ] && err "The configuration file manually specified with the environment variable CONFIGFILE=($CONFIGFILE) does not exist." && exit 1
+# shellcheck source=/dev/null
+[ -f "$CONFIGFILE" ] && . "$CONFIGFILE"

src/sh/filter.sh

@@ -0,0 +1,77 @@
+# Preset filters
+#
+# See `src/sh/query.sh` for details and the associated methods.
+QUERY_LOCAL="${QUERY_LOCAL:-"$(printf "'%s'" "$FORMAT_LOCAL" | __clean_filter)"}"
+q_has_seconary="$(printf "$FORMAT_TYPE_HAS_SECONDARY" "" | __clean_filter)"
+q_album="$(printf "%s" "$FORMAT_TYPE_ALBUM" | __clean_filter)"
+q_ep=$(printf "%s" "$FORMAT_TYPE_EP" | sed "s/${ESC}\[[0-9;]*[mK]//g" | sed "s/ /\\\ /g")
+q_single=$(printf "%s" "$FORMAT_TYPE_SINGLE" | sed "s/${ESC}\[[0-9;]*[mK]//g" | sed "s/ /\\\ /g")
+if printf "$RV_FORMAT" | grep -q "<<status>>"; then
+  q_official=$(printf "'%s'" "$FORMAT_STATUS_OFFICIAL" | sed "s/${ESC}\[[0-9;]*[mK]//g" | sed "s/ /\\\ /g")
+fi
+export QUERY_LOCAL
+
+F_1_VIEW_ARTIST="${F_1_VIEW_ARTIST:-"!'$q_has_seconary'"}"
+F_2_VIEW_ARTIST="${F_2_VIEW_ARTIST:-"'$q_album'"}"
+F_3_VIEW_ARTIST="${F_3_VIEW_ARTIST:-"'$q_ep'"}"
+F_4_VIEW_ARTIST="${F_4_VIEW_ARTIST:-"'$q_single'"}"
+F_5_VIEW_ARTIST="${F_5_VIEW_ARTIST:-}"
+F_6_VIEW_ARTIST="${F_6_VIEW_ARTIST:-}"
+F_7_VIEW_ARTIST="${F_7_VIEW_ARTIST:-}"
+F_8_VIEW_ARTIST="${F_8_VIEW_ARTIST:-}"
+F_9_VIEW_ARTIST="${F_9_VIEW_ARTIST:-}"
+export F_1_VIEW_ARTIST F_2_VIEW_ARTIST F_3_VIEW_ARTIST F_4_VIEW_ARTIST \
+  F_5_VIEW_ARTIST F_6_VIEW_ARTIST F_7_VIEW_ARTIST F_8_VIEW_ARTIST \
+  F_9_VIEW_ARTIST
+
+F_1_VIEW_RELEASEGROUP="${F_1_VIEW_RELEASEGROUP:-"${q_official:-}"}"
+F_2_VIEW_RELEASEGROUP="${F_2_VIEW_RELEASEGROUP:-}"
+F_3_VIEW_RELEASEGROUP="${F_3_VIEW_RELEASEGROUP:-}"
+F_4_VIEW_RELEASEGROUP="${F_4_VIEW_RELEASEGROUP:-}"
+F_5_VIEW_RELEASEGROUP="${F_5_VIEW_RELEASEGROUP:-}"
+F_6_VIEW_RELEASEGROUP="${F_6_VIEW_RELEASEGROUP:-}"
+F_7_VIEW_RELEASEGROUP="${F_7_VIEW_RELEASEGROUP:-}"
+F_8_VIEW_RELEASEGROUP="${F_8_VIEW_RELEASEGROUP:-}"
+F_9_VIEW_RELEASEGROUP="${F_9_VIEW_RELEASEGROUP:-}"
+export F_1_VIEW_RELEASEGROUP F_2_VIEW_RELEASEGROUP F_3_VIEW_RELEASEGROUP \
+  F_4_VIEW_RELEASEGROUP F_5_VIEW_RELEASEGROUP F_6_VIEW_RELEASEGROUP \
+  F_7_VIEW_RELEASEGROUP F_8_VIEW_RELEASEGROUP F_9_VIEW_RELEASEGROUP
+
+F_1_VIEW_RELEASE="${F_1_VIEW_RELEASE:-}"
+F_2_VIEW_RELEASE="${F_2_VIEW_RELEASE:-}"
+F_3_VIEW_RELEASE="${F_3_VIEW_RELEASE:-}"
+F_4_VIEW_RELEASE="${F_4_VIEW_RELEASE:-}"
+F_5_VIEW_RELEASE="${F_5_VIEW_RELEASE:-}"
+F_6_VIEW_RELEASE="${F_6_VIEW_RELEASE:-}"
+F_7_VIEW_RELEASE="${F_7_VIEW_RELEASE:-}"
+F_8_VIEW_RELEASE="${F_8_VIEW_RELEASE:-}"
+F_9_VIEW_RELEASE="${F_9_VIEW_RELEASE:-}"
+export F_1_VIEW_RELEASE F_2_VIEW_RELEASE F_3_VIEW_RELEASE F_4_VIEW_RELEASE \
+  F_5_VIEW_RELEASE F_6_VIEW_RELEASE F_7_VIEW_RELEASE F_8_VIEW_RELEASE \
+  F_9_VIEW_RELEASE
+
+F_1_LIST_ARTISTS="${F_1_LIST_ARTISTS:-}"
+F_2_LIST_ARTISTS="${F_2_LIST_ARTISTS:-}"
+F_3_LIST_ARTISTS="${F_3_LIST_ARTISTS:-}"
+F_4_LIST_ARTISTS="${F_4_LIST_ARTISTS:-}"
+F_5_LIST_ARTISTS="${F_5_LIST_ARTISTS:-}"
+F_6_LIST_ARTISTS="${F_6_LIST_ARTISTS:-}"
+F_7_LIST_ARTISTS="${F_7_LIST_ARTISTS:-}"
+F_8_LIST_ARTISTS="${F_8_LIST_ARTISTS:-}"
+F_9_LIST_ARTISTS="${F_9_LIST_ARTISTS:-}"
+export F_1_LIST_ARTISTS F_2_LIST_ARTISTS F_3_LIST_ARTISTS F_4_LIST_ARTISTS \
+  F_5_LIST_ARTISTS F_6_LIST_ARTISTS F_7_LIST_ARTISTS F_8_LIST_ARTISTS \
+  F_9_LIST_ARTISTS
+
+F_1_LIST_ALBUMS="${F_1_LIST_ALBUMS:-}"
+F_2_LIST_ALBUMS="${F_2_LIST_ALBUMS:-}"
+F_3_LIST_ALBUMS="${F_3_LIST_ALBUMS:-}"
+F_4_LIST_ALBUMS="${F_4_LIST_ALBUMS:-}"
+F_5_LIST_ALBUMS="${F_5_LIST_ALBUMS:-}"
+F_6_LIST_ALBUMS="${F_6_LIST_ALBUMS:-}"
+F_7_LIST_ALBUMS="${F_7_LIST_ALBUMS:-}"
+F_8_LIST_ALBUMS="${F_8_LIST_ALBUMS:-}"
+F_9_LIST_ALBUMS="${F_9_LIST_ALBUMS:-}"
+export F_1_LIST_ALBUMS F_2_LIST_ALBUMS F_3_LIST_ALBUMS F_4_LIST_ALBUMS \
+  F_5_LIST_ALBUMS F_6_LIST_ALBUMS F_7_LIST_ALBUMS F_8_LIST_ALBUMS \
+  F_9_LIST_ALBUMS

src/sh/fzf.sh

@@ -0,0 +1,122 @@
+# Print the command that sets the header.
+# @argument $1: view
+# @argument $2: mbid
+fzf_command_set_header() {
+  view=$1
+  mbid=$2
+  case "$view" in
+  "$VIEW_SEARCH_ARTIST") header="Search artist on MusicBrainz" ;;
+  "$VIEW_SEARCH_ALBUM") header="Search album on MusicBrainz" ;;
+  "$VIEW_LIST_ARTISTS") header="Search locally available artist" ;;
+  "$VIEW_LIST_ALBUMS") header="Search locally available album" ;;
+  "$VIEW_ARTIST")
+    name="$(mb_artist "$mbid" | $JQ '.name')"
+    header=$(printf "$ARTIST_PROMPT" "$name")
+    ;;
+  "$VIEW_RELEASEGROUP")
+    title="$(mb_releasegroup "$mbid" |
+      $JQ '.title')"
+    artist="$(mb_releasegroup "$mbid" |
+      $JQ '."artist-credit" | map(([.name, .joinphrase]|join(""))) | join("")')"
+    header=$(printf "$FULL_PROMPT" "$artist" "$title")
+    ;;
+  "$VIEW_RELEASE")
+    title="$(mb_release "$mbid" |
+      $JQ '.title')"
+    artist="$(mb_release "$mbid" |
+      $JQ '."artist-credit" | map(([.name, .joinphrase]|join(""))) | join("")')"
+    header=$(printf "$FULL_PROMPT" "$artist" "$title")
+    ;;
+  esac
+  printf "+change-header(%s)" "${header:-"???"}"
+}
+
+# Reload hook that is used after change in query
+fzf_reload_after_change() {
+  # Wait for async. process to terminate
+  sleep 1
+  while [ -f "$LOCKFILE" ]; do
+    sleep 1
+  done
+  # Show results
+  column -t -s "$(printf '\t')" "$RESULTS" |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\)$|\t\1\t\2|'
+}
+
+# Handle change in query
+fzf_handle_change() {
+  view="$1"
+  # Kill any running search
+  if [ -f "$PIDFILE" ]; then
+    pid=$(cat "$PIDFILE")
+    rm -f "$PIDFILE"
+    kill -9 "$pid" >/dev/null 2>&1 || true
+  fi
+  # Stop, if no search string is given
+  [ "$FZF_QUERY" ] || exit 0
+  # Store PID of current process
+  echo "$$" >"$PIDFILE"
+  touch "$LOCKFILE"
+  sleep 1
+  if [ "$view" = "$VIEW_SEARCH_ARTIST" ]; then
+    api_mb_search_artist "$FZF_QUERY" |
+      $JQ '.artists[] | [
+    .id,
+    .type,
+    .name,
+    .disambiguation,
+    .["life-span"].begin,
+    .["life-span"].end
+    ] | join("\t")' |
+      awk \
+        -F "\t" \
+        -v file_local_artists="${LOCALDATA_ARTISTS:-}" \
+        -v format_person="$AV_PERSON" \
+        -v format_group="$AV_GROUP" \
+        -v format_disambiguation="$AV_DISAMBIGUATION" \
+        -v format_local="$FORMAT_LOCAL" \
+        "$AWK_ARTISTS" >"$RESULTS" ||
+      true
+  else
+    api_mb_search_releasegroup "$FZF_QUERY" |
+      $JQ '."release-groups"[] | [ 
+    .id,
+    ."primary-type",
+    (."secondary-types" // []|join(";")),
+    ."first-release-date",
+    .title,
+    (."artist-credit" | map(([.name, .joinphrase]|join(""))) | join(""))
+    ] | join("\t")' |
+      awk \
+        -F "\t" \
+        -v file_local_releasegroups="${LOCALDATA_RELEASEGROUPS:-}" \
+        -v format_release="$RGV_RELEASE" \
+        -v format_release_w_artist="$RGV_RELEASE_W_ARTIST" \
+        -v format_year="$RGV_YEAR" \
+        -v format_album="$FORMAT_TYPE_ALBUM" \
+        -v format_single="$FORMAT_TYPE_SINGLE" \
+        -v format_ep="$FORMAT_TYPE_EP" \
+        -v format_broadcast="$FORMAT_TYPE_BROADCAST" \
+        -v format_other="$FORMAT_TYPE_OTHER" \
+        -v format_has_secondary="$FORMAT_TYPE_HAS_SECONDARY" \
+        -v format_secondary="$FORMAT_TYPE_SECONDARY" \
+        -v format_compilation="$FORMAT_TYPE_SECONDARY_COMPILATION" \
+        -v format_soundtrack="$FORMAT_TYPE_SECONDARY_SOUNDTRACK" \
+        -v format_spokenword="$FORMAT_TYPE_SECONDARY_SPOKENWORD" \
+        -v format_interview="$FORMAT_TYPE_SECONDARY_INTERVIEW" \
+        -v format_audiobook="$FORMAT_TYPE_SECONDARY_AUDIOBOOK" \
+        -v format_audiodrama="$FORMAT_TYPE_SECONDARY_AUDIODRAMA" \
+        -v format_live="$FORMAT_TYPE_SECONDARY_LIVE" \
+        -v format_remix="$FORMAT_TYPE_SECONDARY_REMIX" \
+        -v format_djmix="$FORMAT_TYPE_SECONDARY_DJMIX" \
+        -v format_mixtape="$FORMAT_TYPE_SECONDARY_MIXTAPE" \
+        -v format_demo="$FORMAT_TYPE_SECONDARY_DEMO" \
+        -v format_fieldrec="$FORMAT_TYPE_SECONDARY_FIELDREC" \
+        -v format_local="$FORMAT_LOCAL" \
+        "$AWK_RELEASEGROUPS" |
+      cut -d "$(printf '\t')" -f 2- >"$RESULTS" ||
+      true
+  fi
+  # Process ends now: Display and quit
+  rm -f "$LOCKFILE" "$PIDFILE"
+}

src/sh/helper.sh

@@ -1,15 +0,0 @@
-ERR="\033[38;5;196m"
-INFO="\033[38;5;75m"
-DBG=$ERR
-OFF="\033[m"
-err() {
-  echo "${ERR}ERROR:${OFF} ${1:-}" >/dev/stderr
-}
-
-info() {
-  echo "${INFO}Info:${OFF} ${1:-}" >/dev/stderr
-}
-
-debug() {
-  echo "${DBG}DEBUG${OFF} ${INFO}$(date)${OFF}: $*" >/dev/stderr
-}

src/sh/info.sh

@@ -1,5 +1,5 @@
+# Application information
 APP_NAME="muf"
 APP_VERSION="zero.zero"
 APP_WEBSITE="https://git.indyfac.ch/amin/muf"
-WINDOW_TITLE="🔎🎶 $APP_NAME | a simple music finder"
-export APP_NAME APP_VERSION APP_WEBSITE WINDOW_TITLE
+WINDOW_TITLE="🔎🎶 $APP_NAME | a simple music finder and player"

src/sh/keys.sh

@@ -0,0 +1,178 @@
+# List of keys, organized in groups
+#
+# Mode selection:
+# - KEYS_I_NORMAL: Switch to normal mode (insert mode)
+# - KEYS_N_INSERT: Switch to insert mode (normal mode)
+#
+# Vertical navigation:
+# - KEYS_DOWN: Move cursor to the next line
+# - KEYS_UP: Move cursor to the previous line
+# - KEYS_HALFPAGE_UP: Move cursor half a page up
+# - KEYS_HALFPAGE_DOWN: Move cursor half a page up
+# - KEYS_N_DOWN: Move cursor to the next line (normal mode)
+# - KEYS_N_UP: Move cursor to the previous line (normal mode)
+# - KEYS_N_BOT: Move cursor to the last line (normal mode)
+# - KEYS_N_TOP: Move cursor to the first line (normal mode)
+#
+# Horizontal navigation:
+# - KEYS_IN: Enter into selected item, down the hierarchy
+# - KEYS_OUT: Leave current item, up the hierarchy
+# - KEYS_N_IN: Enter into selected item, down the hierarchy (normal mode)
+# - KEYS_N_OUT: Leave current item, up the hierarchy (normal mode)
+# - KEYS_SELECT_ARTIST: Go to artist of selected entry (in case of multiple
+# artists, provide a choice)
+# - KEYS_LIST_ARTISTS: Go to VIEW_LIST_ARTISTS
+# - KEYS_LIST_ALBUMS: Go to VIEW_LIST_ALBUMS
+# - KEYS_SEARCH_ARTIST: Go to VIEW_SEARCH_ARTIST
+# - KEYS_SEARCH_ALBUM: Go to VIEW_SEARCH_ALBUM
+# - KEYS_SWITCH_ARTIST_ALBUM: Switch artist and album views, i.e.,
+# VIEW_LIST_ARTISTS <-> VIEW_LIST_ALBUMS, and VIEW_SEARCH_ARTIST <->
+# VIEW_SEARCH_ALBUM.
+# - KEYS_SWITCH_LOCAL_REMOTE: Switch between locally available music and remote
+# search views, i.e., VIEW_LIST_ARTISTS <-> VIEW_SEARCH_ARTIST, and
+# VIEW_LIST_ALBUMS <-> VIEW_SEARCH_ALBUM.
+#
+# Filtering:
+# - KEYS_FILTER_LOCAL: List only locally available entries
+# - KEYS_FILTER_0: Clear query
+# - KEYS_FILTER_1: Reset query to the default one for the current view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_2: Preset query `2` depending on the view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_3: Preset query `3` depending on the view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_4: Preset query `4` depending on the view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_5: Preset query `5` depending on the view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_6: Preset query `6` depending on the view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_7: Preset query `7` depending on the view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_8: Preset query `8` depending on the view (see `src/sh/filter.sh`)
+# - KEYS_FILTER_9: Preset query `9` depending on the view (see `src/sh/filter.sh`)
+#
+# Specials:
+# - KEYS_BROWSE: Open MusicBrainz webpage of the selected item
+# - KEYS_OPEN: Open file manager in the directory of the selected item
+# - KEYS_SHOW_PLAYLIST: Switch to playlist view
+# - KEYS_QUIT: Quit application
+# - KEYS_N_QUIT: Quit application if we are in VIEW_LIST_ARTISTS, else go to
+# view VIEW_LIST_ARTISTS (normal mode)
+#
+# Playback:
+# - KEYS_PLAY: Play selected release or selected track
+# - KEYS_QUEUE: Queue selected release or selected track
+# - KEYS_QUEUE_NEXT: Queue selected release or selected track as next entry in
+# the playlist
+# - KEYS_N_TOGGLE_PLAYBACK: Play-pause toggle
+# - KEYS_N_PLAY_NEXT: Play next track
+# - KEYS_N_PLAY_PREV: Play previous track
+# - KEYS_N_SEEK_FORWARD: Seek forward
+# - KEYS_N_SEEK_BACKWARD: Seek backward
+#
+# Playlist (in the playlist, there is no `insert` mode):
+# - KEYS_PLAYLIST_RELOAD: Manually reload playlist
+# - KEYS_PLAYLIST_REMOVE: Remove item from playlist
+# - KEYS_PLAYLIST_UP: Move item one position up
+# - KEYS_PLAYLIST_DOWN: Move item one position down
+# - KEYS_PLAYLIST_CLEAR: Clear playlist
+# - KEYS_PLAYLIST_CLEAR_ABOVE: Remove all items above incl. the selected one
+# - KEYS_PLAYLIST_CLEAR_BELOW: Remove all items below incl. the selected one
+# - KEYS_PLAYLIST_GOTO_RELEASE: Jump to release or seleted enry
+# - KEYS_PLAYLIST_STORE: Store current playlist as file
+# - KEYS_PLAYLIST_LOAD: Load playlist from file
+# - KEYS_PLAYLIST_QUIT: Quit playlist view
+#
+
+# Mode selection:
+KEYS_I_NORMAL="${KEYS_I_NORMAL:-"esc"}"
+KEYS_N_INSERT="${KEYS_N_INSERT:-"a,i,/,?"}"
+export KEYS_I_NORMAL KEYS_N_INSERT
+
+# Vertical navigation:
+KEYS_DOWN="${KEYS_DOWN:-"ctrl-j,down"}"
+KEYS_UP="${KEYS_UP:-"ctrl-k,up"}"
+KEYS_HALFPAGE_DOWN="${KEYS_HALFPAGE_DOWN:-"ctrl-d"}"
+KEYS_HALFPAGE_UP="${KEYS_HALFPAGE_UP:-"ctrl-u"}"
+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:-"1"}"
+export KEYS_DOWN KEYS_UP KEYS_HALFPAGE_DOWN KEYS_HALFPAGE_UP KEYS_N_DOWN \
+  KEYS_N_UP KEYS_N_BOT KEYS_N_TOP
+
+# Horizontal navigation:
+KEYS_IN="${KEYS_IN:-"ctrl-l"}"
+KEYS_OUT="${KEYS_OUT:-"ctrl-h"}"
+KEYS_N_IN="${KEYS_N_IN:-"l"}"
+KEYS_N_OUT="${KEYS_N_OUT:-"h"}"
+KEYS_SELECT_ARTIST="${KEYS_SELECT_ARTIST:-"ctrl-a"}"
+KEYS_LIST_ARTISTS="${KEYS_LIST_ARTISTS:-"alt-a"}"
+KEYS_LIST_ALBUMS="${KEYS_LIST_ALBUMS:-"alt-s"}"
+KEYS_SEARCH_ARTIST="${KEYS_SEARCH_ARTIST:-"alt-z"}"
+KEYS_SEARCH_ALBUM="${KEYS_SEARCH_ALBUM:-"alt-x"}"
+KEYS_SWITCH_ARTIST_ALBUM="${KEYS_SWITCH_ARTIST_ALBUM:-"tab"}"
+KEYS_SWITCH_LOCAL_REMOTE="${KEYS_SWITCH_LOCAL_REMOTE:-"ctrl-/"}"
+export KEYS_IN KEYS_OUT KEYS_N_IN KEYS_N_OUT KEYS_SELECT_ARTIST \
+  KEYS_LIST_ARTISTS KEYS_SELECT_ARTIST KEYS_SEARCH_ALBUM \
+  KEYS_SWITCH_ARTIST_ALBUM KEYS_SWITCH_LOCAL_REMOTE
+
+# Filtering:
+KEYS_FILTER_LOCAL="${KEYS_FILTER_LOCAL:-"alt-l"}"
+KEYS_FILTER_1="${KEYS_FILTER_1:-"alt-1"}"
+KEYS_FILTER_2="${KEYS_FILTER_2:-"alt-2"}"
+KEYS_FILTER_3="${KEYS_FILTER_3:-"alt-3"}"
+KEYS_FILTER_4="${KEYS_FILTER_4:-"alt-4"}"
+KEYS_FILTER_5="${KEYS_FILTER_5:-"alt-5"}"
+KEYS_FILTER_6="${KEYS_FILTER_6:-"alt-6"}"
+KEYS_FILTER_7="${KEYS_FILTER_7:-"alt-7"}"
+KEYS_FILTER_8="${KEYS_FILTER_8:-"alt-8"}"
+KEYS_FILTER_9="${KEYS_FILTER_9:-"alt-9"}"
+KEYS_FILTER_0="${KEYS_FILTER_0:-"alt-0"}"
+KEYS_FILTER="$KEYS_FILTER_LOCAL,$KEYS_FILTER_1,$KEYS_FILTER_2,$KEYS_FILTER_3,$KEYS_FILTER_4,$KEYS_FILTER_5,$KEYS_FILTER_6,$KEYS_FILTER_7,$KEYS_FILTER_8,$KEYS_FILTER_9,$KEYS_FILTER_0"
+export KEYS_FILTER_LOCAL KEYS_FILTER_1 KEYS_FILTER_2 KEYS_FILTER_3 \
+  KEYS_FILTER_4 KEYS_FILTER_5 KEYS_FILTER_6 KEYS_FILTER_7 KEYS_FILTER_8 \
+  KEYS_FILTER_9 KEYS_FILTER_0 KEYS_FILTER
+
+# Specials:
+KEYS_BROWSE="${KEYS_BROWSE:-"alt-b"}"
+KEYS_OPEN="${KEYS_OPEN:-"alt-o"}"
+KEYS_SHOW_PLAYLIST="${KEYS_SHOW_PLAYLIST:-"ctrl-p"}"
+KEYS_QUIT="${KEYS_QUIT:-"ctrl-c"}"
+KEYS_N_QUIT="${KEYS_N_QUIT:-"q"}"
+export KEYS_BROWSE KEYS_OPEN KEYS_SHOW_PLAYLIST KEYS_QUIT KEYS_N_QUIT
+
+# Playback:
+KEYS_PLAY="${KEYS_PLAY:-"enter"}"
+KEYS_QUEUE="${KEYS_QUEUE:-"ctrl-alt-m"}" # That's actually alt-enter
+KEYS_QUEUE_NEXT="${KEYS_QUEUE_NEXT:-"ctrl-alt-n"}"
+KEYS_TOGGLE_PLAYBACK="${KEYS_TOGGLE_PLAYBACK:-"ctrl-space"}"
+KEYS_PLAY_NEXT="${KEYS_PLAY_NEXT:-"alt-n"}"
+KEYS_PLAY_PREV="${KEYS_PLAY_PREV:-"alt-p"}"
+KEYS_SEEK_FORWARD="${KEYS_SEEK_FORWARD:-"alt-N"}"
+KEYS_SEEK_BACKWARD="${KEYS_SEEK_BACKWARD:-"alt-P"}"
+KEYS_PLAYBACK="$KEYS_PLAY,$KEYS_QUEUE,$KEYS_QUEUE_NEXT,$KEYS_TOGGLE_PLAYBACK,$KEYS_PLAY_NEXT,$KEYS_PLAY_PREV,$KEYS_SEEK_FORWARD,$KEYS_SEEK_BACKWARD"
+KEYS_N_PLAY="${KEYS_N_PLAY:-"."}"
+KEYS_N_QUEUE="${KEYS_N_QUEUE:-";"}"
+KEYS_N_QUEUE_NEXT="${KEYS_N_QUEUE_NEXT:-":"}"
+KEYS_N_TOGGLE_PLAYBACK="${KEYS_N_TOGGLE_PLAYBACK:-"space"}"
+KEYS_N_PLAY_NEXT="${KEYS_N_PLAY_NEXT:-"right,n"}"
+KEYS_N_PLAY_PREV="${KEYS_N_PLAY_PREV:-"left,p"}"
+KEYS_N_SEEK_FORWARD="${KEYS_N_SEEK_FORWARD:-"N,f"}"
+KEYS_N_SEEK_BACKWARD="${KEYS_N_SEEK_BACKWARD:-"P,b"}"
+KEYS_N_PLAYBACK="$KEYS_N_PLAY,$KEYS_N_QUEUE,$KEYS_N_QUEUE_NEXT,$KEYS_N_TOGGLE_PLAYBACK,$KEYS_N_PLAY_NEXT,$KEYS_N_PLAY_PREV,$KEYS_N_SEEK_FORWARD,$KEYS_N_SEEK_BACKWARD"
+export KEYS_PLAY KEYS_QUEUE KEYS_QUEUE_NEXT KEYS_TOGGLE_PLAYBACK \
+  KEYS_PLAY_NEXT KEYS_PLAY_PREV KEYS_SEEK_FORWARD KEYS_SEEK_BACKWARD \
+  KEYS_PLAYBACK KEYS_N_PLAY KEYS_N_QUEUE KEYS_N_QUEUE_NEXT \
+  KEYS_N_TOGGLE_PLAYBACK KEYS_N_PLAY_NEXT KEYS_N_PLAY_PREV \
+  KEYS_N_SEEK_FORWARD KEYS_N_SEEK_BACKWARD KEYS_N_PLAYBACK
+
+# Playlist (in the playlist, there is no `insert` mode):
+KEYS_PLAYLIST_RELOAD="${KEYS_PLAYLIST_RELOAD:-"r,ctrl-r"}"
+KEYS_PLAYLIST_REMOVE="${KEYS_PLAYLIST_REMOVE:-"x,delete"}"
+KEYS_PLAYLIST_UP="${KEYS_PLAYLIST_UP:-"u"}"
+KEYS_PLAYLIST_DOWN="${KEYS_PLAYLIST_DOWN:-"d"}"
+KEYS_PLAYLIST_CLEAR="${KEYS_PLAYLIST_CLEAR:-"C"}"
+KEYS_PLAYLIST_CLEAR_ABOVE="${KEYS_PLAYLIST_CLEAR_ABOVE:-"U"}"
+KEYS_PLAYLIST_CLEAR_BELOW="${KEYS_PLAYLIST_CLEAR_BELOW:-"D"}"
+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"}"
+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_GOTO_RELEASE KEYS_PLAYLIST_STORE \
+  KEYS_PLAYLIST_LOAD

src/sh/lists.sh

@@ -0,0 +1,194 @@
+# List release groups of given artist
+# argument $1: MB artist id
+list_releasegroups() {
+  name=$(mb_artist "$1" | $JQ '.name')
+  mb_artist_releasegroups "$1" |
+    $JQ '."release-groups"[] | [
+  .id,
+  ."primary-type",
+  (."secondary-types" // []|join(";")),
+  ."first-release-date",
+  .title,
+  (."artist-credit" | map(([.name, .joinphrase]|join(""))) | join(""))
+  ] | join("\t")' |
+    awk \
+      -F "\t" \
+      -v artist="$name" \
+      -v artistid="$1" \
+      -v file_local_releasegroups="${LOCALDATA_RELEASEGROUPS:-}" \
+      -v format_release="$RGV_RELEASE" \
+      -v format_release_w_artist="$RGV_RELEASE_W_ARTIST" \
+      -v format_year="$RGV_YEAR" \
+      -v format_album="$FORMAT_TYPE_ALBUM" \
+      -v format_single="$FORMAT_TYPE_SINGLE" \
+      -v format_ep="$FORMAT_TYPE_EP" \
+      -v format_broadcast="$FORMAT_TYPE_BROADCAST" \
+      -v format_other="$FORMAT_TYPE_OTHER" \
+      -v format_has_secondary="$FORMAT_TYPE_HAS_SECONDARY" \
+      -v format_secondary="$FORMAT_TYPE_SECONDARY" \
+      -v format_compilation="$FORMAT_TYPE_SECONDARY_COMPILATION" \
+      -v format_soundtrack="$FORMAT_TYPE_SECONDARY_SOUNDTRACK" \
+      -v format_spokenword="$FORMAT_TYPE_SECONDARY_SPOKENWORD" \
+      -v format_interview="$FORMAT_TYPE_SECONDARY_INTERVIEW" \
+      -v format_audiobook="$FORMAT_TYPE_SECONDARY_AUDIOBOOK" \
+      -v format_audiodrama="$FORMAT_TYPE_SECONDARY_AUDIODRAMA" \
+      -v format_live="$FORMAT_TYPE_SECONDARY_LIVE" \
+      -v format_remix="$FORMAT_TYPE_SECONDARY_REMIX" \
+      -v format_djmix="$FORMAT_TYPE_SECONDARY_DJMIX" \
+      -v format_mixtape="$FORMAT_TYPE_SECONDARY_MIXTAPE" \
+      -v format_demo="$FORMAT_TYPE_SECONDARY_DEMO" \
+      -v format_fieldrec="$FORMAT_TYPE_SECONDARY_FIELDREC" \
+      -v format_local="$FORMAT_LOCAL" \
+      "$AWK_RELEASEGROUPS" |
+    sort -n -r |
+    cut -d "$(printf '\t')" -f 2- |
+    column -t -s "$(printf '\t')" |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\)$|\t\1\t\2|'
+}
+
+# List releases in given relese group
+# argument $1: MB release-group id
+list_releases() {
+  title="$(mb_releasegroup "$1" |
+    $JQ '.title')"
+  artist="$(mb_releasegroup "$1" |
+    $JQ '."artist-credit" | map(([.name, .joinphrase]|join(""))) | join("")')"
+  mb_releasegroup_releases "$1" |
+    $JQ '."releases"[] | [
+  .id,
+  .status,
+  .date,
+  ."cover-art-archive".count,
+  (."label-info" | map(.label.name) | unique | join(", ")),
+  (.media | map(."track-count") | add),
+  (.media | map(.format) | unique | join(", ")),
+  .country,
+  .title,
+  (."artist-credit" | map(([.name, .joinphrase]|join(""))) | join(""))
+  ] | join("\t")' |
+    awk \
+      -F "\t" \
+      -v file_local_releases="${LOCALDATA_RELEASES:-}" \
+      -v release_official="$FORMAT_STATUS_OFFICIAL" \
+      -v release_promotion="$FORMAT_STATUS_PROMO" \
+      -v release_bootleg="$FORMAT_STATUS_BOOTLEG" \
+      -v release_pseudo="$FORMAT_STATUS_PSEUDO" \
+      -v release_withdrawn="$FORMAT_STATUS_WITHDRAWN" \
+      -v release_expunged="$FORMAT_STATUS_EXPUNGED" \
+      -v release_cancelled="$FORMAT_STATUS_CANCELLED" \
+      -v release_format="$RV_FORMAT" \
+      -v release_format_title_artist="$RV_TITLE_ARTIST" \
+      -v release_format_title="$RV_TITLE" \
+      -v release_format_artist="$RV_ARTIST" \
+      -v rg_artist="$artist" \
+      -v rg_title="$title" \
+      -v rgid="$1" \
+      -v format_local="$FORMAT_LOCAL" \
+      "$AWK_RELEASES" |
+    sort -n -r |
+    cut -d "$(printf '\t')" -f 2- |
+    column -t -s "$(printf '\t')" |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\):\(.*$\)$|\t\1\t\2\t\3|'
+}
+
+# List recordings of given release
+# argument $1: MB release id
+list_recordings() {
+  deco="$(grep "$1" "$LOCALDATA_RELEASES" | cut -d "$(printf '\t')" -f 2)"
+  if [ "$deco" ]; then
+    rectmp=$(mktemp)
+    $JQ '.tracks | keys | join("\n")' "$deco" >"$rectmp"
+  fi
+  mb_release "$1" |
+    $JQ \
+      --arg rid "$1" \
+      --arg deco "$deco" \
+      '.media[] |
+        .position as $pos |
+        .tracks[] | [
+          $rid,
+          .id,
+          $pos,
+          .number,
+          .length,
+          .recording.title,
+          (.recording."artist-credit" | map([.name, .joinphrase] | join("")) | join("")),
+          $deco
+        ] |
+        join("\t")' |
+    awk \
+      -F "\t" \
+      -v file_local_recordings="${rectmp:-}" \
+      -v format="$REC_FORMAT" \
+      -v format_local="$FORMAT_LOCAL" \
+      "$AWK_RECORDINGS" |
+    sort -k1,1n -k2,2g |
+    cut -d "$(printf '\t')" -f 2- |
+    column -t -s "$(printf '\t')" -R 3,4,7 |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\):\(.*$\)$|\t\1\t\2\t\3|'
+  if [ "${rectmp:-}" ] && [ -f "$rectmp" ]; then
+    rm -f "$rectmp"
+  fi
+}
+
+# List artists (local)
+list_local_artists() {
+  cat "$LOCALDATA_ARTISTS_VIEW" 2>/dev/null
+}
+
+# List release groups (local)
+list_local_releasegroups() {
+  cat "$LOCALDATA_RELEASEGROUPS_VIEW" 2>/dev/null
+}
+
+# List releases (local)
+list_local_releases() {
+  cat "$LOCALDATA_RELEASES_VIEW" 2>/dev/null
+}
+
+# Generate artist list from JSON
+list_artists_from_json() {
+  cat |
+    $JQ 'map([.artist.id, .artist.type, .name] | join("\t")) | join("\n")' |
+    awk \
+      -F "\t" \
+      -v file_local_artists="${LOCALDATA_ARTISTS:-}" \
+      -v format_person="$AV_PERSON" \
+      -v format_group="$AV_GROUP" \
+      -v format_disambiguation="$AV_DISAMBIGUATION" \
+      -v format_local="$FORMAT_LOCAL" \
+      "$AWK_ARTISTS" |
+    column -t -s "$(printf '\t')" |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\)$|\t\1\t\2|'
+}
+
+# Generate playlist view
+list_playlist() {
+  count=$(mpv_playlist_count)
+  [ "$count" -eq 0 ] && return 0
+  mpvquery=""
+  for i in $(seq 0 $((count - 1))); do
+    mpvquery="$mpvquery\${playlist/$i/current}\t\${playlist/$i/title}\n"
+  done
+  mpvtmp=$(mktemp)
+  # Get playlist information from mpv
+  __mpv_get "$mpvquery" | grep '.' >"$mpvtmp"
+  # Get MusicBrainz Track ID of current recording
+  current_id=$(grep "^yes" "$mpvtmp" | cut -d "$(printf '\t')" -f 3)
+  # Get file to be used in file_local_recordings
+  rectmp=$(mktemp)
+  cut -d "$(printf '\t')" -f 3 "$mpvtmp" >"$rectmp"
+  # Get list
+  cut -d "$(printf '\t')" -f 2- "$mpvtmp" |
+    awk \
+      -F "\t" \
+      -v file_local_recordings="${rectmp:-}" \
+      -v format="$REC_FORMAT_NO_NUMBER" \
+      -v format_current="$FORMAT_CURRENT" \
+      -v current_id="$current_id" \
+      "$AWK_RECORDINGS" |
+    cut -d "$(printf '\t')" -f 2- |
+    column -t -s "$(printf '\t')" -R 5 |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\):\(.*$\)$|\t\1\t\2\t\3|'
+  rm -f "$rectmp" "$mpvtmp"
+}

src/sh/local.sh

@@ -1,6 +1,6 @@
 gettags() {
   ffprobe -v error -show_entries format_tags -print_format json "$1" |
-    $JQ -r --compact-output '.format.tags | {
+    $JQ '.format.tags | {
       trackid: (."MusicBrainz Release Track Id" // ."MUSICBRAINZ_RELEASETRACKID" // ."MusicBrainz/Release Track Id" // ""),
       releaseid: (."MusicBrainz Album Id" // ."MUSICBRAINZ_ALBUMID" // ."MusicBrainz/Album Id" // "")
     }'
@@ -19,8 +19,8 @@ decorate() {
   (cd "$1" && find . -type f -iname '*.mp3' -o -iname '*.mp4' -o -iname '*.flac' -o -iname '*.m4a') >"$tmpf"
   while IFS= read -r f; do
     mbid=$(gettags "$1/$f")
-    rid=$(echo "$mbid" | $JQ -r '.releaseid')
-    tid=$(echo "$mbid" | $JQ -r '.trackid')
+    rid=$(echo "$mbid" | $JQ '.releaseid')
+    tid=$(echo "$mbid" | $JQ '.trackid')
     if [ ! "$rid" ] || [ ! "$tid" ]; then
       err "File $f: Seems not tagged"
       releaseid=""
@@ -40,7 +40,7 @@ decorate() {
   done <"$tmpf"
   rm -f "$tmpf"
   if [ "$releaseid" ]; then
-    echo "$decoration" | $JQ --compact-output ".releaseid = \"$releaseid\"" >"$1/$DECORATION_FILENAME"
+    echo "$decoration" | $JQ ".releaseid = \"$releaseid\"" >"$1/$DECORATION_FILENAME"
   else
     return 1
   fi
@@ -75,13 +75,13 @@ __batch_load_missing() {
       while IFS= read -r mbid; do
         case "$1" in
         "$TYPE_ARTIST")
-          name=$(mb_artist "$mbid" | $JQ -r ".name")
+          name=$(mb_artist "$mbid" | $JQ ".name")
           ;;
         "$TYPE_RELEASEGROUP")
-          name=$(mb_releasegroup "$mbid" | $JQ -r ".title")
+          name=$(mb_releasegroup "$mbid" | $JQ ".title")
           ;;
         "$TYPE_RELEASE")
-          name=$(mb_release "$mbid" | $JQ -r ".title")
+          name=$(mb_release "$mbid" | $JQ ".title")
           ;;
         esac
         cnt=$((cnt + 1))
@@ -103,35 +103,11 @@ LOCALDATA_RELEASEGROUPS_VIEW="$LOCALDATADIR/releasegroups_view"
 LOCALDATA_RELEASES_VIEW="$LOCALDATADIR/releases_view"
 DECORATION_FILENAME=${DECORATION_FILENAME:-"mbid.json"}
 
-# Load local music
-# argument $1: path to decorated music files
-load_local() {
-  [ -d "$LOCALDATADIR" ] || mkdir -p "$LOCALDATADIR"
-  tmpreleases=$(mktemp)
-  [ -f "$tmpreleases" ] || exit 1
-  info "Locating and parsing decoration files ($DECORATION_FILENAME)"
-  find "$1" -type f -name "$DECORATION_FILENAME" -print0 |
-    xargs -0 -P 4 $JQ -r '.releaseid+"\t"+input_filename' |
-    tee "$LOCALDATA_RELEASES" |
-    cut -d "$(printf '\t')" -f 1 >"$tmpreleases"
-  __batch_load_missing "$TYPE_RELEASE" "$tmpreleases"
-  # Get release groups and album artists
-  while IFS= read -r rid; do
-    mb=$(mb_release "$rid")
-    echo "$mb" | $JQ -r '."release-group".id' >>"$LOCALDATA_RELEASEGROUPS"
-    echo "$mb" | $JQ -r '."release-group"."artist-credit" | map(.artist.id) | join("\n")' >>"$LOCALDATA_ARTISTS"
-  done <"$tmpreleases"
-  tf=$(mktemp)
-  sort "$LOCALDATA_RELEASEGROUPS" | uniq >"$tf" && mv "$tf" "$LOCALDATA_RELEASEGROUPS"
-  sort "$LOCALDATA_ARTISTS" | uniq >"$tf" && mv "$tf" "$LOCALDATA_ARTISTS"
-  # Populate cache with missing data
-  __batch_load_missing "$TYPE_RELEASEGROUP" "$LOCALDATA_RELEASEGROUPS"
-  __batch_load_missing "$TYPE_ARTIST" "$LOCALDATA_ARTISTS"
-  rm -f "$tmpreleases"
 # Precompute views
+precompute_view() {
   info "Precomputing artist view"
   while IFS= read -r aid; do
-    mb_artist "$aid" | $JQ -r '[
+    mb_artist "$aid" | $JQ '[
     .id,
     .type,
     .name,
@@ -149,11 +125,11 @@ load_local() {
       -v format_local="$FORMAT_LOCAL" \
       "$AWK_ARTISTS" |
     sort |
-    column -t -s "$(printf '\t')" |
-    sed 's| \+\([0-9a-f-]\+\)$|\t\1|' >"$LOCALDATA_ARTISTS_VIEW"
+    column -t -s "$(printf '\t')" -E 0 |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\)$|\t\1\t\2|' >"$LOCALDATA_ARTISTS_VIEW"
   info "Precomputing releasegroup view"
   while IFS= read -r rgid; do
-    mb_releasegroup "$rgid" | $JQ -r '[
+    mb_releasegroup "$rgid" | $JQ '[
     .id,
     ."primary-type",
     (."secondary-types" // []|join(";")),
@@ -191,12 +167,12 @@ load_local() {
       "$AWK_RELEASEGROUPS" |
     sort -n -r |
     cut -d "$(printf '\t')" -f 2- |
-    column -t -s "$(printf '\t')" |
-    sed 's| \+\([0-9a-f-]\+\)$|\t\1|' >"$LOCALDATA_RELEASEGROUPS_VIEW"
+    column -t -s "$(printf '\t')" -E 0 |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\)$|\t\1\t\2|' >"$LOCALDATA_RELEASEGROUPS_VIEW"
   info "Precomputing release view"
-  list_releases |
+  cut -d "$(printf '\t')" -f 1 "$LOCALDATA_RELEASES" |
     while IFS= read -r rid; do
-      mb_release "$rid" | $JQ -r '[
+      mb_release "$rid" | $JQ '[
       .id,
       .status,
       .date,
@@ -227,21 +203,36 @@ load_local() {
       "$AWK_RELEASES" |
     sort -n -r |
     cut -d "$(printf '\t')" -f 2- |
-    column -t -s "$(printf '\t')" |
-    sed 's| \+\([0-9a-f-]\+\):\(.*$\)$|\t\1\t\2|' >"$LOCALDATA_RELEASES_VIEW"
+    column -t -s "$(printf '\t')" -E 0 |
+    sed 's| \+\([0-9a-f-]\+\) \+\([0-9a-f-]\+\):\(.*$\)$|\t\1\t\2\t\3|' >"$LOCALDATA_RELEASES_VIEW"
 }
 
-# List all releases
-list_releases() {
-  cut -d "$(printf '\t')" -f 1 "$LOCALDATA_RELEASES"
-}
-
-# List all release groups
-list_releasegroups() {
-  cat "$LOCALDATA_RELEASEGROUPS"
-}
-
-# List all album artists
-list_artists() {
-  cat "$LOCALDATA_ARTISTS"
+# Load local music
+# argument $1: path to decorated music files
+load_local() {
+  [ -d "$LOCALDATADIR" ] || mkdir -p "$LOCALDATADIR"
+  tmpreleases=$(mktemp)
+  [ -f "$tmpreleases" ] || exit 1
+  info "Locating and parsing decoration files ($DECORATION_FILENAME)"
+  find "$1" -type f -name "$DECORATION_FILENAME" -print0 |
+    xargs -0 -P 4 $JQ '.releaseid+"\t"+input_filename' |
+    tee "$LOCALDATA_RELEASES" |
+    cut -d "$(printf '\t')" -f 1 >"$tmpreleases"
+  __batch_load_missing "$TYPE_RELEASE" "$tmpreleases"
+  # Get release groups and album artists
+  while IFS= read -r rid; do
+    mb=$(mb_release "$rid")
+    echo "$mb" | $JQ '."release-group".id' >>"$LOCALDATA_RELEASEGROUPS"
+    echo "$mb" | $JQ '."release-group"."artist-credit" | map(.artist.id) | join("\n")' >>"$LOCALDATA_ARTISTS"
+  done <"$tmpreleases"
+  tf=$(mktemp)
+  sort "$LOCALDATA_RELEASEGROUPS" | uniq >"$tf" && mv "$tf" "$LOCALDATA_RELEASEGROUPS"
+  sort "$LOCALDATA_ARTISTS" | uniq >"$tf" && mv "$tf" "$LOCALDATA_ARTISTS"
+  # Populate cache with missing data
+  __batch_load_missing "$TYPE_RELEASEGROUP" "$LOCALDATA_RELEASEGROUPS"
+  __batch_load_missing "$TYPE_ARTIST" "$LOCALDATA_ARTISTS"
+  rm -f "$tmpreleases"
+  info "Resetting views"
+  rm -f "$LOCALDATA_ARTISTS_VIEW" "$LOCALDATA_RELEASEGROUPS_VIEW" "$LOCALDATA_RELEASES_VIEW"
+  precompute_view
 }

src/sh/log.sh

@@ -0,0 +1,15 @@
+# Logging methods
+ERR="\033[38;5;196m"
+INFO="\033[38;5;75m"
+OFF="\033[m"
+LOGDIR="$HOME/.local/state/$APP_NAME"
+[ -d "$LOGDIR" ] || mkdir -p "$LOGDIR"
+LOGFILE="$LOGDIR/log"
+
+err() {
+  echo "$(date) [$$]>${ERR}ERROR:${OFF} ${1:-}" | tee -a "$LOGFILE" | cut -d ">" -f 2- >/dev/stderr
+}
+
+info() {
+  echo "$(date) [$$]>${INFO}Info:${OFF} ${1:-}" | tee -a "$LOGFILE" | cut -d ">" -f 2- >/dev/stderr
+}

src/sh/mb.sh

@@ -27,7 +27,7 @@ __mb_artist_cache_or_fetch_releasegroups() {
   if ! cache_get_artist_releasegroups "$1"; then
     api_mb_browse_artist_releasegroups "$1" | cache_put_artist_releasegroups "$1"
     rg="$(cache_get_artist_releasegroups "$1")"
-    total=$(printf "%s" "$rg" | $JQ -r '."release-group-count"')
+    total=$(printf "%s" "$rg" | $JQ '."release-group-count"')
     seen=$MB_BROWSE_STEPS
     while [ "$total" -gt "$seen" ]; do
       # Fetch remaning release groups, and append to cache
@@ -43,7 +43,7 @@ __mb_releasegroup_cache_or_fetch_releases() {
   if ! cache_get_releasegroup_releases "$1"; then
     api_mb_browse_releasegroup_releases "$1" | cache_put_releasegroup_releases "$1"
     releases="$(cache_get_releasegroup_releases "$1")"
-    total=$(printf "%s" "$releases" | $JQ -r '."release-count"')
+    total=$(printf "%s" "$releases" | $JQ '."release-count"')
     seen=$MB_BROWSE_STEPS
     while [ "$total" -gt "$seen" ]; do
       # Fetch remaning releases, and append to cache
@@ -66,7 +66,7 @@ mb_artist() {
 mb_artist_wikidata() {
   if ! cache_get_artist_wikidata "$1"; then
     wikidataid=$(mb_artist "$1" |
-      $JQ -r '.relations |
+      $JQ '.relations |
       map(select(.type=="wikidata")) |
       .[0].url.resource // ""' |
       awk -F "/" '{print $NF}')
@@ -89,7 +89,7 @@ mb_artist_enwikipedia() {
     # take the second route.
     wikidata=$(mb_artist_wikidata "$1" || true)
     wikiid=$(printf "%s" "$wikidata" |
-      $JQ -r '.enwiki.url // ""' |
+      $JQ '.enwiki.url // ""' |
       awk -F "/" '{print $NF}')
     [ ! "$wikiid" ] && return
     api_wikipedia_en_summary "$wikiid" | cache_put_artist_enwikipedia "$1"
@@ -102,7 +102,7 @@ mb_artist_enwikipedia() {
 mb_artist_discogs() {
   if ! cache_get_artist_discogs "$1"; then
     discogsid=$(mb_artist "$1" |
-      $JQ -r '.relations |
+      $JQ '.relations |
       map(select(.type=="discogs")) |
       .[0].url.resource // ""' |
       awk -F "/" '{print $NF}')

src/sh/mpv.sh

@@ -0,0 +1,99 @@
+__mpv_command() {
+  printf "{ \"command\": [\"%s\"] }\n" "$1" | $SOCAT - "$MPV_SOCKET"
+}
+
+__mpv_command_with_arg() {
+  printf "{ \"command\": [\"%s\", \"%s\"] }\n" "$1" "$2" | $SOCAT - "$MPV_SOCKET"
+}
+
+__mpv_command_with_args2() {
+  printf "{ \"command\": [\"%s\", \"%s\", \"%s\"] }\n" "$1" "$2" "$3" | $SOCAT - "$MPV_SOCKET"
+}
+
+__mpv_get() {
+  __mpv_command_with_arg "expand-text" "$1" | $JQ '.data'
+}
+
+mpv_playlist_count() {
+  __mpv_get '${playlist-count}'
+}
+
+mpv_playlist_position() {
+  __mpv_get '${playlist-pos}'
+}
+
+mpv_playlist_move() {
+  __mpv_command_with_args2 "playlist-move" "$1" "$2" >>/tmp/foo
+}
+
+mpv_playlist_clear() {
+  __mpv_command "playlist-clear"
+}
+
+mpv_quit() {
+  __mpv_command "quit"
+}
+
+mpv_start() {
+  MPV_SOCKET="$(mktemp --suffix=.sock)"
+  trap 'mpv_quit >/dev/null; rm -f "$MPV_SOCKET"' EXIT INT
+  $MPV --no-config --no-terminal --input-ipc-server="$MPV_SOCKET" --idle --no-osc --no-input-default-bindings &
+}
+
+mpv_play_index() {
+  __mpv_command_with_arg "playlist-play-index" "$1"
+}
+
+mpv_rm_index() {
+  __mpv_command_with_arg "playlist-remove" "$1"
+}
+
+mpv_play_list() {
+  t=$(mktemp)
+  cat >"$t"
+  __mpv_command_with_arg "loadlist" "$t"
+  rm -f "$t"
+}
+
+mpv_queue_list() {
+  t=$(mktemp)
+  cat >"$t"
+  __mpv_command_with_args2 "loadlist" "$t" "append-play"
+  rm -f "$t"
+}
+
+mpv_queue_next_list() {
+  t=$(mktemp)
+  cat >"$t"
+  pos=$(mpv_playlist_position)
+  cnt1=$(mpv_playlist_count)
+  __mpv_command_with_args2 "loadlist" "$t" "append-play"
+  rm -f "$t"
+  cnt2=$(mpv_playlist_count)
+  diff=$((cnt2 - cnt1))
+  [ "$diff" -gt 0 ] || return
+  # Move added items right after current item (numbers are 0 based)
+  for i in $(seq "$diff"); do
+    mpv_playlist_move $((cnt1 + i - 1)) $((pos + i))
+  done
+}
+
+mpv_next() {
+  __mpv_command "playlist-next"
+}
+
+mpv_prev() {
+  __mpv_command "playlist-prev"
+}
+
+mpv_seek_forward() {
+  __mpv_command_with_arg "seek" "10"
+}
+
+mpv_seek_backward() {
+  __mpv_command_with_arg "seek" "-10"
+}
+
+mpv_toggle_pause() {
+  __mpv_command_with_arg "cycle" "pause"
+}

src/sh/playback.sh

@@ -0,0 +1,130 @@
+# Playback tools and helper
+#
+# The methods to control the mpv instance are in `src/sh/mpv.sh`. Here,
+# a higher-level playback functionality is provided.
+
+# Available playback commands
+PLAYBACK_CMD_PLAY="play"
+PLAYBACK_CMD_QUEUE="queue"
+PLAYBACK_CMD_QUEUE_NEXT="queue-next"
+PLAYBACK_CMD_TOGGLE_PLAYBACK="toggle"
+PLAYBACK_CMD_PLAY_NEXT="next"
+PLAYBACK_CMD_PLAY_PREV="prev"
+PLAYBACK_CMD_SEEK_FORWARD="seekf"
+PLAYBACK_CMD_SEEK_BACKWARD="seekb"
+
+# Obtain playback command from key press
+# @argument $1: key
+__playback_cmd_from_key() {
+  key=$1
+  case ",$KEYS_PLAY," in *",$key,"*) echo "$PLAYBACK_CMD_PLAY" && return ;; esac
+  case ",$KEYS_N_PLAY," in *",$key,"*) echo "$PLAYBACK_CMD_PLAY" && return ;; esac
+  case ",$KEYS_QUEUE," in *",$key,"*) echo "$PLAYBACK_CMD_QUEUE" && return ;; esac
+  case ",$KEYS_N_QUEUE," in *",$key,"*) echo "$PLAYBACK_CMD_QUEUE" && return ;; esac
+  case ",$KEYS_QUEUE_NEXT," in *",$key,"*) echo "$PLAYBACK_CMD_QUEUE_NEXT" && return ;; esac
+  case ",$KEYS_N_QUEUE_NEXT," in *",$key,"*) echo "$PLAYBACK_CMD_QUEUE_NEXT" && return ;; esac
+  case ",$KEYS_TOGGLE_PLAYBACK," in *",$key,"*) echo "$PLAYBACK_CMD_TOGGLE_PLAYBACK" && return ;; esac
+  case ",$KEYS_N_TOGGLE_PLAYBACK," in *",$key,"*) echo "$PLAYBACK_CMD_TOGGLE_PLAYBACK" && return ;; esac
+  case ",$KEYS_PLAY_NEXT," in *",$key,"*) echo "$PLAYBACK_CMD_PLAY_NEXT" && return ;; esac
+  case ",$KEYS_N_PLAY_NEXT," in *",$key,"*) echo "$PLAYBACK_CMD_PLAY_NEXT" && return ;; esac
+  case ",$KEYS_PLAY_PREV," in *",$key,"*) echo "$PLAYBACK_CMD_PLAY_PREV" && return ;; esac
+  case ",$KEYS_N_PLAY_PREV," in *",$key,"*) echo "$PLAYBACK_CMD_PLAY_PREV" && return ;; esac
+  case ",$KEYS_SEEK_FORWARD," in *",$key,"*) echo "$PLAYBACK_CMD_SEEK_FORWARD" && return ;; esac
+  case ",$KEYS_N_SEEK_FORWARD," in *",$key,"*) echo "$PLAYBACK_CMD_SEEK_FORWARD" && return ;; esac
+  case ",$KEYS_SEEK_BACKWARD," in *",$key,"*) echo "$PLAYBACK_CMD_SEEK_BACKWARD" && return ;; esac
+  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[] |
+        .position as $pos |
+        .tracks |
+        if ($tid == "") then . else map(select(.id == $tid)) end |
+        map({
+          t: [
+          $rid,
+          .id,
+          $pos,
+          .number,
+          .length,
+          .title,
+          (."artist-credit" | map([.name, .joinphrase] | join("")) | join("")),
+          $deco
+          ] | join("\t"),
+          length: (.length / 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
+# @argument $2: MusicBrainz ID of current object
+# @argument $3: MusicBrainz ID of selected object
+# @argument $4: Path to decoration file
+#
+# This option controls the mpv instance via a key pressed in fzf. The key
+# pressed is stored in the environment variable FZF_KEY and is resolved to
+# the playback command through the method `__playback_cmd_from_key`.
+playback() {
+  view=${1:-}
+  mbid_current="${2:-}"
+  mbid="${3:-}"
+  path="${4:-}"
+  pbcmd=$(__playback_cmd_from_key "$FZF_KEY")
+  info "playback(): view=$view; mbid_current=$mbid_current; mbid=$mbid; path=$path; pbcmd=$pbcmd"
+  case "$pbcmd" in
+  "$PLAYBACK_CMD_PLAY")
+    [ "$path" ] || exit 0
+    case "$view" in
+    "$VIEW_ARTIST" | "$VIEW_SEARCH_ARTIST" | "$VIEW_SEARCH_ALBUM" | "$VIEW_LIST_ARTISTS" | "$VIEW_LIST_ALBUMS") info "not implemented" ;;
+    "$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
+    ;;
+  "$PLAYBACK_CMD_QUEUE")
+    [ "$path" ] || exit 0
+    case "$view" in
+    "$VIEW_ARTIST" | "$VIEW_SEARCH_ARTIST" | "$VIEW_SEARCH_ALBUM" | "$VIEW_LIST_ARTISTS" | "$VIEW_LIST_ALBUMS") info "not implemented" ;;
+    "$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")
+    [ "$path" ] || exit 0
+    case "$view" in
+    "$VIEW_ARTIST" | "$VIEW_SEARCH_ARTIST" | "$VIEW_SEARCH_ALBUM" | "$VIEW_LIST_ARTISTS" | "$VIEW_LIST_ALBUMS") info "not implemented" ;;
+    "$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 ;;
+  "$PLAYBACK_CMD_PLAY_NEXT") mpv_next ;;
+  "$PLAYBACK_CMD_PLAY_PREV") mpv_prev ;;
+  "$PLAYBACK_CMD_SEEK_FORWARD") mpv_seek_forward ;;
+  "$PLAYBACK_CMD_SEEK_BACKWARD") mpv_seek_backward ;;
+  esac
+}

src/sh/playlist.sh

@@ -0,0 +1,32 @@
+PLAYLIST_CMD_REMOVE="rm"
+PLAYLIST_CMD_UP="up"
+PLAYLIST_CMD_DOWN="down"
+PLAYLIST_CMD_CLEAR="clear"
+PLAYLIST_CMD_CLEAR_ABOVE="clear-above"
+PLAYLIST_CMD_CLEAR_BELOW="clear-below"
+
+# Run playback commands
+#
+# @argument $1: playlist command
+#
+# This is a wrapper to execute mpv commands.
+playlist() {
+  case "$1" in
+  "$PLAYLIST_CMD_REMOVE") mpv_rm_index $((FZF_POS - 1)) ;;
+  "$PLAYLIST_CMD_UP") mpv_playlist_move $((FZF_POS - 1)) $((FZF_POS - 2)) ;;
+  "$PLAYLIST_CMD_DOWN") mpv_playlist_move $((FZF_POS - 0)) $((FZF_POS - 1)) ;;
+  "$PLAYLIST_CMD_CLEAR") mpv_playlist_clear ;;
+  "$PLAYLIST_CMD_CLEAR_ABOVE")
+    for i in $(seq "$FZF_POS"); do
+      mpv_rm_index 0
+    done
+    ;;
+  "$PLAYLIST_CMD_CLEAR_BELOW")
+    cnt=$(mpv_playlist_count)
+    rem=$((cnt - FZF_POS + 1))
+    for i in $(seq "$rem"); do
+      mpv_rm_index $((FZF_POS - 1))
+    done
+    ;;
+  esac
+}

src/sh/preview.sh

@@ -5,14 +5,14 @@ __shape() {
 # Print preview of artist
 # @input $1: MusicBrainz Artist ID
 __preview_artist() {
-  desc=$(mb_artist_enwikipedia "$1" | $JQ -r '.extract' | __shape)
-  [ "$desc" ] || desc=$(mb_artist_discogs "$1" | $JQ -r '.profile' | sed 's/\[a=\([^]]*\)\]/\1/g' | __shape)
-  if [ "$(mb_artist "$1" | $JQ -r '.type')" = "Person" ]; then
+  desc=$(mb_artist_enwikipedia "$1" | $JQ '.extract' | __shape)
+  [ "$desc" ] || desc=$(mb_artist_discogs "$1" | $JQ '.profile' | sed 's/\[a=\([^]]*\)\]/\1/g' | __shape)
+  if [ "$(mb_artist "$1" | $JQ '.type')" = "Person" ]; then
     # Show birth place and death place of person
-    lsb=$(mb_artist "$1" | $JQ -r '."life-span".begin // ""' | head -c 4)
-    lse=$(mb_artist "$1" | $JQ -r '."life-span".end // ""' | head -c 4)
-    ab=$(mb_artist "$1" | $JQ -r '."begin-area".name // ""')
-    ae=$(mb_artist "$1" | $JQ -r '."end-area".name // ""')
+    lsb=$(mb_artist "$1" | $JQ '."life-span".begin // ""' | head -c 4)
+    lse=$(mb_artist "$1" | $JQ '."life-span".end // ""' | head -c 4)
+    ab=$(mb_artist "$1" | $JQ '."begin-area".name // ""')
+    ae=$(mb_artist "$1" | $JQ '."end-area".name // ""')
     if [ "$lsb" ] && [ "$ab" ]; then
       begin=$(printf "$APV_DATEPLACE" "$lsb" "$ab")
     elif [ "$lsb" ]; then

src/sh/query.sh

@@ -0,0 +1,155 @@
+# The default queries depend on the current view, and are usually derived from
+# the theme. Nevertheless, they may be overwritten with the configuration file.
+# Note that filters are not used in the views VIEW_SEARCH_ARTIST and
+# VIEW_SEARCH_ALBUM. The reason for this is that in those modes, changing the
+# query string triggers a search on the MusicBrainz website (the input is not a
+# filter, but a query).
+#
+# The keybinding KEYS_FILTER_LOCAL triggers a filter of QUERY_LOCAL in the
+# views VIEW_ARTIST, VIEW_RELEASEGROUP, and VIEW_RELEASE only. Here, it is only
+# possible to adjust QUERY_LOCAL via the configuration. The keybinding KEYS_FILTER_0
+# resets the query. F_1_.. filters are the default filters when the respective
+# view is entered. For all other keys, the filters are individually
+# configurable, by specifying e.g., F_3_VIEW_LIST_ALBUMS.
+#
+# Derived queries
+# To derive the queries from the theme, we must perform some steps: 1) remove
+# colors, and 2) escape white spaces. This is implemented in the method
+# `__clean_filter`.
+#
+# List of derived queries:
+# - QUERY_LOCAL: Hide items that are not locally available
+# - q_has_secondary: Release groups with secondary types
+# - q_album: Release group is of type Album
+# - q_ep: Release group is of type EP
+# - q_single: Release group is of type single
+# - q_official: Release is official
+
+__clean_filter() {
+  cat | sed "s/${ESC}\[[0-9;]*[mK]//g" | sed "s/ /\\\ /g"
+}
+
+# Determine preset query
+# @argument $1: Current view
+# @argument $2: Key pressed (optional)
+#
+# If the key is not given, then the F_1_.. query is used for the respective
+# view, i.e, its as if a key from KEYS_FILTER_1 has been pressed.
+default_query() {
+  view=$1
+  key="${2:-"$(echo "$KEYS_FILTER_1" | cut -d ',' -f 1)"}"
+  case ",$KEYS_FILTER_LOCAL," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST" | "$VIEW_RELEASEGROUP" | "$VIEW_RELEASE") echo "$QUERY_LOCAL" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_1," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_1_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_1_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_1_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_1_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_1_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_2," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_2_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_2_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_2_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_2_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_2_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_3," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_3_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_3_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_3_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_3_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_3_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_4," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_4_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_4_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_4_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_4_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_4_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_5," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_5_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_5_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_5_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_5_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_5_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_6," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_6_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_6_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_6_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_6_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_6_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_7," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_7_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_7_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_7_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_7_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_7_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_8," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_8_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_8_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_8_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_8_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_8_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  case ",$KEYS_FILTER_9," in
+  *",$key,"*)
+    case "$view" in
+    "$VIEW_ARTIST") echo "$F_9_VIEW_ARTIST" ;;
+    "$VIEW_RELEASEGROUP") echo "$F_9_VIEW_RELEASEGROUP" ;;
+    "$VIEW_RELEASE") echo "$F_9_VIEW_RELEASE" ;;
+    "$VIEW_LIST_ARTISTS") echo "$F_9_LIST_ARTISTS" ;;
+    "$VIEW_LIST_ALBUMS") echo "$F_9_LIST_ALBUMS" ;;
+    esac
+    ;;
+  esac
+  # Doing nothing is the same as this last block:
+  # case ",$KEYS_FILTER_0," in
+  # *",$key,"*)
+  #   case "$view" in
+  #   "$VIEW_ARTIST" | "$VIEW_RELEASEGROUP" | "$VIEW_RELEASE" | "$VIEW_LIST_ARTISTS" | "$VIEW_LIST_ALBUMS") echo "" ;;
+  #   esac
+  #   ;;
+  # esac
+}

src/sh/theme.sh

@@ -1,40 +1,86 @@
-# Colors (local)
-FAINT="\033[2m"
-CARTIST="\033[38;5;209m"
-CTITLE="\033[38;5;229m"
-CYEAR="\033[38;5;179m"
-CDISAMB="$FAINT\033[38;5;172m"
-CNOTE="\033[38;5;242m"
-CXXX="\033[38;5;109m"
-CDESC="\033[38;5;254m"
-CLIFE="\033[38;5;251m"
-OFF="\033[m"
+# Theme file (default theme)
+# This file specifies the main theme of the visual representation. All
+# specifications provided here may be altered using the configuration file.
+#
+# This theme requires fonts that support utf-8, colors, and emojis.
 
+# Colors (internal only)
+ESC=$(printf '\033')
+FAINT="${ESC}[2m"
+CARTIST="${ESC}[38;5;209m"
+CTITLE="${ESC}[38;5;229m"
+CYEAR="${ESC}[38;5;179m"
+CDISAMB="$FAINT${ESC}[38;5;172m"
+CNOTE="${ESC}[38;5;242m"
+CXXX="${ESC}[38;5;109m"
+CDESC="${ESC}[38;5;254m"
+CLIFE="${ESC}[38;5;251m"
+OFF="${ESC}[m"
+
+# Pointers
+# ========
+# Sign that indicates the existence of audio files
 FORMAT_LOCAL="${FORMAT_LOCAL:-"🔆"}"
+# Pointer to the track currently playing (playlist)
+FORMAT_CURRENT="${FORMAT_CURRENT:-"👉"}"
+export FORMAT_LOCAL FORMAT_CURRENT
 
-# Prompts
+# Input prompts
+# =============
+# General search prompt
 SEARCH_PROMPT=${SEARCH_PROMPT:-"🔎 〉"}
+# Prompt that takes an artist name as argument
 ARTIST_PROMPT="${ARTIST_PROMPT:-"🎤 ${CARTIST}%s$OFF 〉"}"
+# Prompt that takes an artist name and a release name as arguments (in that
+# order)
 FULL_PROMPT="${FULL_PROMPT:-"🎤 ${CARTIST}%s$OFF 》${CTITLE}%s$OFF 〉"}"
+export SEARCH_PROMPT ARTIST_PROMPT FULL_PROMPT
+
+# Visual representation of current mode
+# =====================================
+# Sign to indicate `normal` mode
+PROMPT_NORMAL="${PROMPT_NORMAL:-"${FAINT}[n]${OFF}"}"
+# Sign to indicate `insert` mode
+PROMPT_INSERT="${PROMPT_INSERT:-"${FAINT}[i]${OFF}"}"
+export PROMPT_NORMAL PROMPT_INSERT
 
 # Artist view
+# ===========
+# Artist string for persons
 AV_PERSON="${AV_PERSON:-"🧑‍🎤 $CARTIST<<name>>$OFF"}"
+# Artist string for groups
 AV_GROUP="${AV_GROUP:-"🧑‍🤝‍🧑 $CARTIST<<name>>$OFF"}"
+# Artist disambiguation string
 AV_DISAMBIGUATION="${AV_DISAMBIGUATION:-"$CDISAMB(<<disambiguation>>)$OFF"}"
+export AV_PERSON AV_GROUP AV_DISAMBIGUATION
 
-# Release group view
+# Release-group view
+# ==================
+# Default release group string
 RGV_RELEASE="${RGV_RELEASE:-"${CTITLE}<<title>>$OFF"}"
+# Release group string if the artist name differs from the current artist
 RGV_RELEASE_W_ARTIST="${RGV_RELEASE_W_ARTIST:-"${CTITLE}<<title>>$OFF — ${CARTIST}<<artist>>$OFF"}"
+# Year of the release group
 RGV_YEAR="${RGV_YEAR:-"${CYEAR}(<<year>>)$OFF"}"
+export RGV_RELEASE RGV_RELEASE_W_ARTIST RGV_YEAR
 
-# Types
+# Release-group types
+# ===================
+# Album
 FORMAT_TYPE_ALBUM="${FORMAT_TYPE_ALBUM:-"LP 💽"}"
+# EP
 FORMAT_TYPE_EP="${FORMAT_TYPE_EP:-"EP 📀"}"
+# Single
 FORMAT_TYPE_SINGLE="${FORMAT_TYPE_SINGLE:-"SI 🎶"}"
+# Broadcast
 FORMAT_TYPE_BROADCAST="${FORMAT_TYPE_BROADCAST:-"BR 📻"}"
+# Other
 FORMAT_TYPE_OTHER="${FORMAT_TYPE_OTHER:-"OT ❔"}"
+# Flag to indicate that the given release group has associated secondary types.
 FORMAT_TYPE_HAS_SECONDARY="${FORMAT_TYPE_HAS_SECONDARY:-"%s☼"}"
+# Style to represent secondary types (takes one %s placeholder)
 FORMAT_TYPE_SECONDARY="${FORMAT_TYPE_SECONDARY:-"${CNOTE}[☼: %s]$OFF"}"
+# Secondary types
 FORMAT_TYPE_SECONDARY_COMPILATION="${FORMAT_TYPE_SECONDARY_COMPILATION:-"🧩 compilation"}"
 FORMAT_TYPE_SECONDARY_SOUNDTRACK="${FORMAT_TYPE_SECONDARY_SOUNDTRACK:-"🎬 soundtrack"}"
 FORMAT_TYPE_SECONDARY_SPOKENWORD="${FORMAT_TYPE_SECONDARY_SPOKENWORD:-"📖 spokenword"}"
@@ -47,29 +93,62 @@ FORMAT_TYPE_SECONDARY_DJMIX="${FORMAT_TYPE_SECONDARY_DJMIX:-"🪩 DJ-mix"}"
 FORMAT_TYPE_SECONDARY_MIXTAPE="${FORMAT_TYPE_SECONDARY_MIXTAPE:-"📼 mixtape"}"
 FORMAT_TYPE_SECONDARY_DEMO="${FORMAT_TYPE_SECONDARY_DEMO:-"🧪 demo"}"
 FORMAT_TYPE_SECONDARY_FIELDREC="${FORMAT_TYPE_SECONDARY_FIELDREC:-"🌿 field recording"}"
+export FORMAT_TYPE_ALBUM FORMAT_TYPE_EP FORMAT_TYPE_SINGLE \
+  FORMAT_TYPE_BROADCAST FORMAT_TYPE_OTHER FORMAT_TYPE_HAS_SECONDARY \
+  FORMAT_TYPE_SECONDARY FORMAT_TYPE_SECONDARY_COMPILATION \
+  FORMAT_TYPE_SECONDARY_SOUNDTRACK FORMAT_TYPE_SECONDARY_SPOKENWORD \
+  FORMAT_TYPE_SECONDARY_INTERVIEW FORMAT_TYPE_SECONDARY_AUDIOBOOK \
+  FORMAT_TYPE_SECONDARY_AUDIODRAMA FORMAT_TYPE_SECONDARY_LIVE \
+  FORMAT_TYPE_SECONDARY_REMIX FORMAT_TYPE_SECONDARY_DJMIX \
+  FORMAT_TYPE_SECONDARY_MIXTAPE FORMAT_TYPE_SECONDARY_DEMO \
+  FORMAT_TYPE_SECONDARY_FIELDREC
 
 # Artist Preview
+# ==============
+# Main preview format. Takes two %s placeholder. The first is for the artist
+# biography. The second for the life span.
 APV_FORMAT="${APV_FORMAT:-"\n\n${CDESC}%s${OFF}\n\n${CLIFE}%s${OFF}"}"
+# Specification of a date
 APV_DATE="${APV_DATE:-"%s"}"
+# Specification of a place
 APV_PLACE="${APV_PLACE:-"%s"}"
+# Specification of a date and a place (in that order)
 APV_DATEPLACE="${APV_DATEPLACE:-"$APV_DATE, $APV_PLACE"}"
+# String to represent when/where a person is born
 APV_BORN="${APV_BORN:-"🍼 Born: %s"}"
+# String to represent when/where a person died
 APV_DIED="${APV_DIED:-"🕯️ Died: %s"}"
-
-# Status
-FORMAT_STATUS_OFFICIAL="${FORMAT_STATUS_OFFICIAL:-"🟢 official"}"
-FORMAT_STATUS_PROMO="${FORMAT_STATUS_PROMO:-"📣 promo"}"
-FORMAT_STATUS_BOOTLEG="${FORMAT_STATUS_BOOTLEG:-"💣 bootleg"}"
-FORMAT_STATUS_PSEUDO="${FORMAT_STATUS_PSEUDO:-"🌀 pseudo"}"
-FORMAT_STATUS_WITHDRAWN="${FORMAT_STATUS_WITHDRAWN:-"🔙 withdrawn"}"
-FORMAT_STATUS_EXPUNGED="${FORMAT_STATUS_EXPUNGED:-"🧹 expunged"}"
-FORMAT_STATUS_CANCELLED="${FORMAT_STATUS_CANCELLED:-"❌ cancelled"}"
+export APV_FORMAT APV_DATE APV_PLACE APV_DATEPLACE APV_BORN APV_DIED
 
 # Release view
-RV_FORMAT="<<status>>\t${CXXX}<<tracks>> tracks\t<<media>>$OFF\t${CYEAR}<<year>>\t<<country>>$OFF\t${CARTIST}<<label>>$OFF"
-RV_TITLE_ARTIST="${FAINT}as ${CTITLE}<<title>>$OFF by ${FAINT}${CARTIST}<<artist>>$OFF"
-RV_TITLE="${FAINT}as ${CTITLE}<<title>>$OFF"
-RV_ARTIST="${FAINT}by ${CARTIST}<<artist>>$OFF"
+# ============
+# Format of a string that represents a release.
+RV_FORMAT="${RV_FORMAT:-"<<status>>\t${CXXX}<<tracks>> tracks\t<<media>>$OFF\t${CYEAR}<<year>>\t<<country>>$OFF\t${CARTIST}<<label>>$OFF"}"
+# Additional string to display the release title and artist name
+RV_TITLE_ARTIST="${RV_TITLE_ARTIST:-"${FAINT}as ${CTITLE}<<title>>$OFF by ${FAINT}${CARTIST}<<artist>>$OFF"}"
+# Additional string to display the release title
+RV_TITLE="${RV_TITLE:-"${FAINT}as ${CTITLE}<<title>>$OFF"}"
+# Additional string to display the artist
+RV_ARTIST="${RV_ARTIST:-"${FAINT}by ${CARTIST}<<artist>>$OFF"}"
+export RV_FORMAT RV_TITLE_ARTIST RV_TITLE RV_ARTIST
+
+# Release Status
+# ==============
+FORMAT_STATUS_OFFICIAL="${FORMAT_STATUS_OFFICIAL:-"🟢"}"
+FORMAT_STATUS_PROMO="${FORMAT_STATUS_PROMO:-"📣"}"
+FORMAT_STATUS_BOOTLEG="${FORMAT_STATUS_BOOTLEG:-"💣"}"
+FORMAT_STATUS_PSEUDO="${FORMAT_STATUS_PSEUDO:-"🌀"}"
+FORMAT_STATUS_WITHDRAWN="${FORMAT_STATUS_WITHDRAWN:-"🔙"}"
+FORMAT_STATUS_EXPUNGED="${FORMAT_STATUS_EXPUNGED:-"🧹"}"
+FORMAT_STATUS_CANCELLED="${FORMAT_STATUS_CANCELLED:-"❌"}"
+export FORMAT_STATUS_OFFICIAL FORMAT_STATUS_PROMO FORMAT_STATUS_BOOTLEG \
+  FORMAT_STATUS_PSEUDO FORMAT_STATUS_WITHDRAWN FORMAT_STATUS_EXPUNGED \
+  FORMAT_STATUS_CANCELLED
 
 # Recording view
-REC_FORMAT="${CNOTE}${FAINT}<<med>>\t${CNOTE}<<nr>>$OFF\t${CTITLE}<<title>>\t${CARTIST}<<artist>>\t${CXXX}<<duration>>$OFF"
+# ==============
+# Format of a track in a release
+REC_FORMAT="${REC_FORMAT:-"${CNOTE}${FAINT}<<med>>\t${CNOTE}<<nr>>$OFF\t${CTITLE}<<title>>\t${CARTIST}<<artist>>\t${CXXX}<<duration>>$OFF"}"
+# Format of a track in the playlist
+REC_FORMAT_NO_NUMBER="${REC_FORMAT_NO_NUMBER:-"${CTITLE}<<title>>\t${CARTIST}<<artist>>\t${CXXX}<<duration>>$OFF"}"
+export REC_FORMAT REC_FORMAT_NO_NUMBER

src/sh/tools.sh

@@ -1,5 +1,6 @@
+if [ ! "${TOOLS_LOADED:-}" ]; then
   if command -v "fzf" >/dev/null; then
-  FZF="fzf --black"
+    FZF="fzf --black --ansi --cycle --tiebreak=chunk,index"
   else
     err "Did not find the command-line fuzzy finder fzf."
     exit 1
@@ -15,7 +16,7 @@ fi
   export CURL
 
   if command -v "jq" >/dev/null; then
-  JQ="jq"
+    JQ="jq -r --compact-output"
   else
     err "Did not find jq."
     exit 1
@@ -37,3 +38,6 @@ else
     exit 1
   fi
   export SOCAT
+
+  export TOOLS_LOADED=1
+fi