Library & batch export

The Library tab lets you browse your collection of solved .art files and batch-export them for the companion viewer app. This page covers the folder tree, the export queue, targeting, formats, and resume behavior.

The folder tree

Open the Library tab and pick a library root — the top-level folder that holds your solved spots, typically organized as library/<pot-type>/<position-pair>/. The left pane shows a recursive folder tree rooted there.

Click a folder's checkbox to add it to the export queue. Click the folder name to select it and see its contents in the right pane. Use the Refresh tree button if you have added or removed .art files outside the app.

The export queue

Checked folders appear in the export queue at the bottom of the Library tab. The queue is persistent — it survives app restarts, just like the Jobs queue. You do not lose your selection if you close the app overnight.

Each row shows the folder path, a destination (where the exported files will go), and a count of pending spots. When Skip already exported is on (the default), the pending count reflects only the spots that have not been exported yet, not the entire folder.

Targeting destinations

You can set each row's destination individually with its Browse button. But for a large library, two bulk-targeting tools save time:

• Target pattern. Type a pattern like D:\export\{rel_path} in the TARGET PATTERN field and click Apply to all. The {rel_path} placeholder is replaced with each folder's path relative to the library root. Every row gets a destination in one click.

• Match folder. Click Match folder… and pick the parent of your export tree. For every queued folder whose library subfolder (e.g. 3bp/buvssb) already exists under that parent, the destination is auto-filled. Rows with no matching subfolder are left untouched. This is useful when you are adding new spots to an existing export tree.

Export formats

Pick a format from the EXPORT FORMAT dropdown before starting the batch:

The choice persists across restarts and applies to the next export batch.

Compression level

Exports use zstd compression. The default level is 3 (zstd's fast default). Higher levels (up to 22) produce smaller files at the cost of more CPU time during export. Decompression speed in the viewer is unaffected by the level — the viewer is fast regardless.

You can change the compression level in Settings.

Resume: skip already exported

The Skip already exported checkbox (on by default) makes batch exports resumable. If the app is closed mid-export, or you add new spots to a folder and re-run the batch, only the spots that have not been exported to the destination are processed. Already-exported spots are skipped.

Turn this off if you want to force a full re-export — for example, after changing the export format or compression level.

Running the export

Click Export to start. A progress card shows the current folder, the current spot, and a progress bar. You can cancel at any time; already-exported files are kept.

When the batch finishes, a summary chip shows how many spots succeeded and how many failed, with the total time.

Where to go next

• The run log — reviewing which boards solved and which failed.
• File formats — details on .art and .artgto files.
• Web viewer — using exported files in the companion app.