This article lays out all of the information needed to begin hacking on the belnet project.

Install a nodeEdit

Unlike most programs where the developer produces source code and then publishes a compiled version to users, there is no distiction between source / distribution in belnet. So, if you want the source code and development environment, all you have to do is install the server and php files like you would normally do to install a node. Has instructions on how to do this.

Git Version ControlEdit

If you don't already know, version control is kind of like automated backup (OSX's Time Machine), but for programmers. Version control is also designed to allow multiple users to work collaboratively on the same code at the same time. We are using a version control sceme called Git.

Git is nice because it allows each user to have thier own personal repository. This means you always have access to every piece of code you ever wrote and committed. Git also connects your personal repository with a global repository so that you can collaborate with others. 


We are hosting our global repository on github. Before you can set up git, you should choose a development environment. You will also need to get in contact with for the github password.

Development EnvironmentEdit

Before you proceed, it is probably a good idea to install git itself unless you already have it.

Eclipse is the development environment of choice, it is what the Beloit CS program uses, and it is free and relatively easy to install.

If you don't already have Eclipse, head over to for a free download. After you install it, you will need 2 extensions: PDT, the php eclipse extension, and EGit, the Git Team provider. They can be installed through "Install New Software" under the help menu in eclipse. Just select the site for your version of eclipse and filter for PDT, install those, then filter for EGit and install them as well.

Setting up Git inside eclipse might not be trivial, but there are tutorials online. Contact if you are trying to set up git inside eclipse.

Alternatively, you can use your own text editor and a git GUI. On mac, Gitbox is a good option. On windows, try Github for Windows or Git Extensions.

Check out the structural overviewEdit

Here it is: Structural Overview.

Check out the bug trackerEdit

Here it is: Bug Tracker.