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.
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.
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 https://github.com/az0/bleachbit.git
Here is a full list of BleachBit Git repositories:
- BleachBit: main BleachBit application
- bleachbit-misc: supports development
- CleanerML: extra cleaners
- winapp2.ini: winapp2.ini cleaners database for Windows
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
bleachbit.py put the
bleachbit.mo file in a directory called
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:
git pull make -C po local