To run gPodder from its Git repository, you have to check out a working copy from the repository. You can then use bin/gpodder -v in the source checkout to run the latest development version of gPodder.
This is current as of April 2013.
This is the development branch for 3.x releases. This is where stable updates to gPodder happen. Feature development happens in the "cuatro" branch instead. This branch supports Desktop Gtk+ and Harmattan via the QML UI.
This is the customization branch for 3.x releases on MeeGo 1.2 (Harmattan, N950 and N9). This branch contains Debian packaging information and customizations to the QML UI (using Qt Quick Components for MeeGo) that can't be included in the tres branch.
This experimental branch will at some point become gPodder 4. It is the current feature development branch. It has been branched off the gPodder master branch on 2013-04-23 - expect some radical clean-ups in this branch until the release.
This is the branch for old 2.x releases. No features are developed, although patches, bug reports and translations are still accepted. This branch supports Maemo 4, Maemo 5 and Desktop Gtk+ UIs and a simple command-line interface.
This is the customization branch for 2.x releases on Maemo 5 (Fremantle, N900). This branch contains Debian packaging information and Maemo-specific customizations that can't be included in the master branch.
This is the customization branch for 2.x releases on Maemo 4 (Diablo, N800/N810). This branch contains Debian packaging information and Maemo-specific customizations that can't be included in the master branch.
This section should document the pattern for tagging specific releases and versions of gPodder. Also, non-recurrent tags should be described here.
Upstream releases of gPodder are tagged with the "gpodder-" prefix, followed by the version number.
Packages for Maemo 4 are tagged using this pattern, where "Z" is the Debian revision number of the package (usually 1).
Packages for Maemo 5 are tagged using this pattern, where "Z" is the Debian revision number of the package (usually 1).
Packages for MeeGo 1.2 Harmattan are tagged using this pattern.
This is the HEAD of the orphaned customization branch to make gPodder 0.16.1 compatible with Maemo 5 before the gPodder 2.0 release. This is superseded by the "maemo-5" branch.
This tag points to the last version of gPodder that does not depend on the mygpoclient library. This tag will be removed in the future.
This tag points to the last revision of gPodder that has been maintained in the old Subversion repository, before we converted the repository to a Git repository.
This is a very old, orphaned branch from September 2006 for experimenting with creating a "core" gpodder module. You should never need to checkout this branch, except if you are a historian or have too much time.
This is a very old, orphaned branch from June 2006 that included some code for detecting a connected iPod via D-Bus and starting synchronization when the device has been connected. This probably does not work anymore on modern Linux Desktops.
To get gPodder-Git working, you need to install Git. In Debian and Ubuntu, you can install this by running (as root or with sudo):
apt-get install git
For other distributions, the package should be named in a similar way.
You will also need to install the dependencies listed on this page to get gPodder running.
As of March 2010, the required (hard) dependencies for the Gtk+ UI can be installed with:
apt-get install python-gtk2 python-feedparser python-mygpoclient
git clone git://github.com/gpodder/gpodder.git
Every now and then, changes will be committed into the repository. You can update you local working copy to the latest revision by running git pull in your working copy.
Alright, so you have a Git working copy checked out as described above and made some changes. Entering git status should give you a list of files that have changed or that Git doesn't yet know about. If you have added/removed a file, use git add/rm path/to/file.py to add/remove the file. Then, run git status again and see if everything is included. make clean can help you to get rid of temporary files.
If you think you have added all necessary files, enter git diff --color to get a list of changes. You can create a patch file after commit:
git format-patch origin/master
You can review this file with a text editor of your choice, and if you like the changes, send it to the mailing list. If the file is bigger than 10kB, please "gzip" it first.
If the file is too big, the mailing list software will complain and your message will not be posted to the list. If your patch is not trivial, and might need discussion, it would be a good idea to file the patch as a bug report on our bug tracker. You can then send a mail to the mailing list containing a link to the bug page. You can (and should) attach your patch to the bug. Thanks!
If you don't plan to send back patches, but you want to test the latest version, run these commands in a terminal window:
$ wget -q -O- 'https://github.com/gpodder/gpodder/tarball/master' | tar xz $ cd gpodder $ make test | tee gpodder.log
This way you don't need to install Git (you still need to install the dependencies listed above, though).