Git Source Code Repository
Deluge's source code is always available through our Git repository.
To get a copy of the code, you will need to clone it from the repository then see the Installation Guide.
For more in-depth git usage see GitTips.
This guide uses commands which are meant to be typed at a command prompt, but most will be available from a GUI Git client.
There are multiple branches or tags that you can choose from which contain different stages of the Deluge code.
Note that we are currently transitioning to a different git workflow with the development of 1.4 so picking the correct branch is crucial.
The current branches (at time of writing) are:
- This is the release branch for the 1.3-series and, until 1.4 release, is the recommended stable code. This branch is only for critical bug fixes and no new feature will appear in this branch.
- This branch is in limbo until 1.4 release This branch contains development code that is now continued in develop. When the develop code is considered stable, 1.4 will be released and the code will be merged back into master code. This mean going forward from 1.4 release this branch will be considered to be the most stable code, replacing the use of *-stable branches.
- All development work will be put into this branch and should be considered unstable with risk of data loss and potential incompatibility with other Deluge versions.
- A branch for porting the WebUI code from Ext JS 3.4 to Ext JS 4, still requiring a lot of development work.
The first step is to clone our git repos:
git clone git://deluge-torrent.org/deluge.git
This will create a deluge directory with a copy of the repo so if you change into this directory you can start using git commands.
List the branches, including remote branches:
git branch -a
If you want to use a different branch than the default selected (master) then you will need to create a local copy of the remote branch. In this example we create branch '1.3-stable' as a local copy of the remote branch 'origin/1.3-stable' and switch to it:
git checkout -b 1.3-stable origin/1.3-stable
To switch between your local branches use the following commands:
Development:git checkout develop
Stable:git checkout 1.3-stable
Show current Branch
Either of these commands will show the current branch you are using:
git branch git status
You only need to do a clone once, after that you can simply update the branch by pulling changes from the repo.
Assuming you are in the folder you cloned to:
Now your tree is synchronized to the latest revision in our repository!