Running from source code

Running BleachBit from source code is intended for developers and testers: other users should install the prepared packages. Running BleachBit from source code is relatively easy because there is nothing to compile and installing BleachBit is not required.


Linux systems almost always have the necessary dependencies installed for running BleachBit from source code. On Debian and Ubuntu, you should have the python-gtk2 package. On Fedora, CentOS, and Red Hat you should have the pygtk2 package installed.

Microsoft Windows

On Microsoft Windows you must install several dependencies:

Python, GTK+, and all Python extensions should be 32-bit. Mixing 64-bit and 32-bit components will cause errors.

Alternatively, use and

Getting the source code

To get the source code, either download the latest tarball (.tar.bz2) or checkout the Git source repository from Git, which always contains the latest code.


On Linux unpack a tarball run this command:

tar xvjf bleachbit-0.7.1.tar.bz2
cd bleachbit-0.7.1

On Windows unpack the tarball with 7-Zip or similar application.


On Linux, install the Git client. On Debian and Ubuntu install it with this command:

sudo apt-get install git

Similarly on Fedora, Red Hat, and CentOS install the Git client with this command:

sudo yum install git-core

On Linux checkout the BleachBIt application Git repository (read only) with this command:

git clone

Here is a full list of BleachBit Git repositories:

Building translations

If English is not your native language, you must build the translations. On Linux, run:

make -C po local

At this time building translations is not supported on Windows, but you can copy the translations from another system or download them from Launchpad. Relative to put the file in a directory called .\locale\es\LC_MESSAGES\ (change es according to the language.)

Running from source

Now that the dependencies are installed, you are ready to run BleachBit. On Linux run:


On Windows, click on

Staying up to date with Git

The Git repository changes frequently. To download changes, run these commands on Linux:

git pull
make -C po local

Further reading