This extension is not distributed with Mercurial.

Author: Klaus Koch





snap is a Mercurial extension for storing (big) file snapshots outside a Mercurial repository.

This is useful for files which are either too big, or do not change in small enough deltas to be stored in a source revision system like Mercurial. They would increase the repository size, memory consumption, and run-time.

Read the documentation on the wiki (mirror) and use

$ hg help snap

to get further information.

The snap extension requires at least Mercurial 1.6, or TortoiseHG 1.1.4.


Configure your .hgrc to enable the extension by adding following lines:

You enable snap like any other Mercurial extension, simply add


You may also have interest in LargefilesExtension and BigfilesExtension.

About the fork

Since Klaus never responded to patches, I created a fork to update the extension for newer Mercuruial/TortoiseHG versions. Along the way, I squashed some bugs, and added a hook that checks that the right files have indeed been snapped (useful for centralized repository).


SnapExtension (last edited 2013-09-03 03:52:25 by KevinBot)