git-annex/doc/tips/visualizing_repositories_with_gource.mdwn
Joey Hess e213ef310f git-annex (5.20140717) unstable; urgency=high
* Fix minor FD leak in journal code. Closes: #754608
  * direct: Fix handling of case where a work tree subdirectory cannot
    be written to due to permissions.
  * migrate: Avoid re-checksumming when migrating from hashE to hash backend.
  * uninit: Avoid failing final removal in some direct mode repositories
    due to file modes.
  * S3: Deal with AWS ACL configurations that do not allow creating or
    checking the location of a bucket, but only reading and writing content to
    it.
  * resolvemerge: New plumbing command that runs the automatic merge conflict
    resolver.
  * Deal with change in git 2.0 that made indirect mode merge conflict
    resolution leave behind old files.
  * sync: Fix git sync with local git remotes even when they don't have an
    annex.uuid set. (The assistant already did so.)
  * Set gcrypt-publish-participants when setting up a gcrypt repository,
    to avoid unncessary passphrase prompts.
    This is a security/usability tradeoff. To avoid exposing the gpg key
    ids who can decrypt the repository, users can unset
    gcrypt-publish-participants.
  * Install nautilus hooks even when ~/.local/share/nautilus/ does not yet
    exist, since it is not automatically created for Gnome 3 users.
  * Windows: Move .vbs files out of git\bin, to avoid that being in the
    PATH, which caused some weird breakage. (Thanks, divB)
  * Windows: Fix locking issue that prevented the webapp starting
    (since 5.20140707).

# imported from the archive
2014-07-17 11:27:25 -04:00

22 lines
962 B
Markdown

[Gource](http://code.google.com/p/gource/) is an amazing animated
visualisation of a git repository.
Normally, gource shows files being added, removed, and changed in
the repository, and the user(s) making the changes. Of course it can be
used in this way in a repository using git-annex too; just run `gource`.
The other way to use gource with git-annex is to visualise the movement of
annexed file contents between repositories. In this view, the "users" are
repositories, and they move around the file contents that are being added
or removed from them with git-annex.
[[!img screenshot.jpg]]
To use gource this way, first go into the directory you want to visualize,
and use `git annex log` to make an input file for `gource`:
git annex log --gource | tee gource.log
sort gource.log | gource --log-format custom -
The `git annex log` can take a while, to speed it up you can use something
like `--after "4 months ago"` to limit how far back it goes.