Installation troubleshooting - eliranwong/UniqueBible GitHub Wiki
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:
-
source venv/bin/activate
-
pip install -r requirements.txt
-
pip list
Make sure the items in requirements.txt are in the pip list.
- 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