Library

Note on naming: these docs call this your Library — your own private collection of saved setups. The app currently labels this drawer "Gallery"; that label is being updated to match. Nothing below changes once that happens, just the word on screen.

Your Library is where saved setups live. It's private and on-device — nothing here is shared or visible to anyone else. Think of it less like a folder of finished videos and more like a sketchbook: each saved item remembers every control's exact setting, not just what it looked like, so you can reopen it and keep adjusting from exactly where you left off.

Saving

Hit Save in the Library drawer to add your current setup as a new item. It captures:

• Every control's value — Sequence, Timing, Playback, Time shift, Grid, and Colors — as one bundle.
• A thumbnail: a still image of whatever frame happened to be showing on screen at the moment you saved (its "resting" look in the list).

Saving doesn't erase or lock your current setup in the sidebar — you keep working, and the saved copy stays put as its own separate item.

Naming

New items get an automatically generated, plain-English name (built from little building blocks — the shape, the motion, the palette, the pace — so it's actually descriptive rather than a generic "Setup 4"). You don't have to keep it:

• Click the name to type your own.
• Shuffle rerolls a fresh suggested name if you'd rather try another auto-generated one than write your own.

Browsing

Each row in the Library shows a still thumbnail at rest — the frame it was saved on. Hover over a row and it plays the full animation cycle right there in the list, using the exact playback settings (loop/ping-pong, holds, and all) that were saved with it — so what you see on hover is a true preview, not an approximation.

Deleting

Remove an item from the Library when you don't want it anymore. This only removes it from your local collection — it doesn't affect anything you've already exported from it.

Sharing and backing up

Every Library item can be exported to, or imported from, a .blit file — a small text file containing that same bundle of settings (see Exporting). This is how you:

• Back up a setup outside the app.
• Share a setup with someone else who has Blitter — sending them the file recreates your exact setup on their end, not just a picture of it.
• Reopen something later, even in a newer version of the app: if a future version doesn't recognize some value in an older file (because something about that control changed), it just skips that one value and keeps everything else — you'll see a heads-up, not a failure.