User Library

Reusable brushes, images, and subgraphs across every project.

User library panel

Reusable assets that live outside any single document and show up in every project. Three asset types: brushes, images, subgraphs.

Items appear in the Omni menu's Assets tab (Cmd/Ctrl + P), the brush picker, and other pickers as those land.

Where It Lives#

~/.magerie/user-library/ on macOS and Linux, <homeDir>\.magerie\user-library\ on Windows. Each item is a .mage file. Curation is file-level for now.

To add a brush, image, or subgraph: drop a .mage containing it into that folder, or Save As a document into it.

Using#

In the Omni menu's Assets tab, click an item to insert it:

  • Brush clones into the document and switches the active preset
  • Image drops as a node and references the library asset until embedded on save
  • Subgraph drops as an instanceOf reference

Library items show with a U badge. MAL items show with an L badge. The brush picker also marks MAL items with a thin gold border.

MAL: Magerie Asset Library#

Curated brushes, images, and subgraphs ship with Magerie at assets/mal/library.mage. Read-only. Drop one into a document, edit, save the result back into your library if you want to keep it.

Library vs Embedded#

Library files live at the OS user level. When you save a document that uses library assets, Magerie scrubs cross-library references so the .mage stays portable. Brushes get cloned into the document on use; images stay as userLib: references until you embed them. See File Format.

Coming#

In-app Add to Library action, Save Current to Library in pickers, tags and search, and additional asset types (gradients, patterns, palettes).

Next#

  • AI & Chat: community chat and AI image generation