- Installing and upgrading
-
- Installation overview
- General installation requirements
- Upgrading
- Installing on Ubuntu Linux
- Installing on Windows Server
- Installing on macOS
- Installing on CentOS Linux
- Installing on SuSE
- Configuring php.ini
- Configuring Apache
- Configuring the database
- OpenOffice / LibreOffice
- OpenCV (facial recognition)
- Alternative installation
- Upgrading PHP versions
- Setting up scheduled tasks/cron
- Backups
- User management
- Advanced user group options
- Customising ResourceSpace
- Plugins
- StaticSync
- Configuring ResourceSpace
-
- The config file
- E-commerce
- E-commerce and PayPal
- Offline job queues
- File integrity checking
- ResourceSpace file storage (filestore)
- Checksums
- Edit access for contributors
- Configuring Leaflet Maps
- Create Alternative Video Files
- Signing all database PHP code
- Integrating with Uppy Companion
- The System Configuration Page
OpenCV (facial recognition)
OpenCV is the library ResourceSpace uses for facial recognition capability. You can install OpenCV from the system's repository (how to install on Ubuntu):
sudo apt install python3-opencv # You may also need to install separately (for virtual environments or because they're missing) the following: pip install -U opencv-python opencv-contrib-python numpy matplotlib
Advanced
To install OpenCV from source, on either Linux or Windows please check OpenCV's documentation.
Version requirements
- Python - 3.9.6
- OpenCV - 4.5.5
Check Python and OpenCV versions
To check Python version, type the following in your terminal:
python --version
To check what OpenCV you have installed run the following Python command:
python -c "import cv2; print(cv2.__version__)"
Configure facial recognition feature in ResourceSpace
All the configuration mentioned below should happen in config.php
- Set path to Python (adjust accordingly to your setup - be it system wide or Python virtual environment)
- Set the field used to store the name of the person suggested/ detected (MUST be a dynamic keyword list)
- Set the location for the face recogniser model state(s) and data
- Enable facial recognition
$python_path = '/usr/bin'; $facial_recognition = true; $facial_recognition_tag_field = 20; $facial_recognition_face_recognizer_models_location = '/var/faceRecogniserData';
Configure trainer to run on a regular basis
Create a cron job (Linux) or a new scheduled task (Windows) and make sure to run /path to ResourceSpace web root/pages/tools/facial_recognition_trainer.php.