project:chorus set up

The key enabler of project:chorus is git, which is used most frequently in software engineering environments to track changes to source code.

The easiest (and most pleasant) Git client for Windows is TortoiseGit.

1. Install msysgit 1.6.1 or above
2. During the install it will give you 3 choices for “Adjusting your PATH environment” - choose “Run Git from the Windows Command Prompt” (middle one)
3. Install TortoiseGit
4. To download git repos from un-verified HTTPS servers, you should add a new environment variable: GIT_SSL_NO_VERIFY and set it's value to 1.

Install either the git package from your distribution or git from source, available here.

Covering the technical aspects of git is well beyond the scope of this document, to find out more regarding the internals of a git repository please see the main git site.

Each git repository contains one audacity project, which is composed of one XML file (filename.aup) which describes the project arrangement, and a directory (filename_data) which contains 1mb audio chunks. Only one audacity project file/data pair exist per git repository, so each audacity project is very self contained.

After the initial repository clone operation, minimal network transfer operation is required to synchronise changes, which may be synchronised between arbitrary parties, no central server required!

An excellent guides can be found here, or if you're coming from SVN, there's a crash course available here. More guides can be found linked off the git documentation page.

To get a copy of a project:

git clone <project address>

To update your repository, having already cloned it:

git pull

To make a branch in your repository and switch the working copy to that branch:

git checkout -b <branch name>

To save changes to your current working copy:

git commit -a -m "A message about what you're committing goes here"