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 often have the necessary dependencies installed for running BleachBit from source code.
On Debian and Ubuntu, install the
python-gtk2 package. On Fedora, CentOS, and Red Hat, install the
On Debian and Ubuntu, install these packages:
python3-gi. On Fedora, CentOS, and Red Hat, install
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.
Follow the installation steps in appveyor.yml.
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 these commands:
tar xvjf bleachbit-3.2.0.tar.bz2 cd bleachbit-0.3.2.0
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 clone the Git repository for the BleachBit application with this command:
git clone https://github.com/bleachbit/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
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 with BleachBit 3.x, run
python bleachbit.py. On Linux with BleachBit 4.x, run
On Windows, double 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