Skyperious

Installation

Download and launch the latest setup.

• install Python
• install pip if not installed
• run pip install skyperious
• run skyperious

• install Homebrew
• install Python: open a terminal and run brew install python
• install wxPython: run brew install wxpython
  (or use a suitable binary from wxpython.org/download.php)
• run sudo easy_install pip
• run pip install skyperious
• run skyperious

• install Snap if not installed: sudo apt-get install snap
• install Skyperious from the Snap Store, or run snap install skyperious
• launch Skyperious from OS menu, or run skyperious

The graphical interface needs wxPython, best installed with one of the prepared Python wheels available at https://extras.wxpython.org/wxPython4/extras/linux.

E.g. installing Skyperious for Ubuntu 20.04:

• run sudo apt-get install libgtk-3-0 libsdl2-2.0 libsm6 libwebkit2gtk-4.0-37 libxtst6python3 python3-pip
• run pip install wxPython --find-links https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-20.04
• run pip install skyperious
• run skyperious

Another option is to have wxPython built locally, e.g. for Ubuntu 20.04:

• run sudo apt-get install build-essential libgtk-3-dev libsdl2-dev libwebkit2gtk-4.0-dev python3 python3-pip
• run pip install skyperious
• run skyperious

If pip scripts-folder is not yet in path, run before reopening terminal:

echo "export PATH=\$PATH:\$HOME/.local/bin" >> $HOME/.profile

If wxPython installation fails, consult https://wxpython.org/pages/downloads/.

Note for pip installation from 2025 March

SkPy dependency needs to be from the special Teams migration branch:
pip install git+https://github.com/Terrance/SkPy@teams-migration

The program itself is stand-alone, can work from any directory, and does not need additional installation, Windows installers have been provided for convenience. The installed program can be copied to a USB stick and used elsewhere, same goes for the source code. The command line interface only needs Python to run.

If running from source code, Skyperious needs Python 3.5+ or Python 2.7.

The graphical user interface needs wxPython 4.0+.

If wxPython is not available, the command line interface will function regardless.
If other Python libraries are not available, the program will function regardless, only with lesser service - like lacking Excel export or full search syntax.

To run from source if Python, pip and git are installed:

git clone https://github.com/suurjaak/Skyperious
cd Skyperious
pip install -r requirements.txt
./skyperious.sh
# or: cd src && python -m skyperious
        

Pre-requisites:

• Docker

wget https://raw.githubusercontent.com/suurjaak/Skyperious/master/build/Dockerfile
docker build . -t skyperious

xhost +
docker run -it --rm --net=host --mount src=/,target=/mnt/host,type=bind -e \
DISPLAY -v /tmp/.X11-unix/:/tmp/.X11-unix/ skyperious
        

docker build . -t skyperious will prepare an Ubuntu 20.04 Docker image and install Skyperious and its dependencies within the container.

xhost + will allow the container to access the X Window System display.

Add sudo before docker commands if current user does not have rights for Docker.

Add --mount src="path to host directory",target=/etc/skyperious after docker run to retain Skyperious configuration in a host directory between runs.

Host filesystem is made available under /mnt/host.

Initial Docker support provided by Atila Romero.