Settings

Settings is a window over the app with eight sections on the left: Assistant, Connection, Sync, Canvas, Appearance & Motion, Shortcuts, Privacy and About. "Changes take effect when you press “Save settings”."

<!-- picture: the Settings window on the Assistant section -->

How to open it

  • The gear at the right end of the toolbar.
  • File ▸ Settings… or Ctrl+,.
  • Assistant ▸ Assistant settings… opens it on Assistant; Sync ▸ Sync settings… on Sync.
  • Buttons in messages, such as Open connection settings, open it on the right section.

How saving works

  1. Change what you need, in one section or in several. Nothing applies yet: the window holds a draft.
  2. Press Save settings at the bottom. The line at the bottom left says "Settings saved."
  3. Cancel, Escape or a click outside closes the window. If you changed something, the app asks: "Close without saving? The changes made in Settings since the last save will be lost." Close without saving or Keep editing.

Some things apply at once, without Save:

  • the language (the window switches at once; Save remembers it);
  • automatic sync and its interval in the sync popover;
  • a key or token you paste: it is checked and used at once;
  • Forget all keys and tokens and Clear chat history.

The line at the bottom

"Settings loaded.", "Default settings, not saved yet.", "Settings are not saved yet.", "Nothing to save: nothing has changed yet.", "Fix the highlighted fields first." (a field is marked red, for example "The ComfyUI address is not an address yet. Fix it in Connection; the field is marked."), "Settings could not be saved.", "Stored settings could not be read; default settings are shown."

Rules for every field

  • A field cannot hold a key or a password: "Settings cannot hold a key or a password. Remove it from the field." Keys go into their own key fields, which keep them outside the settings file.
  • The window can be made larger by its bottom right corner.

The sections

See also

This page is imported from the application repository's wiki (docs/wiki/interface/Settings.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.