rockbox/manual/plugins/random_folder_advance_config.tex
Christian Soffke f0d99391de plugins: random folder advance: misc improvements
fixes:
- traverse_dir was called recursively using two
  MAX_PATH local buffers => possible stack overflow
- The import function inserted additional, incorrect,
  entries when the whole line buffer was filled
- "Dirs not found" message overlapped number
  of folders when generating folder list
- Final number of scanned folders wasn't displayed
- Wouldn't stop inserting when maximum number
  of files in playlist was already reached
- Prevent buffer overflow when importing
- Don't write to fd after opening failed
- Use whole buffer with read_line, instead
  of subtracting 1. Remove hard coded sizes
- CRs don't need to be removed in import function
  (already handled by read_line)

features:
- Use insert context for *much* faster insertion
  of large # of folders, and nicer progress display
- Use UI viewport
- Add progress indicator when saving or loading
- Display number of folders in edit list title
- Go back to plugin's main menu from edit list
- Only ask to save changes if list is dirty
- Warn before erasing modified playlist
- Flag successfully created playlist as modified
- Make folder scan wait for dircache
- Shorten menu item names
- Put "Play Shuffled" menu item first
- Remember selection when returning from submenus
- Go to WPS after ACTION_TREE_WPS
- Exit menu when pressing Back
- Perform an initial scan, if no data file exists
  yet, when "Play Shuffled" or "Edit" is selected

Change-Id: I7df76f8fb8387888ce491d8b74b01b481e9997d3
2026-01-16 16:49:38 +01:00

43 lines
1.8 KiB
TeX

\subsection{Random Folder Advance Configuration}
{\label{ref:random_folder_advance_config}}
This plugin is used to configure the folders which will be considered
when the Auto-Change Directory feature is set to \setting{Random}.
\subsubsection{Menu}
\begin{description}
\item[Play Shuffled] Starts playback with the selected directories in random order. Tracks within a directory will be played in normal order. The plugin will exit after starting playback.
\item[Scan Folders] Generates a list of all folders found
on the player. You can filter the directories which are scanned by
creating a file called \\*
\fname{/.rockbox/folder\_advance\_dir.txt}.
Only the directories in this file and any contained directories
will be scanned. You can have up to 10 directories ignored by the
scan by placing a minus sign before them in the list
(i.e. \fname{-/CDs} will cause everything in the \fname{/CDs}
directory to be ignored.). If you just want \fname{/CDs}
to be ignored but want to include the folders within
it you need to have both \fname{-/CDs} and \fname{CDs} as entries.
\item[Edit] Enter the folder list editor
\item[Export to Text File] Exports the list to
\fname{/.rockbox/folder\_advance\_list.txt}
\item[Import from Text File] Imports the list from
\fname{/.rockbox/folder\_advance\_list.txt}
\item[Quit]
\end{description}
\subsubsection{Folder List Editor Keys}
\begin{btnmap}
\ActionStdOk{}
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdOk}
& Delete selected folder\\
\ActionStdContext{}
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdContext}
& Bring up the context menu which allows you to
remove the selected folder or its entire folder tree\\
\ActionStdCancel{}
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdCancel}
& Exit\\
\end{btnmap}