Settings: Sync

"The library comes from ComfyUI directly or through optional read-only MCP tools. Auto-sync and the interval apply at once; the rest saves with Save settings." This section shows how the last sync went, runs one now, sets automatic sync, and says how model files are read.

What it shows

The state and a summary: "Up to date · Node types: 812, packs: 41, models: 331 (120 with metadata). Last sync: 14:05." Warnings of the last sync, a paused reading ("Metadata reading is paused at 120 / 331. It continues with the next sync, or press Sync now.") and the last error.

Fields and buttons

FieldDefaultWhat it does
Sync automaticallyoffReads ComfyUI again on a timer. It works with the ComfyUI address or with an MCP server. Without an address: "Automatic sync can be switched on once the ComfyUI address is set in Connection." If the last sync did not finish, automatic sync waits until you press Sync now.
Interval, minutes30From 5 minutes to a day. A number out of range is corrected: "The interval must be from 5 minutes to a day, so it is now 5 min."
Sync nowReads ComfyUI now.
Pause metadata readingAppears while model files are read.
Read model metadata fromLoader folders (checkpoints, LoRAs, VAE…)or All model folders
Models per batch50 (10 to 1000)Metadata is read in batches of this size, one after another, until every file is read.
Pause between batches, ms1500 (0 to 10 000)Gives the MCP server and ComfyUI a breather. It does not stop the reading.

Read straight from ComfyUI, the app gets the header metadata of model files (title, trigger phrase, base model) but no description files next to them and no fingerprints; an MCP server that reads files adds those.

A line at the bottom says the fixed timeout: one MCP call may take up to 60 s; after 5 failed metadata reads in a row the reading waits for the next sync, and each failed file is tried again after 1 h, 6 h, then 24 h.

Automatic sync and its interval also live in the sync indicator popover, where they apply at once. Here they apply with Save settings.

See also

This page is imported from the application repository's wiki (docs/wiki/interface/Settings-Sync.md, revision b8e3f71). The same guide is built into the app: Help ▸ User guide.

To refresh it, run npm run import and then npm run build in the website folder.