Skip to content

Installation

fbarre96 edited this page Apr 23, 2024 · 7 revisions

Quick Install using the script

git clone https://github.com/fbarre96/PollenisatorGUI
cd PollenisatorGUI
./install.sh

Manual installation

Package required

Ubuntu
sudo apt-get install git python3-pil python3-pil.imagetk python3-tk python3-venv tk-dev tmux xterm xdotool x11-xserver-utils pipx
Archlinux
pacman -S python tk git tmux xterm xdotool xorg-xrandr python-pipx
Additional optional packages

Docker can be installed to fire-up a scan worker. Otherwise, your computer can be used if you have pentest tools installed (additional configuration may be required).

REQUIRED : Tkinter

By default, tkinter is shipped with python and integrated. It is sometime not the case though and you should in this case install it manually

Specific case of Exegol containers : On exegol, the tkinter module is not compiled within the pyvenvs used. To recompile the pyvenv of your choice with the tkinter option, use this command :

PYTHON_CONFIGURE_OPTS="--enable-shared --with-tcltk-includes=/usr/include/tcl --with-tcltk-libs=\"/usr/lib/tcl8.6 /usr/lib/tk8.6\"" pyenv install --verbose "<PYTHON_VERSION desired>"

REQUIRED : X11

By default, an X11 server is running on most linux distribs. If you are running on MacOs, you may have to install xquartz.

Package Installation

pipx install pollenisator-gui

Check if you have a warning message saying that pip default install forder is out of your PATH.

If it is the case do one of these:

  • change install folder with pip install -t '/PATH/TO/PACKAGES/' .
  • add the install folder to your PATH
  • create a symlink/shortcut

Once in your PATH, execute it:

pollenisator-gui

Troubleshoot

_tkinter.TclError: no display name and no $DISPLAY environment variable

If you are on a native UNIX-like systme, try: export DISPLAY=:0.0

pollenisator-gui command not found

pipx ensurepath then log out and relog in

ModuleNotFoundError: _tkinter

Your python does not come with tcl/tk, reinstall it with tcl/tk. If you use pyenv, you can do it with the command below :

PYTHON_CONFIGURE_OPTS="--enable-shared --with-tcltk-includes=/usr/include/tcl --with-tcltk-libs=\"/usr/lib/tcl8.6 /usr/lib/tk8.6\"" pyenv install --verbose "<PYTHON_VERSION desired>"

_tkinter.TclError: couldn't connect to display ":0.0"

This happen if the X11 display server is not available, either because you are running a docker with no X11 sharing, or because you do not have a X11 server at all.

This often happen in MacOS -> Exegol/docker installation because MacOS does not come with a X11 server by default. Install XQuartz if that is your case and check how to share the X11 server with your docker if the problem persists.