DOKK / manpages / debian 12 / onvif-tools / onvif-gui.1.en
onvif-gui(1) onvif-gui(1)

onvif-gui - query and adjust onvif compatible cameras



  onvif-gui

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.

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 (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.

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.

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