Jump to >

This documentation covers RBTools 0.5. You can see the latest RBTools documentation or all other versions.

RBTools Documentation

RBTools is a set of client tools to use with Review Board.

Using RBTools


The recommended command-line interface is the rbt tool. This tool runs on Windows, Linux, and MacOS X, and allows executing a number of useful sub-commands. rbt has the following usage:

$ rbt [--version] <command> [options] [<args>]

The rbt command obsoletes the old post-review command. For built in help you may execute:

$ rbt help


post-review is an older tool which is now deprecated. See post-review for more information.


Before installing RBTools, you will need to have both Python and setuptools installed.

We require Python 2.4 or higher. We recommend installing Python 2.7. The 3.x releases will not work.

Installing Python


Python 2.x should come with your distribution. If not, or if 2.x isn’t installed, you will need to install the appropriate package. Please refer to your package manager for the appropriate version.


You can install Python by running the latest Python 2.7 Installer for Windows. We recommend the 32-bit MSI installer, as setuptools is not packaged for 64-bit.

Installing setuptools


To install setuptools on Debian, Ubuntu, or another Debian-based distribution, type:

$ apt-get install python-setuptools

To install on Fedora 8 and above, type:

$ yum install -y python-setuptools-devel.noarch

To install on a RedHat Enterprise, CentOS, Fedora 7 and earlier, or another RedHat-based distribution, type:

$ yum install python-setuptools

Users of other distributions should check with their distribution for native packages, or follow the setuptools installation instructions.

If the version of setuptools available for your distribution is older than 0.6c9, you’ll need to install it first, and then upgrade it to the latest version by running:

$ easy_install -U setuptools


You’ll then need to run the latest Python setuptools Installer (look toward the bottom of the page for the file listing).

Once Python and setuptools are installed, you may need to add a couple directories to your system path.

  1. Open Start ‣ Control Panel and navigate to the System icon.
  2. Click on the Advanced tab.
  3. Click Environment Variables.
  4. Find PATH in System variables and click Edit.
  5. Add ;C:\Python27;C:\Python27\Scripts (substitute your Python directory if it’s not C:\Python27) to the end of the list.

Installing RBTools

Once Python and Setuptools are installed, you can install RBTools just by typing:

$ easy_install -U RBTools

Indices, glossary and tables