BleachBit Documentation

Main site | Download | Get Help | Edit this documentation

  • Home
  • Documentation
  • Install on Windows
  • Install on Linux
  • Winapp2.ini
  • Shred files and wipe disks
  • Command Line Interface
  • General Usage
  • Preferences
  • Chaff
  • Troubleshooting
  • Frequently Asked Questions
  • CleanerML
  • Introduction
  • Variables
  • Contributing
  • Developers
  • Testing
  • Audit
  • Running from source code

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

Linux systems often have the necessary dependencies installed for running BleachBit from source code.

BleachBit 3.x

On Debian and Ubuntu, install the python-gtk2 package. On Fedora, CentOS, and Red Hat, install the pygtk2 package.

BleachBit 4.x

On Debian and Ubuntu, install these packages: gir1.2-gtk-3.0, libgtk-3-0, and python3-gi. On Fedora, CentOS, and Red Hat, install gtk3, python3-chardet, and python3-gobject.

Microsoft Windows

On Microsoft Windows you must install several dependencies:

BleachBit 3.x

  • Python 2.7 32-bit
  • PyGTK all-in-one installer
  • Python for Windows Extensions

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

Alternatively, use gtk-download.sh and gtk-unpack.sh.

BleachBit 4.x

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.

Tarball

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.

Git

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

Building translations

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 .\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 with BleachBit 3.x, run python bleachbit.py. On Linux with BleachBit 4.x, run python3 bleachbit.py.

On Windows, double click on bleachbit.py.

Staying up to date with Git

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

git pull
make -C po local

Further reading

  • Testing
  • Contributing patches and bug reports