Re-record the manual for 0.17.0, with albums and the new preset sheet

Every scene is recorded again on the 0.17.0 build, because the header
(Export to Exports), the sidebar (Albums) and the develop column had
all moved. The launch pictures showed the typed folder field, and the
export settings "Export to"; the presets picture predated the sections.

New scenes: presets_film scrolls the sheet down through the shipped
sections and applies Ilford HP5 Plus, a look that changes the film and
nothing else; albums exports four New York frames to an album, selects
it to show the originals behind its files, and opens a new album's
sheet before deleting what it made. record.sh now points the profile's
old export folder at DR_HOME/Exports, which the app turns into the
album "Exports" on first open - the one way to have an album without
the portal's dialogue, which Xvfb cannot show. The launch scene signs
out of a remembered folder instead of typing one, so it shows
"Open folder" beside the folder used last.

Not recorded: the server browser's New folder, which needs a Nextcloud
server, and the download screen, which a folder library never reaches
(the original is a local read, over before the first poll). The manual
says so where it describes each. film_reach and duplicates passed;
inference was pinned to the CPU.

docs/manual/README.md

@@ -17,16 +17,19 @@ DarkRoom opens on a library: a folder on this machine, a folder a sync
 client keeps, or a Nextcloud account. A folder needs no password and uploads
 nothing. `Choose folder…` opens your desktop's own folder dialogue, which can
 make a new folder too; the folder used last stays on the screen with
-`Open folder` beside it. On a Nextcloud account the library folder is chosen
-in a browser of the server, whose `New folder` makes one there.
+`Open folder` beside it, and `Choose another…` in place of `Choose folder…`.
+On a Nextcloud account the library folder is chosen in a browser of the
+server, whose `New folder` makes one there. (The browser is not pictured:
+these recordings have no server behind them. Nor is the folder dialogue,
+which is your desktop's rather than DarkRoom's.)
 
-![The launch screen: a server field, a folder field, and which formats to scan for](media/launch.png)
+![The launch screen: a Nextcloud server or an app password, or the folder used last with Open folder beside it](media/launch.png)
 
 Once a folder is named, it is the library — you are not asked for it again,
 and `Open library` opens it whole. `Subfolder…` narrows the scan to part of
 it. The formats ticked are what the scan looks for; RAW is on and JPEG off
 by default, because a RAW editor's sensible default is the file the camera
-wrote first.
+wrote first. `Change library`, at the foot of the sidebar, comes back here.
 
 ![A folder chosen: the library, whether to scan a subfolder, and the formats](media/launch-folder.png)
 
@@ -188,6 +191,15 @@ and the left arrow or `A` the one before; held down, they go on past the
 stretch the roll has loaded, through everything the grid would show. The
 edit on screen is saved on the way, so stepping along a shoot loses nothing.
 
+On a Nextcloud library a photograph may not be on this device yet. Its
+thumbnail from the grid stands in at once; if the original has to come down,
+the thumbnail dims under *Not on this device yet*, with how far the download
+has got — `Downloading — 12.4 of 38.0 MB` — and a bar, and the photograph
+opens when it lands. Step on before then and the one you step to is the one
+that opens: a download that arrives late is kept for later and never takes
+the place of the photograph whose name is showing. (Not pictured: a folder
+library, which these recordings use, never has a photograph to wait for.)
+
 ### White balance from the photograph
 
 Press `pick` in the White Balance group, then click something neutral —
@@ -262,7 +274,8 @@ black-and-white stocks at its end.
 
 Every change is a step; `Undo` and the History panel walk them. `Snapshot`
 keeps the current state under a name. `Presets…` saves the settings to
-apply elsewhere, and imports `.xmp` from other applications.
+apply elsewhere, and imports Lightroom presets — `Folder…` for a folder of
+them, `.xmp file…` for one.
 
 The sheet lists your own presets first, then the ones DarkRoom ships —
 Essentials, and colour, cinema and black-and-white film, one measured stock
@@ -270,9 +283,12 @@ each. A shipped preset is a look: it changes what it names and leaves the
 photograph's own corrections alone, as an imported Lightroom preset does.
 Saving under a shipped preset's name makes your version the one that name
 applies, marked *changed*; `Revert` brings the shipped one back, and renaming
-yours makes it one of your own.
+yours makes it one of your own. A film preset carries its stock: choosing one
+sets the `Film` chooser and leaves the rest of the edit where it was.
 
-![The presets sheet](media/presets.png)
+![The presets sheet: a name for the current edit, the shipped Essentials, importing, and what an apply carries](media/presets.png)
+
+![Scrolling down the shipped presets to the black-and-white films, applying Ilford HP5 Plus, then holding Before](media/presets-film.gif)
 
 ### Copying settings
 
@@ -314,16 +330,26 @@ in a browser that can make a folder as well as open one. Not inside the
 library — a JPEG exported there would come back from the next scan as a
 photograph of its own, and the browser says so rather than letting you.
 
+![A new album named, before its folder is chosen](media/album-sheet.png)
+
 The folder holds only the exported files. The album remembers which
 photograph each came from, so selecting it in the sidebar shows the
 originals behind its JPEGs — edit one and export it again. Albums reach your
 other devices as collections do; a folder on this device does not, so an
-album made on the desktop asks the tablet for a folder of its own. Deleting
-an album leaves its files where they are.
+album made on the desktop asks the tablet for a folder of its own.
+Right-click an album, double-click it or press the arrow on its row to
+rename it, give it another folder or delete it; deleting an album leaves
+its files where they are.
 
-An export with no album chosen is refused, and the header says so.
+![Four New York frames exported to an album, then the album chosen in the sidebar](media/albums.gif)
 
-![Export defaults in Settings](media/settings-export.png)
+![The album chosen: the four photographs behind its files](media/albums.png)
+
+An export with no album chosen is refused, and the header says so. With one
+chosen, the buttons name it: `Export to Exports` in develop, `Export 4 to
+Exports` on the selection bar.
+
+![Export defaults in Settings, ending with the album exports go to](media/settings-export.png)
 
 ## Settings
 

docs/manual/index.html

@@ -150,14 +150,17 @@ is only about what you see.</p>
 client keeps, or a Nextcloud account. A folder needs no password and uploads
 nothing. <code>Choose folder…</code> opens your desktop's own folder dialogue, which can
 make a new folder too; the folder used last stays on the screen with
-<code>Open folder</code> beside it. On a Nextcloud account the library folder is chosen
-in a browser of the server, whose <code>New folder</code> makes one there.</p>
-<figure><img loading="lazy" src="media/launch.png" alt="The launch screen: a server field, a folder field, and which formats to scan for"><figcaption>The launch screen: a server field, a folder field, and which formats to scan for</figcaption></figure>
+<code>Open folder</code> beside it, and <code>Choose another…</code> in place of <code>Choose folder…</code>.
+On a Nextcloud account the library folder is chosen in a browser of the
+server, whose <code>New folder</code> makes one there. (The browser is not pictured:
+these recordings have no server behind them. Nor is the folder dialogue,
+which is your desktop's rather than DarkRoom's.)</p>
+<figure><img loading="lazy" src="media/launch.png" alt="The launch screen: a Nextcloud server or an app password, or the folder used last with Open folder beside it"><figcaption>The launch screen: a Nextcloud server or an app password, or the folder used last with Open folder beside it</figcaption></figure>
 <p>Once a folder is named, it is the library — you are not asked for it again,
 and <code>Open library</code> opens it whole. <code>Subfolder…</code> narrows the scan to part of
 it. The formats ticked are what the scan looks for; RAW is on and JPEG off
 by default, because a RAW editor's sensible default is the file the camera
-wrote first.</p>
+wrote first. <code>Change library</code>, at the foot of the sidebar, comes back here.</p>
 <figure><img loading="lazy" src="media/launch-folder.png" alt="A folder chosen: the library, whether to scan a subfolder, and the formats"><figcaption>A folder chosen: the library, whether to scan a subfolder, and the formats</figcaption></figure>
 <h2 id="the-library">The library</h2>
 <figure><img loading="lazy" src="media/library.png" alt="The grid: collections on the left, the timeline beside it, the roll of thumbnails, and the filter bar above"><figcaption>The grid: collections on the left, the timeline beside it, the roll of thumbnails, and the filter bar above</figcaption></figure>
@@ -271,6 +274,14 @@ showing; click one to open it. The right arrow, <code>D</code> or space opens th
 and the left arrow or <code>A</code> the one before; held down, they go on past the
 stretch the roll has loaded, through everything the grid would show. The
 edit on screen is saved on the way, so stepping along a shoot loses nothing.</p>
+<p>On a Nextcloud library a photograph may not be on this device yet. Its
+thumbnail from the grid stands in at once; if the original has to come down,
+the thumbnail dims under <em>Not on this device yet</em>, with how far the download
+has got — <code>Downloading — 12.4 of 38.0 MB</code> — and a bar, and the photograph
+opens when it lands. Step on before then and the one you step to is the one
+that opens: a download that arrives late is kept for later and never takes
+the place of the photograph whose name is showing. (Not pictured: a folder
+library, which these recordings use, never has a photograph to wait for.)</p>
 <h3 id="white-balance-from-the-photograph">White balance from the photograph</h3>
 <p>Press <code>pick</code> in the White Balance group, then click something neutral —
 a white wall, a grey card, the air conditioner here. The picker sets the
@@ -320,15 +331,18 @@ black-and-white stocks at its end.</p>
 <h3 id="history-snapshots-presets">History, snapshots, presets</h3>
 <p>Every change is a step; <code>Undo</code> and the History panel walk them. <code>Snapshot</code>
 keeps the current state under a name. <code>Presets…</code> saves the settings to
-apply elsewhere, and imports <code>.xmp</code> from other applications.</p>
+apply elsewhere, and imports Lightroom presets — <code>Folder…</code> for a folder of
+them, <code>.xmp file…</code> for one.</p>
 <p>The sheet lists your own presets first, then the ones DarkRoom ships —
 Essentials, and colour, cinema and black-and-white film, one measured stock
 each. A shipped preset is a look: it changes what it names and leaves the
 photograph's own corrections alone, as an imported Lightroom preset does.
 Saving under a shipped preset's name makes your version the one that name
 applies, marked <em>changed</em>; <code>Revert</code> brings the shipped one back, and renaming
-yours makes it one of your own.</p>
-<figure><img loading="lazy" src="media/presets.png" alt="The presets sheet"><figcaption>The presets sheet</figcaption></figure>
+yours makes it one of your own. A film preset carries its stock: choosing one
+sets the <code>Film</code> chooser and leaves the rest of the edit where it was.</p>
+<figure><img loading="lazy" src="media/presets.png" alt="The presets sheet: a name for the current edit, the shipped Essentials, importing, and what an apply carries"><figcaption>The presets sheet: a name for the current edit, the shipped Essentials, importing, and what an apply carries</figcaption></figure>
+<figure><img loading="lazy" src="media/presets-film.gif" alt="Scrolling down the shipped presets to the black-and-white films, applying Ilford HP5 Plus, then holding Before"><figcaption>Scrolling down the shipped presets to the black-and-white films, applying Ilford HP5 Plus, then holding Before</figcaption></figure>
 <h3 id="copying-settings">Copying settings</h3>
 <p><code>Copy</code> in the top bar, or Ctrl+C, takes this photograph's settings; <code>Paste</code>,
 or Ctrl+V, puts them on another, and says what it would paste — how many
@@ -359,14 +373,20 @@ folder dialogue (on the tablet, Android's folder picker), or on the server,
 in a browser that can make a folder as well as open one. Not inside the
 library — a JPEG exported there would come back from the next scan as a
 photograph of its own, and the browser says so rather than letting you.</p>
+<figure><img loading="lazy" src="media/album-sheet.png" alt="A new album named, before its folder is chosen"><figcaption>A new album named, before its folder is chosen</figcaption></figure>
 <p>The folder holds only the exported files. The album remembers which
 photograph each came from, so selecting it in the sidebar shows the
 originals behind its JPEGs — edit one and export it again. Albums reach your
 other devices as collections do; a folder on this device does not, so an
-album made on the desktop asks the tablet for a folder of its own. Deleting
-an album leaves its files where they are.</p>
-<p>An export with no album chosen is refused, and the header says so.</p>
-<figure><img loading="lazy" src="media/settings-export.png" alt="Export defaults in Settings"><figcaption>Export defaults in Settings</figcaption></figure>
+album made on the desktop asks the tablet for a folder of its own.
+Right-click an album, double-click it or press the arrow on its row to
+rename it, give it another folder or delete it; deleting an album leaves
+its files where they are.</p>
+<figure><img loading="lazy" src="media/albums.gif" alt="Four New York frames exported to an album, then the album chosen in the sidebar"><figcaption>Four New York frames exported to an album, then the album chosen in the sidebar</figcaption></figure>
+<figure><img loading="lazy" src="media/albums.png" alt="The album chosen: the four photographs behind its files"><figcaption>The album chosen: the four photographs behind its files</figcaption></figure>
+<p>An export with no album chosen is refused, and the header says so. With one
+chosen, the buttons name it: <code>Export to Exports</code> in develop, <code>Export 4 to Exports</code> on the selection bar.</p>
+<figure><img loading="lazy" src="media/settings-export.png" alt="Export defaults in Settings, ending with the album exports go to"><figcaption>Export defaults in Settings, ending with the album exports go to</figcaption></figure>
 <h2 id="settings">Settings</h2>
 <figure><img loading="lazy" src="media/settings.png" alt="The settings page: background activity, indexing, storage, display"><figcaption>The settings page: background activity, indexing, storage, display</figcaption></figure>
 <p>Background activity with progress, thumbnail and face indexing, how many