rockbox/manual/configure_rockbox/autoresume.tex
Michael Hohmuth 04043fd3ae autoresume: Manual: Clarify precedence rules for resume positions
Resume positions stored in bookmarks take precedence over autoresume.

Technically, the resume position for the "Resume Playback" function
(which is also saved across power-off/power-on) also takes precedence
over autoresume.  However, there is no way for a user to tell as it is
identical to the autoresume position for the last-played track, so
don't highlight it in the manual.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@29548 a1c6a512-1295-4272-9138-f99709370657
2011-03-08 23:02:20 +00:00

57 lines
2.8 KiB
TeX

% $Id$ %
\section{\label{ref:Autoresumeconfigactual}Automatic resume}
The automatic resume feature stores and recalls resume positions for
all tracks without user intervention. These resume points are stored
in the database, and thus automatic resume only works when the
database has been initialized.
When automatic resume is enabled, manually selected tracks resume
playback at their last playback position. It does not matter in which
way you start the track; tracks are resumed whether they are navigated
to through the database browser or file browser, by starting a
playlist, or by skipping through tracks in the current playlist. (As
an exception, when a track is resumed by loading a bookmark, the
playback position saved in the bookmark takes precedence.)
Optionally, you can also enable automatic resume for automatic track
transitions. In this case, the next track will be resumed as well
instead of starting playback at its beginning. This is most useful
for podcasts, and can be enabled on a per-directory basis.
A track's resume position is updated whenever playback of that track
stops, including when explicitly stopping the track, powering off the
\dap{}, or starting playback of another track.
If you intend to start a track from its beginning but notice that it
was resumed, you can press \ActionWpsSkipPrev{} in the WPS to skip back to
its beginning. When pressing \ActionWpsSkipPrev{} again in the first few
seconds of a track to go to the previous track, the previously (on
first button press) saved resume position is retained. Therefore, you
can also use \ActionWpsSkipPrev{} and \ActionWpsSkipNext{} to skip
across tracks in a playlist without losing their resume position.
\begin{description}
\item[Automatic resume.] This option enables or disables automatic
resume globally. When Rockbox detects that the database (which is
needed for this feature) has not been initialized yet, it asks
whether it should be initialized right away.
\item[Resume on automatic track change.] Controls whether the next
track in an automatic track transition should be resumed at its last
playback position as well.
\begin{description}
\item[No.] Automatic resume works only for manual track selection.
\item[Yes.] Always attempt to resume -- for both manual and
automatic track changes.
\item[In custom directories only.] Configure directories in which to
enable resume on automatic track change. Selecting this option
starts the text editor, in which you can enter the (absolute,
case-insensitive) directory names separated by colons (``:'').
A typical value is ``/podcast'', which matches all files in
directories \fname{/PODCAST}, \fname{/Podcast} or \fname{/podcast}
and their subdirectories, but not in directories \fname{/podcasts}
(mind the trailing ``s'') or \fname{/audio/podcast}.
\end{description}
\end{description}