{
  "$type": "site.standard.document",
  "path": "/gource-visualize-a-repositories-commits/",
  "publishedAt": "2016-11-03T20:31:08.000Z",
  "site": "at://did:plc:6gssgguzeecdttuw4gpdshg2/site.standard.publication/self",
  "tags": [
    "coding",
    "git",
    "gource"
  ],
  "textContent": "[Image: Screen-Shot-2016-11-03-at-3.40.04-PM.png]\n\nWho doesn't love interesting data visualizations? One of the neatest looking ones is visualizing commits to a git repository. Gource is my go-to tool to create these types of visualizations.\n\nHere is a step by step on how to generate a video on MacOS.\n\nSetup\n\nFirst, you'll need to install gource and ffmpeg. I use brew as my package manager. Installing gource and ffmpeg is as simple as:\n\n[Code block]\n\nThis might take a long time depending on what other packages you have installed.\n\nUsing Gource\n\nGource is very simple to use. Just type gource in the root of any git project.\n\nThere are also a ton of options you can enable and disable. I recommend setting a better resolution, disabling the bloom effect and hiding filenames. The bloom effect is horrible when you create a video. It gets very pixelated when the video is compressed.\n\nYou also might want to tweak seconds-per-day and auto-skip-seconds depending on how old the repo is.\n\nMaking a video\n\nYou can just pipe the output from gource into ffmpeg by doing:\n\n[Code block]\n\nHere is one of the main repositories I committed to from 2007 - 2016. I used these settings to highlight my name and make it go a bit faster.\n\n[Code block]\n\n[Embedded video]\n\nIs it just me or is everything a bit more dramatic when you set it to a classical waltz?\n\nRead the original post with all embeds and interactive content at https://rants.broonix.ca/gource-visualize-a-repositories-commits/",
  "title": "Gource: Visualize a Repositories Commits"
}