Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
git-cola: The highly caffeinated Git GUI
Python HTML Inno Setup Shell Makefile Batchfile Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
build
cola
debian
icons
po
scripts
styles
t
ui
.gitignore
COPYRIGHT
LICENSE
README
configure
wscript

README

git-cola: a highly caffeinated git gui

Cola is a sweet, carbonated git gui known for its
sugary flavour and caffeine-inspired features.


Copyright (C) 2008 David Aguilar and contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

REQUIREMENTS

Python 2.4 or newer
    http://python.org/

PyQt 4.3 or newer
    http://www.riverbankcomputing.co.uk/software/pyqt/intro

simplejson
    http://pypi.python.org/pypi/simplejson


ACKNOWLEDGEMENTS

git-cola includes a copy of the GitPython module:
    http://gitorious.org/projects/git-python/


INSTALLATION

Debian and RPM users can download freshly built binaries here:

    http://cola.tuxfamily.org/

    sudo dpkg -i cola_*.deb
    sudo rpm -ivh cola-*.rpm


If you downloaded a tarball, make sure /path/to/cola/bin is in your $PATH.


HOW TO RUN

Take your pick--any of the following incantations work from the command line:

    git cola
    git-cola
    cola

Launching cola on repositories outside your $CWD:

    git cola /repo/path-1 /repo/path-2 .. /repo/path-N


BUILDING FROM SOURCE

You will need the PyQt development tools (v4.3 or greater):

Synopsis:
    sudo apt-get install pyqt4-dev-tools
    git clone git://gitorious.org/git-cola/mainline.git cola
    cd cola
    ./configure --prefix=/usr
    make
    sudo make install


STYLESHEETS

    git cola ships with an alternative stylesheet called "dark".
    You can use this stylesheet by running:

        git cola --style=dark


    You can also skin git cola by providing your own Qt stylesheet:

        git cola --style=/path/to/my/style.qss


    An example stylesheet is provided in:

        $PREFIX/share/cola/styles/dark.qss


WINDOWS INSTALLATION

1) Install the native Python2.5 and PyQt4 installers (in that order):

    http://python.org/download/
    http://www.riverbankcomputing.co.uk/pyqt/download.php

3) Install msysgit:

    http://git.or.cz/gitwiki/WindowsInstall

4) Install the GnuWin32 'file' command:

    http://gnuwin32.sourceforge.net/packages/file.htm

    Add the installed directory (default: c:\GnuWin32\bin) to your path.

5) Install simplejson

    http://pypi.python.org/pypi/simplejson

6) Download cola:

    http://cola.tuxfamily.org/releases/

7) Install cola (from a Git Bash):

    cd /c/Python25/Lib/site-packages
    tar xvfz /path/to/cola-win32-*.tar.gz
    mv cola-win32-* cola

8) Create an executable in your path for bash, cmd.exe, or both:

    echo '/c/Python25/python.exe /c/Python25/Lib/site-packages/cola/bin/git-cola' >> /usr/bin/cola
    echo 'c:\\Python25\\python.exe c:\\Python25\\Lib\\site-packages\\bin\\git-cola' > /c/Windows/System32/cola.bat

This assumes the you have Python/PyQt4 installed in C:/Python25.
If this is not the case simply edit the commands accordingly.

voila, cola on Windows.


NOTE: Windows is not the developer's primary platform.
Patches are greatly appreciated.
Something went wrong with that request. Please try again.