From f7db73097a30a9cd5ec6415fcc197749ee1bc559 Mon Sep 17 00:00:00 2001
From: Paul Sauro <olsroparadise@proton.me>
Date: Sat, 7 Sep 2024 13:55:45 +0200
Subject: Playlist viewer: Add new options to allow formatting using tags

Offer new options to show elegantly your entries in any playlist/dynamic playlist viewer. This is especially important if you dual boot an iPod with Stock OS and want to sync with iTunes; with this very popular setup, file names are obfuscated which results in any Rockbox playlist viewer difficult to enjoy, and it was a long standing issue reported by several Rockbox users over the years. The only way to show the title was to open a contextual menu on each song to get infos about the selected song, which is a very long and anti-ergonomic process to understand what is on your current playlist/randomized playlist. The idea of this patch is to provide new alternatives that the user can select. I personally selected the Title & Album view which provides excellent readability.

This patch was built with performance in mind using lazy loading to load one by one the tags then cache a string and use the little cache as much as possible to make scrolling in the same area as smooth as possible. Performance remains very acceptable even on an iPod 4G with its original hard drive. Using a real compact flash with my iPod Mini 2G reduces the latency even more.

Those new options are disabled by default because they impact noticeably the scrolling performance and are less relevant if your files are decently properly named.

Unfortunately, the search feature in a playlist will need to continue to use the raw filename because reading the tags for a whole playlist is a performance disaster. This works decently while viewing just because I made a code that load those one by one as much as possible.

I focused also on testing that the opening of the playlist viewer UI remained fast, and loading one by one with lazy loading allows to get very little overhead in this regard.

Change-Id: I00d9c802e29f8372447813b035bbae207a016467
---
 manual/appendix/config_file_options.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'manual/appendix/config_file_options.tex')

diff --git a/manual/appendix/config_file_options.tex b/manual/appendix/config_file_options.tex
index 01deb1f174..cb31068964 100644
--- a/manual/appendix/config_file_options.tex
+++ b/manual/appendix/config_file_options.tex
@@ -58,7 +58,7 @@
     playlist viewer indices
                     & on, off           & N/A\\
     playlist viewer track display
-                    & track name,full path
+                    & track name,full path,title and album from tags,title from tags
                                         & N/A\\
     recursive directory insert
                     & on, off, ask      & N/A\\
-- 
cgit v1.2.3

