Difference between revisions of "How to export download and view events"

From ZoneMinder Wiki
Jump to navigationJump to search
 
m
Line 10: Line 10:
This is the easiest way to view events if you want to check all events in the hour/day/week/month or all events for a certain particular camera.  
This is the easiest way to view events if you want to check all events in the hour/day/week/month or all events for a certain particular camera.  
===Steps===
===Steps===
[[image:zm_home.png|none|thumb|caption|ZoneMinder homepage]]
[[image:zm_home.png|right|thumb|caption|ZoneMinder homepage]]
# Login to zoneminder as a user who has export rights
# Login to zoneminder as a user who has export rights
# From the home page you should see a table with columns labeling camera name events per hour/day/week/month/all. The very bottom column of this table totals the events accross all cameras for the given hour/day etc. Click on the total events under the hour row to continue.
# From the home page you should see a table with columns labeling camera name events per hour/day/week/month/all. The very bottom column of this table totals the events accross all cameras for the given hour/day etc. Click on the total events under the hour row to continue.
[[image:eventsview.png|none|thumb|caption|Events view allows you to select which events to export]]
[[image:eventsview.png|right|thumb|caption|Events view allows you to select which events to export]]
# You should now be on the event view page. This pages purpose is too list the events selected by your query method. From this view we are provided with many statistics about individual events. We may choose to review the events from this page by clicking on the name of the event, however for the purpose of this howto we will simply choose to export all events by selecting the checkbox in the top right cell. After selecting all the events from this view we open up the export dialog by clicking the EXPORT button located in the bottom right corner.
# You should now be on the event view page. This pages purpose is too list the events selected by your query method. From this view we are provided with many statistics about individual events. We may choose to review the events from this page by clicking on the name of the event, however for the purpose of this howto we will simply choose to export all events by selecting the checkbox in the top right cell. After selecting all the events from this view we open up the export dialog by clicking the EXPORT button located in the bottom right corner.
# This export options dialog that pops up allows us to select the file type that is exported. Before clicking the export button you must first make sure too check the following settings:
# This export options dialog that pops up allows us to select the file type that is exported. Before clicking the export button you must first make sure too check the following settings:
Line 19: Line 19:
##Export Frame Details
##Export Frame Details
##Export File Format: Zip
##Export File Format: Zip
[[image:zmexport.png|none|thumb|caption|Typical Export form settings]]
[[image:zmexport.png|right|thumb|caption|Typical Export form settings]]
# Once you click the export button zoneminder will go through the process of packaging and formatting the events for you, this process can be quite intensive for the server if a large number of events are selected. When the process is completed a download link for a file called zmExport.zip should pop up, select save file and click ok. It is important to make a note of where you save your file as you will need to access it later.
# Once you click the export button zoneminder will go through the process of packaging and formatting the events for you, this process can be quite intensive for the server if a large number of events are selected. When the process is completed a download link for a file called zmExport.zip should pop up, select save file and click ok. It is important to make a note of where you save your file as you will need to access it later.


Line 32: Line 32:
## Your second filter should be ''and'' - ''Weekday'' - ''equal to'' - ''monday''
## Your second filter should be ''and'' - ''Weekday'' - ''equal to'' - ''monday''
# To save this event filter method click on the save button. Make sure to write in a descriptive name for the filter.
# To save this event filter method click on the save button. Make sure to write in a descriptive name for the filter.
[[image:alarmfiltersave.png|none|thumb|caption|Events Filter save form box]]
[[image:alarmfiltersave.png|right|thumb|caption|Events Filter save form box]]
# Executing the event filter after you have saved it is as simple as clicking execute at the bottom of the page.
# Executing the event filter after you have saved it is as simple as clicking execute at the bottom of the page.
# You should now be on the event view page. This pages purpose is too list the events selected by your query method. From this view we are provided with many statistics about individual events. We may choose to review the events from this page by clicking on the name of the event, however for the purpose of this howto we will simply choose to export all events by selecting the checkbox in the top right cell. After selecting all the events from this view we open up the export dialog by clicking the EXPORT button located in the bottom right corner.
# You should now be on the event view page. This pages purpose is too list the events selected by your query method. From this view we are provided with many statistics about individual events. We may choose to review the events from this page by clicking on the name of the event, however for the purpose of this howto we will simply choose to export all events by selecting the checkbox in the top right cell. After selecting all the events from this view we open up the export dialog by clicking the EXPORT button located in the bottom right corner.
Line 61: Line 61:
Most operating systems have many diffrent applications that allow you to extract zoneminder.zip packages. For this example i will show you one way to do this.
Most operating systems have many diffrent applications that allow you to extract zoneminder.zip packages. For this example i will show you one way to do this.
===Linux===
===Linux===
[[image:archiveopen.png|none|thumb|caption|Ready to extract the events folder for viewing]]
[[image:archiveopen.png|right|thumb|caption|Ready to extract the events folder for viewing]]
#Navigate to the folder where zmexport.zip was downloaded to. In this example i have 4 zmexport.zip files extracted to the folder
#Navigate to the folder where zmexport.zip was downloaded to. In this example i have 4 zmexport.zip files extracted to the folder
#Double click opening up the archive manager
#Double click opening up the archive manager

Revision as of 18:30, 11 October 2010

Prerequisites

To export, download and view the events from zone minder there are 3 prerequisites. A note about this how to

  1. Access to your zone minder website.
  2. An application to unpackage the export files.
    • For linux most distros include an application like unzip or untar.
    • For Windows an excellent open source alternative to the default archive manager is 7-Zip

Export Methods

There are three ways to export events from zoneminder, depending on the event you are looking for one of these methods is generally much faster at finding the content. In these examples we will extract all the events in the last hour from all cameras.

Front end interface method

This is the easiest way to view events if you want to check all events in the hour/day/week/month or all events for a certain particular camera.

Steps

ZoneMinder homepage
  1. Login to zoneminder as a user who has export rights
  2. From the home page you should see a table with columns labeling camera name events per hour/day/week/month/all. The very bottom column of this table totals the events accross all cameras for the given hour/day etc. Click on the total events under the hour row to continue.
Events view allows you to select which events to export
  1. You should now be on the event view page. This pages purpose is too list the events selected by your query method. From this view we are provided with many statistics about individual events. We may choose to review the events from this page by clicking on the name of the event, however for the purpose of this howto we will simply choose to export all events by selecting the checkbox in the top right cell. After selecting all the events from this view we open up the export dialog by clicking the EXPORT button located in the bottom right corner.
  2. This export options dialog that pops up allows us to select the file type that is exported. Before clicking the export button you must first make sure too check the following settings:
    1. Export Event Details
    2. Export Frame Details
    3. Export File Format: Zip
Typical Export form settings
  1. Once you click the export button zoneminder will go through the process of packaging and formatting the events for you, this process can be quite intensive for the server if a large number of events are selected. When the process is completed a download link for a file called zmExport.zip should pop up, select save file and click ok. It is important to make a note of where you save your file as you will need to access it later.

Event Filter

Events Filter form

The filter method of exporting events gives the user the most detail and controll in the event query. As this method allows you to make very refined queries it does add zome complexity to the process. To illustrate the power of this export method I will show you how Event Filter can create a custom query that is saved for future use, this custom query will select all events that have had more than 50 alarm frames on Mondays.

Steps

  1. On the bottom left side of your Zone Minder homepage there should be a button labled "Filter"
  2. The form section under the use filter select box is the area where we will define steps the event filter evaluates. To add the second step for the event filter simply click the + button on the bottom left of the fieldset.
    1. The first filter should be Alarm Frames - greater than - 50
    2. Your second filter should be and - Weekday - equal to - monday
  3. To save this event filter method click on the save button. Make sure to write in a descriptive name for the filter.
Events Filter save form box
  1. Executing the event filter after you have saved it is as simple as clicking execute at the bottom of the page.
  2. You should now be on the event view page. This pages purpose is too list the events selected by your query method. From this view we are provided with many statistics about individual events. We may choose to review the events from this page by clicking on the name of the event, however for the purpose of this howto we will simply choose to export all events by selecting the checkbox in the top right cell. After selecting all the events from this view we open up the export dialog by clicking the EXPORT button located in the bottom right corner.
  3. This export options dialog that pops up allows us to select the file type that is exported. Before clicking the export button you must first make sure too check the following settings:
    1. Export Event Details
    2. Export Frame Details
    3. Export File Format: Zip
  4. Once you click the export button zoneminder will go through the process of packaging and formatting the events for you, this process can be quite intensive for the server if a large number of events are selected. When the process is completed a download link for a file called zmExport.zip should pop up, select save file and click ok. It is important to make a note of where you save your file as you will need to access it later.

Individual camera export

Individual camera view allows you to select specific events
From the individual event view exporting is as simple as clicking export (top left)

This export Method is the simpilest way to check and export an individual event that has happend recently on a specific monitor

Steps

  1. From your Zone Minder homepage open the individual view of a specific camera
  2. On the "watch" view of a monitor the recent events should be listed by date under the live stream. Click on an event from this list to view the individual event.
  3. On the individual event view page you should get a stream of the event. To export this event simply click the Export link located at the top of the page.
  4. This export options dialog that pops up allows us to select the file type that is exported. Before clicking the export button you must first make sure too check the following settings:
    1. Export Event Details
    2. Export Frame Details
    3. Export File Format: Zip
  5. Once you click the export button zoneminder will go through the process of packaging and formatting the events for you, this process can be quite intensive for the server if a large number of events are selected. When the process is completed a download link for a file called zmExport.zip should pop up, select save file and click ok. It is important to make a note of where you save your file as you will need to access it later.

Extracting Events

A note about this section of the howto, For the examples i am using a custom export_functions.php plugin that comes nativein stagecoach wireless zoneminder installs. Once you have selected your desired set of events you need a logical way to organise them and store them on your computer. My suggestion is too unzip all Zone Minder exports to a specific folder so you have them all in one place to easily browse and backup.

How to unpackage the export files

Most operating systems have many diffrent applications that allow you to extract zoneminder.zip packages. For this example i will show you one way to do this.

Linux

Ready to extract the events folder for viewing
  1. Navigate to the folder where zmexport.zip was downloaded to. In this example i have 4 zmexport.zip files extracted to the folder
  2. Double click opening up the archive manager
  3. Drag the events folder from the archive manager window into another folder. For ease of use i suggest you make a seperate folder to store all your ZM export events in.

Windows

  1. Navigate to the folder where zmexport.zip was downloaded to. In this example i have 4 zmexport.zip files extracted to the folder
  2. Rightclick the filename and select openwith 7-zip, winrar or winzip.
  3. When your archiving software is loaded up you should be able to select the events folder from zmexpor.zip and drag it to your desired location in the filestructure.

Viewing Extracted Events

zmEventImagesMaster.html has a timestamp identifier so you can extract multiple events to one folder and still organise them by date

To view the events you have just extracted simply browse to the events folder. To view the interface of all events open up the newest zmEventImagesMaster file in firefox. From this page you get a tabbed view showing you events organised by monitor and chronological order. Within each events view you can display individual frames from the event or meta data about the event date/time/length