GitList: an elegant and modern git repository viewer
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
You can also see a live demo here.
Authors and contributors
- Klaus Silveira (Creator, developer)
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
- 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! :)