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
      
  • 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.

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!

gtksourceview_windows.PNG (26.7 KB) Hugo Teso Torío, 28/06/2011 11:52

bokken-kanji.png (4.57 KB) Hugo Teso Torío, 30/06/2011 08:26