DEV IN PROGRESS

Manual installation

Requirements

To build Chrysalide from scratch, the following tools are needed:

  • autoconf, autoconf-archive, automake, bison, flex, gettext, libtool, git: compilation tools;
  • libgtk-3-dev: GUI;
  • libxml2-dev, libsqlite3-dev: configuration storage;
  • python3-dev, python3-gi, python-gi-dev: Python bindings;
  • libarchive-dev: access to compressed files contents;
  • libssl-dev: secured communications and crypto stuff;
  • libyaml-dev: YAML data parsing;
  • libmagic-dev (optional): content type recognition;
  • libcurl4-openssl-dev: network request.

On systems running Debian, you can simply execute:

apt-get install autoconf autoconf-archive automake bison flex gettext libtool git libgtk-3-dev libxml2-dev python3-dev python3-gi python-gi-dev libarchive-dev libsqlite3-dev libssl-dev libyaml-dev libmagic-dev libcurl4-openssl-dev

Getting the source code

To grab the source code, you can check out the repository using Git over HTTP:

git clone http://git.0xdeadc0de.fr/chrysalide.git

Setup the configuration

Simply run the convenient autogen.sh script:

cd chrysalide
./autogen.sh

Then define the way the program will be built:

./configure --prefix=/usr/local --enable-silent-rules

You can also choose to install Chrysalide into an easy-to-clean directory:

./configure --prefix=/tmp/RemoveMeLater --enable-silent-rules

In that case, you have to either:

  • add /tmp/RemoveMeLater/lib into /etc/ld.so.conf to tell the system where the libraries can be located.
  • or export LD_LIBRARY_PATH=/tmp/RemoveMeLater/lib in your terminal before launching Chrysalide.

Final steps

Build the program:

make

Install it, as root if needed:

make install

Without exporting LD_LIBRARY_PATH, the system cache of directories in which to search for libraries needs to be updated (as root):

ldconfig

Particularities for the debug mode

Requirements

In addition to the basic items, the following pieces of software get mandatory:

  • python3-dbg
  • python3-gi-dbg

The relative Debian command used to install them is:

apt-get install python3-dbg python3-gi-dbg

In order to enjoy beautiful traces, it is a good idea to install GTK symbols, too:

apt-get install libgtk-3-0-dbg

Configuration

It is the same as the basic configuration, except for the end:

./configure --prefix=/usr/local --enable-silent-rules --enable-debug