PDF de programación - Tutorial Zoneminder

7­TUTORIAL

A continuación vamos a describir el uso de este software, añadiremos algunos “trucos” que nos 
harán mas sencillo el manejo, la monitorización y la detección de errores y además describiremos 
en detalle cómo realizar las configuraciones más complejas. 

Necesitaremos en principio abrir tres ventanas de comandos para lo siguiente:

a)Para empezar a utilizar ZoneMinder es recomendable en primer lugar monitorizar los mensajes 

que ofrece la aplicación en tiempo de ejecución. Para ello en una ventana de terminal ejecutamos:

tail ­f /var/log/messages

En esta ventana se nos irá mostrando un registro de los mensajes generados por aplicación en 

tiempo real.

b)En segundo lugar es importante saber que en ocasiones nuestro PC puede ralentizarse debido a 
un mal funcionamiento de la aplicación Apache2. Si esto ocurriese debemos reiniciar Apache2 y 
buscar en el registro antes mencionado si el problema proviene de ZoneMinder. Para reiniciar 
Apache2 ejecutamos:

sudo /etc/init.d apache2 ­k restart

c)Por último para iniciar el servicio ZoneMinder propiamente dicho ejecutamos el script zmpkg:

sudo zmpkg.pl start

Una vez que el servicio está corriendo podemos acceder a la consola mediante un navegador 

tecleando en la barra de direcciones “http://127.0.0.1/zm” o  “http://localhost/zm” .

Lo   primero   que   se   presenta   es   la   vista   inicial   cuando   se   está   ejecutando   en   modo   non 
authenticated (por defecto). La autentificación es una opción que permite especificar para cada 
usuario que se registra en ZoneMinder los permisos para ejecutar ciertas tareas. Se recomienda la 
ejecución en modo “authenticated” si nuestro sistema está abierto a internet. Durante la instalación 
se crea un usuario con todos los privilegios cuyo login y password son “admin”. Se recomienda 
cambiar el password tan pronto como sea posible. Para crear usuarios accedemos al link “options” 
en   la   esquina   superior   derecha   y   en   la   pestaña   “system”   marcamos   la   casilla 
ZM_OPT_USE_AUTH.   A   continuación   podemos   añadir,   eliminar   y   establecer   permisos   de 
usuarios en la nueva pestaña “users” dentro de “options”.

La ventana de ZoneMinder ajustará su tamaño para no ser demasiado agresiva con el escritorio. 
En la parte superior podemos ver varias informaciones básicas como el momento de la última 
actualización   y   la   carga   del   servidor.   También   habrá   una   indicación   del   estado   del   sistema: 
“stopped” o “running”. 

Más   abajo   se   encuentran   varios   links   incluyendo   la   indiciación   del   usuario   actual   y   la 
configuración del ancho de banda. La configuración del ancho de banda permite optimizar los 
ajustes dependiendo de si estamos en local o remoto. Por ejemplo, si estamos trabajando en la 
misma máquina o subred del servidor seleccionaremos los ajustes para un gran ancho de banda, en 

una conexión ADSL elegiremos la opción intermedia y en una conexión de modem elegiremos bajo 
ancho de banda. 

La vista será similar a:

7.1)DEFINICIÓN DE MONITORES

Para utilizar ZoneMinder es necesario definir al menos un Monitor. Un Monitor es básicamente 
una   asociación   con   una   cámara   y   puede   realizar   comprobaciones   continuas   de   las   imágenes 
captadas por esa cámara, como por ejemplo la detección de movimiento. Para crear un Monitor 
hacemos click en “Add New Monitor”. 

Para ayudarnos a comenzar con la configuración de vídeo lo mejor es apoyarse en utilidades 
como “Camorama”(disponible desde Synaptics). De esta forma encontraremos la configuración de 
imágen adecuada para cada cámara. Hay que tener en cuenta que si una cámara funciona con un 
programa de visualización no significa necesariamente que funcione con ZoneMinder. Esto es 
debido a que los programas de visualización simplemente “mapean” la imágen de video hacia la 
pantalla   de   forma   transparente,   mientras   que   ZoneMinder   necesita   capturar   la   imágen   y 
normalmente tratarla.

Es posible validar las cámaras mediante el comando “zmu ­d <ruta del dispositivo> ­q ­v ­U 
<usuario> ­P <password>” (la ruta de las cámaras USB es normalmente /dev/video0,1,2,etc). De 
esta   forma   es   posible   además   obtener   valores   útiles  de   configuración   del   dispositivo   que   nos 
servirán para completar los campos del panel “Add New Monitor”. Si el comando zmu da un error 
lo más habitual es comprobar si poseemos todos los permisos, para esto ejecutamos “zmfix ­a”.

Existe   un   pequeño   conjunto   de   cámaras   que   ZoneMinder   soporta   de   forma   nativa,   su 
configuración puede establecerse mediante el link “Presets”. Estas configuraciones completarán 
todos los campos necesarios con los valores adecuados.

Las opciones están divididas en un conjunto etiquetas. No es necesario salvar los cambios de una 
etiqueta, sino que se pueden rellenar los campos de todas ellas y luego salvarlas como un conjunto. 
Las opciones de cada etiqueta se describen brevemente a continuación:

a)Etiqueta “General”:

Name:   el   nombre   del   Monitor   en   carácteres 

alfanuméricos y sin espacios.

Source   Type:   esta   variable   determina   si   la 
cámara está conectada en local, a un puerto USB de la 
máquina, si por el contrario es una cámara remota, o si 
es una fuente de imágen representada por un archivo. 
Seleccionar una opción   u otra afectará al conjunto de 
opciones que se mostrará en la siguiente etiqueta.

Fuction: esta variable define lo que el monitor 
“hace”   .   El   estado   puede   ser   uno   de   los   siguientes: 
None: el monitor está actualmente desactivado y no es 
posible visualizar vídeo ni generar eventos.

Monitor: el Monitor solo mostrará flujos de vídeo sin 

realizar un tratamiento de los mismos. 

Modect:   o   Motion   Detection.   Todas   las   imágenes 

capturadas serán analizadas y se generará un evento cuando se detecte movimiento.

Record: en este  caso se generan continuamente eventos de una longitud determinada.
Mocord: es un híbrido entre Modect y Record, y el resultado son eventos de longitud fija  con las 

zonas de detección de movimiento remarcadas dentro de esos eventos.

Nodect: O No Detection. Este es un modo especial diseñado para ser usado con eventos externos.

Enabled: indica si el monitor debe ser iniciado en modo activo o pasivo. Normalmente 
marcaremos esta opción salvo si queremos que la cámara sea avtivada o desactivada por acciones 
externas. SI no se activa el Monitor no generará ningún evento en respuesta a movimiento  u otros 
desencadenantes.

Linked   Monitors:   este   campo   nos   permite   seleccionar   otros   monitores   del   sistema   que 
actuaran como desencadenantes para activar este monitor. Por ejemplo, si tenemos varias cámaras 
supervisando una zona podemos hacer que todas empiecen a grabar si solo una de ellas detecta un 
movimeinto. Hay que tener mucho cuidado de no crear dpendencias circulares que nos llevarán a 
alarmas persistentes. 

Maximum FPS: en algunas ocasiones podemos tener cámaras capaces de altas tasas de 
captura, pero no normalmente no requeriremos tanto rendimiento para no sobrecargar el servidor. 
Esta opción nos permite limitar la máxima tasa de captura.

Alarm Maximum FPS: si hemos especificado un nivel máximo de framens por segundo, 
quizás deseamos que este nivel sea sobrepasado ante una alarma. Este valor nos permite definir el 
número de framens por segundo generados ante una alarma.

Reference Image Blend %ge: cada imágen analizada en ZoneMinder es una composición de 
las imágenes previas, normalmente formada aplicando la imágen actual con un cierto porcentaje de 
la imágen anterior de referencia.  Este valor alrededor de 10, nos permite definir el porcentaje de 
imágen de referencia que se aplicará a la imágen actual.

Triggers:   esta   sección   nos   permite   seleccionar   que   eventos   se   aplicarán   si   el   modo   de 
ejecución ha sido establecido “ Triggered”. El evento más común es el generado por el estándar x10.

b)Eiqueta “Source” (para dispositivos locales):

Device   Path/Channel:   especifica   la   ruta 
completa   donde   se   ubica   el   dispositivo,   por   ejemplo 
/dev/video0,  1,  2,  etc.  y  Channel   0  para  dispositivos 
USB.

Device   Format:   el   formato   del   streaming   de 
video. Los mas comunes son 0 para el sistema PAL y 1 
para el NTSC.

Capture Palette: indica la profundidad de color. 
Si tenemos dudas es interesante comenzar probando con 
escalas de grises , Grey, o color de 24 bits.

Capture Width/Height: especifica las dimensiones del streaming de video que generará la 

cámara.

Orientation: si por motivos de ubicación nuestra cámara se encuentra girada es posible 

“girar” el video para que la visualización sea correcta. 

c)Etiqueta “Timestamp”:

Timestamp Label Format: indica el formato de 
la etiqueta de tiempo, fecha y hora, que se superpone al 
video   generado.   Por   defecto   especifica   año/mes/dia 
hora/minuto/segundo   con   el   formato:   %%s   ­ 
%y/%m/%d %H:%M:%S .

Timestamp   Label   X/Y:   indican   la   posición   en 
coordenadas cartesianas dónde se ubicará la etiqueta. 
El punto 0,0 especifica la esquina superior izquierda de 
la pantalla.

d)Etiqueta “Buffers”:

Image Buffer Size: este es el tamaño del buffer 
de imágenes “muertas”, donde se guardan las últimas 
imágenes   captadas.   Son   imágenes   que   aún   están 
esperando   tratamiento.   Estas   imágenes   se   incluyen 
también como previas a la generación de una alarma, es 
decir, si se genera una alarma se presentan los frames 
que   generaron   la   alarma   y   también   algunas   capturas 
previas que se obtienen de este buffer.

Warm­up   Frames:   especifica   cuantos   frames 
procesará pero no examinará el demonio de análisis al 
inicio. Esto permite generar una referencia precisa antes 
de buscar cambios en los frames para detectar alarmas.

Pre/Post   Event   Image   Buffer:   indica   cuantos 
f