Installation¶

Bokken installation should be quite straightforward, let's see how to install Bokken and its dependencies before start using it.

Platforms¶

Bokken has been developed and tested on Linux and Windows, and the instructions below focus on those platforms but it has been also installed on OSX and the requirements are the same.

If you have a Debian derivative (Debian, Ubuntu, etc.) you can use the private repo and all the needed packages! Everything is explained in the Debian installation page.

Requirements¶

Bokken requirements are just a few and easy to install; in order to get Bokken working you will need:

• Backend can be one or both of:
  • A working copy of Pyew on your prefered platform.
  • Radare2 and its python bindings installed for your platform.
  • For Debian-based systems, just run:
    

    sudo apt-get install pyew python-radare
    

• Python: Bokken and Pyew can run with Python 2.6 but it's recommended to use Python 2.7:
  • Get the installer for Windows from here
  • For Debian-based platforms just use this command:
    

    sudo apt-get install python
    

• The latest version of Graphviz:
  • For Debian based platforms install with this command:
    

    sudo apt-get install graphviz
    

  • For Windows download and install the last stable release from:
    http://www.graphviz.org/Download_windows.php

• An updated version of PyGtk installed:
  • For Debian-based platforms just use this command:
    

    sudo apt-get install python-gtk2
    

  • For Windows it's better to just download and install the all-in-one package that fits your python version (pygtk-all-in-one-2.24.0.win32-py2.X.msi):
    http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.24/

• Finally GtkSourceview2 must be installed:
  • For Debian/Ubuntu platforms use this command:
    

    sudo apt-get install python-gtksourceview2
    

  • Windows users must select to install PyGtkSourceView2 during PyGtk installation.

Optional requirements¶

To get all the features offered by Bokken you can also install the following optional requirements:

• TidyLib is used by Bokken to parse and format HTML code when working with URLs.
  • Install it on Debian/Ubuntu Linux with the following command:
    sudo apt-get install python-utidylib
  • Windows users can download the installer from TidyLib site: http://utidylib.berlios.de/

• Psyco is a Python extension module which can greatly speed up the execution of any Python code.
  • As always, Debian/Ubuntu Linux users can install this package with this command:
    sudo apt-get install python-psyco
  • Windows users must download and install the latest version from Psyco site: http://psyco.sourceforge.net/psycoguide/binaries.html

Bokken install¶

Once the requirements are installed, getting Bokken working is pretty easy; just download the package and uncompress it. In order to use pyew as backend you will have to extract or move the pyew files to the bokken directory; no additional steps are needed to use radare2 backend.

Now it's time to see how to launch bokken!