Krita VCS

Documentation

New to Krita VCS? Start here. Every chapter below covers a different part of the app: installing and saving your first version, a reference for each feature, the guardrails that keep your work safe, and the optional Krita plugin.

Read the docs on GitHub (opens in a new tab)

Using each feature

  • Changes Where you save. Write a note, hit Commit. Locks briefly while saving so nothing gets interrupted.

  • History Every version you've saved. Click one to see what changed.

  • Branches Separate lines of work. Click one to switch to it. Hover for Merge into current (bring it into what you're on now) or Delete. New branch starts a fresh line, optionally starting from another one.

  • Comparing versions Side-by-side or a swipe slider, with zoom and pan that stay in sync between both sides. The eye icon highlights exactly what changed — a precise outline of the changed pixels, or a simpler box around the changed area. Click a layer to see its details.

  • Undo The ⋯ menu next to Changes or History. Removes only your most recent save; those changes come back as unsaved work, ready to save again.

  • Restore Pick any older version and bring its files back, saved as a brand-new version. Nothing older is ever deleted.

  • Settings (gear icon) Artist view, title bar style, your name, and 8 color themes. Per project: how much space preview images may use, a compact storage option that shrinks history for files with lots of small edits, a low-memory option that uses less memory (a little slower in exchange), and Clean up storage.

  • Clean up storage Shows you exactly how much space would be freed before you confirm anything. Only ever clears old, unreachable leftovers — never your current work or anything still visible in your history.