Krita VCS

The Krita VCS plugin (aka Krita VC)

A small Version Control panel that lives right inside Krita, so you can save a version, set work aside, or switch branches without ever leaving your canvas. It runs on the exact same engine and the exact same history as the desktop app. Save from either one, and the other sees it.

Download the plugin
Krita plugin

If something goes wrong

Most issues come down to a file landing in the wrong place, or Krita not knowing where to find the kvc tool.

  • "Version Control" isn't in the Dockers menu. The plugin didn't load. Recheck the install steps, and confirm both kritavc.desktop and the kritavc folder landed directly inside pykrita, not one level up or down.

  • "That isn't the kvc tool" after Locate kvc…. Point it at the kvc (or kvc.exe) file itself, not the folder, and make sure it's the one from the zip you downloaded.

  • "Krita VC tracks .kra documents." The active document is a .png/.jpg/etc. Only .kra files are versioned. Save it as .kra inside the tracked folder first.

  • "repository is busy (locked by another process)." The desktop app is mid-write, or a previous save didn't exit cleanly and left a lock file behind. Safe to delete by hand as long as nothing else is actually writing at the moment.

  • "Save (Ctrl+S) or undo your changes in … first." A discard/set-aside/switch would overwrite a file with unsaved edits. You shouldn't normally see this, since opening the panel's menu already saves everything on the way in. If you do, your last autosave failed (see the next entry).

  • "Couldn't save …" Krita couldn't write the file, usually because it's read-only, the disk is full, or something else has it open elsewhere. Fix the file and click the refresh button to retry.