===============================================================================
 PROCTORING CM FUS - version 0.1.2 - Linux 64 bits
 Fundacion Universitaria San Mateo
===============================================================================

Este archivo comprimido contiene el ejecutable nativo del software de
supervision de examenes. NO requiere instalacion: se descomprime y se ejecuta.


-------------------------------------------------------------------------------
 1. COMO EJECUTARLO
-------------------------------------------------------------------------------

  1) Descomprima este archivo en la carpeta que prefiera.
  2) Deje el ejecutable con permisos de ejecucion:

         chmod +x proctoring_cm_fus

  3) Ejecutelo:

         ./proctoring_cm_fus

  Si al hacer doble clic no ocurre nada, abra una terminal en esa carpeta y
  use el comando anterior: asi vera en pantalla cualquier mensaje de error.


-------------------------------------------------------------------------------
 2. DEPENDENCIAS NECESARIAS
-------------------------------------------------------------------------------

  El ejecutable nativo NO lleva las bibliotecas dentro: las toma del sistema.
  Necesita estas cuatro, que a su vez arrastran las demas:

    libwebkit2gtk-4.1-0   Motor web con el que se dibuja la interfaz.
                          Es la unica que no suele venir instalada de fabrica.

    libgtk-3-0            Sistema de ventanas.

    libasound2  (ALSA)    Captura del microfono.

    libv4l-0    (Video4Linux)
                          Captura de la camara web.


  --- Ubuntu, Debian, Linux Mint, Zorin ---

      sudo apt update
      sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 libasound2 libv4l-0

  --- Fedora, RHEL, Rocky, Alma ---

      sudo dnf install webkit2gtk4.1 gtk3 alsa-lib libv4l

  --- openSUSE ---

      sudo zypper install libwebkit2gtk-4_1-0 gtk3 alsa libv4l

  --- Arch, Manjaro, EndeavourOS ---

      sudo pacman -S webkit2gtk-4.1 gtk3 alsa-lib v4l-utils


  Para comprobar si le falta alguna, ejecute:

      ldd ./proctoring_cm_fus | grep "not found"

  Si ese comando no imprime nada, tiene todo lo necesario.


-------------------------------------------------------------------------------
 3. SI PREFIERE NO INSTALAR DEPENDENCIAS
-------------------------------------------------------------------------------

  Descargue el AppImage desde la misma pagina del curso. Lleva dentro el motor
  web y el sistema de ventanas, asi que funciona en casi cualquier distribucion
  sin instalar nada. Solo necesita permisos de ejecucion:

      chmod +x proctoring_cm_fus_0.1.2_amd64.AppImage
      ./proctoring_cm_fus_0.1.2_amd64.AppImage

  Aun asi, la camara y el microfono los toma del sistema, de modo que ALSA y
  Video4Linux deben estar presentes. En un escritorio Linux normal ya lo estan.

  En Ubuntu 22.04 y anteriores puede hacer falta FUSE para abrir AppImages:

      sudo apt install libfuse2


-------------------------------------------------------------------------------
 4. PERMISOS DEL EQUIPO
-------------------------------------------------------------------------------

  Segun lo que exija el examen, el software pedira acceso a:

    - Camara web        (/dev/video*)
    - Microfono
    - Captura de pantalla

  En escritorios con Wayland, la captura de pantalla se concede mediante el
  portal del sistema: aparecera una ventana pidiendo su autorizacion. Debe
  aceptarla, o el sistema de supervision quedara marcado como desconectado.


-------------------------------------------------------------------------------
 5. ANTES DEL EXAMEN
-------------------------------------------------------------------------------

  Practique en el curso de pruebas enlazado desde el bloque de proctoring.
  Compruebe alli que la camara, el microfono y la pantalla se detectan
  correctamente, para no encontrarse con sorpresas el dia del examen.

===============================================================================
