⚠️ Este programa requiere Lua, por lo que se recomienda su instalación en sistemas Unix. El programa está construido para Raspberry Pi OS 32 bit "Buster".

Descargar la imagen de Raspberry desde este enlace

En entornos de desarrollo es recomendado crear previamente un entorno virtual (opcional):

python3 -m venv escan_env --system-site-packages
source escan_env/bin/activate

Para instalar esta versión en desarrollo, simplemente clonar este repo:

git clone https://github.com/neogranadina/neo_escan.git

Ir al directorio del repositorio:

cd neo_escan

Posteriormente ejecutar install_escan.sh para instalar todas las dependencias necesarias. Puede ser necesario cambiar los permisos para la instalación:

chmod +x install_escan.sh
./install_escan.sh

⚠️ Se reiniciará el sistema después de ejecutar el script.

Lanzar la aplicación con

python main.py

Es posible contribuir a este proyecto proponiendo commits directamente a este repositorio.

Realizar estas modificaciones solamente al archivo main.ui. Se recomienda hacerlas desde 'Qt Designer', 'Qt Creator' o 'Qt Design Studio' para Qt5. No se planea una actualización a Qt6 hasta que exista una versión estable de PySide6 compatible con Raspberry OS.

Es posible crear el objeto Ui_MainWindow directamente con PySide2, para ello simplemente correr el siguiente comando después de hacer los cambios en main.ui:

pyside2-uic main.ui > ui_main.py

⚠️ En Windows es posible que lance un error "ValueError: source code string cannot contain null bytes". Puede consultar una posible solución al error en https://es.stackoverflow.com/a/322753

Imágenes e íconos se vinculan desde el objeto resources_rc.py. Para proponer cambios añadirlos al archivo resources.qrc y realizar la conversión a binarios con pyside2-rcc resources.qrc -o resources_rc.py.

Mejoras al comportamiento de la aplicación deberán proponerse para el archivo main.py. Propuestas para mejorar la interconectividad con la base de datos, pueden hacerse al archivo db.py.

La conexión con las cámaras se realiza mediante la librería chdkptp.py. La versión que usa este aplicativo es https://github.com/jairomelo/chdkptp.py. Las mejoras deben ser propuestas directamente a ese repositorio.

👉 Para otro tipo de modificación o resolución de problemas particulares, crear un issue.

Algunos problemas identificados pueden consultarse en la Wiki del proyecto.

Icons made by Freepik and Pixel perfect from www.flaticon.com