NAME

       onvif-gui - query and adjust onvif compatible cameras

SYNOPSIS

         onvif-gui

DESCRIPTION

       GUI  program  to view and set parameters on onvif compatible IP cameras. Double clidcking the camera name
       in the list will display the camera video output.

       Camera parameters are available on the tabs on the lower right side of the application. Once a  parameter
       has been changed, the Apply button will be enabled, which can be used to commit the change to the camera.
       It may be necessary to re-start the video output stream in order to see the changes.

       Video:

               Resolution  - The drop down bos is used to select the setting.
               Frame Rate  - The number of frames per second in the video output.
               Gov Length  - This is the distance between key frames in the stream.
               Bitrate     - The maxmimum number of bits per second to transmit.

       Image:

               All values are set using the sliders

               Brightness
               Saturation
               Contrast
               Sharpness

       Network:

               If the DHCP is enabled, all fields are set by the server, if DHCP is disabled,
               other network settings may be completed manually.

               IP Address
               Subnet Mask
               Gateway
               Primary DNS

       PTZ:

               Settings pertain to preset selections or current camera position.  The arrow keys,
               Zoom In and Zoom out control the position and zoom.

               The numbered buttons on the left correspond to preset positions.  The blank text
               box may be used to address presets numbered higher than 5.

               To set a preset, position the camera, then check Set Preset, then click the numbered
               preset button.

       Admin:

               Camera Name  - Sets the application display name of the camera based on the camera mfgr and serial number.
               Set admin Password - Can be used to change the password for the camera.
               Sync Time - Will reset the camera's current time without regard to time zone.
               Browser - Will launch a browser session with the camera for advanced maintenance.
               Enable Reboot - Will enable the reboot button for use.
               Enable Reset - Will enable the reset button for use.  Use with caution, all camera settings will be reset.

       Config:

               Auto Discovery - When checked, the application will automatcally start discovery upon launch.
               Multi Broadcast - When checked will repeat the broadcast message a number of times.
               Common Username - Default username used during discover.
               Common Password - Default password used during discover.

EXAMPLES

       To change the video resolution of a camera output, Double cick on the camera name in the list. The camera
       video  output  should  display  in  the  viewer.  Select the Video tab and use the drop down box labelled
       Resolution. Upon changing the selection, the Apply button will be enabled. Click the apply button to make
       the change. The stream will stop and may be re-started by double clicking on the camera name.

       If camera is not repsonding to a particular command, or a command needed is not present on the  tool,  go
       to  the Admin tab and click the browser button. This will launch the browser using the camera IP address.
       Log into the camera and settings should be avialable in native format for the camera configuration.

COPYRIGHT

       Copyright (c) 2020 Stephen Rhodes

       This program is free software; you can redistribute it and/or modify  it  under  the  terms  of  the  GNU
       General  Public License as published by the Free Software Foundation; either version 2 of the License, or
       (at your option) any later version. This program is distributed in the hope that it will be  useful,  but
       WITHOUT  ANY  WARRANTY;  without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE. See the GNU General Public License for more details. You should have received a copy of the  GNU
       General  Public  License along with this program; if not, write to the Free Software Foundation, Inc., 51
       Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

SEE ALSO

       There is a command line version of this program included with the libonvif package which  will  implement
       most of the same commands. It may be invoked using the 'onvif-util' command.

NOTES

       Camera  compliance  with the onvif standard is often incomplete and in some cases incorrect. Success with
       the onvif-util may be limited in many cases. Cameras made by Hikvision will have the  greatest  level  of
       compatibility  with onvif-util. Cameras made by Dahua will have a close degree of compatibility with some
       notable exceptions regarding gateway and DNS settings. Time settings may not be reliable in  some  cases.
       If  the  time  is  set without the zone flag, the time appearing in the camera feed will be synced to the
       computer time. If the time zone flag is used, the displayed time  may  be  set  to  an  offset  from  the
       computer time based on the timezone setting of the camera.

       If  the  camera DNS setting is properly onvif compliant, the IP address may be reliably set. Some cameras
       may not respond to the DNS setting requested by onvif-gui due to non compliance. Note that the camera may
       reboot automatically under some conditions if the DNS setting is changed from off to on.

                                                09 November 2022                                    onvif-gui(1)