branch: externals/listen
commit 7b3a6b60bbfb5d13101158d538b1937f1d2d02ac
Author: Adam Porter <[email protected]>
Commit: Adam Porter <[email protected]>
Docs: Improve library section
---
README.org | 4 ++++
docs/README.org | 8 ++++++--
2 files changed, 10 insertions(+), 2 deletions(-)
diff --git a/README.org b/README.org
index c2af7ccdc6..f1b6702448 100644
--- a/README.org
+++ b/README.org
@@ -149,6 +149,10 @@ The queue list buffer may be shown with the command
~listen-queue-list~. In the
To help with exploring and managing a music library, ~listen~ provides various
"library" features. Tracks can be passed between library and queue buffers and
operated on with similar commands and bindings.
+~listen~ does not maintain its own database of audio files; they are simply
read from the filesystem as needed. But if a local MPD server is available,
tracks can be loaded from its database (which does a fine job of indexing audio
files and their metadata); this is generally much faster, because it avoids
having to read tracks' metadata with Emacs Lisp or their durations with
~ffprobe~.
+
+~listen~ does not provide features to modify tracks' metadata, but it provides
commands to run shell commands on tracks' filenames, which works well with
external tools like [[https://picard.musicbrainz.org/][Picard]].
+
*** Library buffer
A library buffer provides a hierarchical view of tracks grouped by their
metadata using [[info:taxy#Top][Taxy]], rendered with
[[info:magit-section#Top][Magit Section]]. Each section can be folded, and it
shows the number of tracks in it and its subgroups.
diff --git a/docs/README.org b/docs/README.org
index 1ccb486bd3..bb47f91d88 100644
--- a/docs/README.org
+++ b/docs/README.org
@@ -152,13 +152,17 @@ The queue list buffer may be shown with the command
~listen-queue-list~. In the
| Show queue's tracks in library buffer |
{{{command-binding(listen-library-from-queue,l)}}} |
| Revert the queue list | {{{command-binding(listen-queue-list,g)}}} |
-| Pause the player | {{{command-binding(listen-pause,SPC)}}}
|
-| Show the menu | {{{command-binding(listen-menu,?)}}}
|
+| Pause the player | {{{command-binding(listen-pause,SPC)}}} |
+| Show the menu | {{{command-binding(listen-menu,?)}}} |
** Library
To help with exploring and managing a music library, ~listen~ provides various
"library" features. Tracks can be passed between library and queue buffers and
operated on with similar commands and bindings.
+~listen~ does not maintain its own database of audio files; they are simply
read from the filesystem as needed. But if a local MPD server is available,
tracks can be loaded from its database (which does a fine job of indexing audio
files and their metadata); this is generally much faster, because it avoids
having to read tracks' metadata with Emacs Lisp or their durations with
~ffprobe~.
+
+~listen~ does not provide features to modify tracks' metadata, but it provides
commands to run shell commands on tracks' filenames, which works well with
external tools like [[https://picard.musicbrainz.org/][Picard]].
+
*** Library buffer
A library buffer provides a hierarchical view of tracks grouped by their
metadata using [[info:taxy#Top][Taxy]], rendered with
[[info:magit-section#Top][Magit Section]]. Each section can be folded, and it
shows the number of tracks in it and its subgroups.
