Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

An elegant and modern git repository viewer

branch: master
README.md

GitList: an elegant and modern git repository viewer

Build Status

GitList is an elegant and modern web interface for interacting with multiple git repositories. It allows you to browse repositories using your favorite browser, viewing files under different revisions, commit history, diffs. It also generates RSS feeds for each repository, allowing you to stay up-to-date with the latest changes anytime, anywhere. GitList was written in PHP, on top of the Silex microframework and powered by the Twig template engine. This means that GitList is easy to install and easy to customize. Also, the GitList gorgeous interface was made possible due to Bootstrap.

Features

  • Multiple repository support
  • Multiple branch support
  • Multiple tag support
  • Commit history, blame, diff
  • RSS feeds
  • Syntax highlighting
  • Repository statistics

Screenshots

GitList Screenshot GitList Screenshot GitList Screenshot GitList Screenshot GitList Screenshot

You can also see a live demo here.

Authors and contributors

License

New BSD license

Todo

  • improve the current test code coverage
  • test the interface
  • error handling can be greatly improved during parsing
  • submodule support
  • multilanguage support

Requirements

In order to run GitList on your server, you'll need:

  • git 1.7.6 or higher
  • Apache and mod_rewrite enabled
  • PHP 5.3.3

Installing

Download the GitList latest package and decompress to your /var/www/gitlist folder, or anywhere else you want to place GitList. You can also clone the repository:

git clone https://github.com/klaussilveira/gitlist.git /var/www/gitlist

Rename the config.ini-example file to config.ini. Now open up the config.ini and configure your installation. You'll have to provide where your repositories are located and the base GitList URL (in our case, http://localhost/gitlist). Now, let's create the cache folder and give the correct permissions:

cd /var/www/gitlist
mkdir cache
chmod 777 cache

That's it, installation complete! If you're having problems, check this tutorial by Kulbir Saini or the Troubleshooting page.

Further information

If you want to know more about customizing GitList, check the Customization page on the wiki. Also, if you're having problems with GitList, check the Troubleshooting page. Don't forget to report issues and suggest new features! :)

Something went wrong with that request. Please try again.