Skip to content

Installation troubleshooting

Jump to bottom
Oliver Tseng edited this page Nov 20, 2022 · 5 revisions

General troubleshooting

Required feature 'xxxx' is not enabled. Install either 'PySide2' or 'PyQt5' first!

Try to manually install all the required packages to see what is the problem:

  1. source venv/bin/activate

  2. pip install -r requirements.txt

  3. pip list

Make sure the items in requirements.txt are in the pip list.

  1. Test if package can be loaded manually
$ python
Python 3.9.5
[GCC 8.3.1 20191121 (Red Hat 8.3.1-5)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from qtpy import QtGui
>>> from PySide2.QtWidgets import QApplication
>>> from PyQt5 import QtGui

After running 'python3 uba.py', it keeps saying to install gdown (or another package)

Your venv directory could be corrupted. Delete your venv directory and restart python uba.py to redownload the packages into your venv directory.

If that doesn't work, try installing the package in the global python (not the virtual). Then touch use_system_site_packages in the UBA root directory to force UBA to not use the virtual env.

CentOS troubleshooting tips

If you get the message, "ImportError: libGL.so.1: cannot open shared object file: No such file or directory"

Run yum install mesa-libGL

Debian troubleshooting tips

If you get the message, Required feature 'xxxx' is not enabled. Install either 'PySide2' or 'PyQt5' first!

Try the following:

# Need to install pip3
sudo apt-get install python3-venv python3-pip
pip3 install --upgrade pip

# Install pyqtwebengine
sudo apt-get install python3-pyqt5.qtwebengine
pip3 install pyqtwebengine

# Enable QT debugging and start up UBA to see what the error is
export QT_DEBUG_PLUGINS=1
python3 main.py

# If libxcb-util.so.1 is not found, create a symlink from libxcb-util.so.0
sudo ln -fs /usr/lib/x86_64-linux-gnu/libxcb-util.so.0 /usr/lib/x86_64-linux-gnu/libxcb-util.so.1

Troubleshooting installation on Ubuntu

If you encountered running UBA with the following message:

''' This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, wayland-xcomposite-glx, webgl, xcb. '''

Run the following line to install a Qt platform plugin:

sudo apt install qt5dxcb-plugin

Troubleshooting installation on Pop!_OS

This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Run sudo apt-get install libxcb-xinerama0

Extra information on Chrome OS

You may find extra information from our instructions on installing UBA on Chrome OS:

https://github.com/eliranwong/UniqueBible/wiki/Install-on-Chrome-OS

Clone this wiki locally