Files & Library

One .mage file holds your project. A folder of them is your library.

The .mage file#

Your whole project in one file: canvases, layers, brushes, imported images and audio. Copy it, move it, email it. Nothing else to keep track of.

Video files are the exception. They stay where they are on disk. Keep them next to the project.

A new document is ready to paint on before you save. Magerie backs up every 30 seconds, and after a crash the next launch offers your latest work back.

A saved file opens where you left it: inside the subgraph you were in, each level at the spot and zoom you left it. If that subgraph is gone, it opens on the deepest level that is still there. A new board, or a file from an older version of Magerie, opens on the Main Board with the whole board in view. Panning, zooming, and stepping in and out of subgraphs don't count as changes, so they never ask you to save.

Your library#

A folder of .mage files. Brushes, images, and subgraphs in them show up in every project when their export badge is on.

  • macOS: ~/.magerie/user-library/
  • Windows: %USERPROFILE%\.magerie\user-library\

Turn on the export badge of what you want to keep, then Save As the document into that folder. Or drop .mage files in. Rename or delete the files to curate. Open User Library... in the title bar's ⋮ menu opens one to edit, and makes the folder if it is missing.

Use an item#

Open the Omni menu (Tab) and press Tab again for its Library tab. What is already in this document, your library, and the Magerie Library that ships with the app. Click to bring one in:

  • Brush: lands as a Brush node with its textures. Turn on its export badge to paint with it from the picker.
  • Image: lands as an Image node.
  • Subgraph: lands as its own copy.

Items are copied into the document, so the file stays self-contained.

The Magerie Library#

Ships with the app: ten brushes, Pencil to Chalk, already in your brush picker. Read-only: bring one in, change it, save the result into your own library.

Where to next#