NAME

       tanidvr - tool for DVRs and IP cameras based on DVR-IP protocol used by Dahua

SYNOPSIS

       tanidvr -m <mode> -t <address> -u <user> -w <password> [OPTION]

DESCRIPTION

       TaniDVR  is  a CLI tool for accessing DVRs and IP cameras used for CCTV surveillance systems based on the
       proprietary DVR-IP protocol (port 37777/TCP).

       The main use of TaniDVR is to dump video from a device. With this, it can record to a Matroska (MKV) file
       or dump the video in realtime to play in an external player.

OPTIONS

       -m, --operation-mode
              0 - display DVR information.  1 - dump video.

       -t, --dvr-target
              IP/hostname.

       -p, --dvr-port
              Network port (default 37777).

       -u, --dvr-user
              DVR user (may not work if not admin!).

       -w, --dvr-password
              DVR password.

       -c, --dvr-channel
              0-255 (default 0).

       -s, --dvr-sub-channel
              0 - main (default).  1 - secondary.

       -a, --net-protocol-dialect
              0 - common dialect (default).  1 - common dialect, while emulating OEM client behavior.

       -n, --media-container
              0 - DVR native: DHAV (.dav|.dhav) or RAW H.264 (depends on the DVR itself).  1 -  Matroska  (.mkv)
              (default).

       -f, --out-file
              <filename> (default: empty -- console stdout).

       -k, --keep-alive
              <mili_seconds>  (default:  100ms).   Send  innocuous  packets  to  the  DVR  in order to avoid the
              connection to be dropped gratuitously.  To disable (not recommended), set to 0.

       -e, --timeout
              <mili_seconds> (default 5000ms).  Inactivity timeout for DVR connection to be considered dead.   A
              new DVR connection is started after this.  To disable (not recommended), set to 0.

       -x, --sixty-hertz-ntsc
              (default:  not  enabled).   If  defined,  assumes  NTSC field frequency to be 60Hz, instead of the
              typical 59.94Hz.  Some cameras do generate exact 60Hz video.  This  switch  does  NOT  affect  PAL
              video.

       -r, --ts-proc
              0  -  No  correction will be performed to the buggy DHAV stream timestamps.  1 - Perform timestamp
              correction (default).

       -h, --help
              Prints help message and exit.

EXAMPLES

       •  Show some information about the DVR.

                     tanidvr -m 0 -t 192.168.0.12 -u admin -w secret1234

       •  Record a video to a file.

                     tanidvr -m 1 -t 192.168.0.12 -u admin -w secret1234 -c 2 -f camera2.mkv

       •  Play the video in realtime with an external player.

                     tanidvr -m 1 -t 192.168.0.12 -u admin -w secret1234 -c 2 | mplayer -cache 32 - 2>/dev/null

       •  Simple media server and some clients.  NOTE: INSECURE. NOT to be implemented as-is.  It is shown  only
          for didactic purposes.

                     (server at 192.168.20.1)
                     tanidvr -n 0 -m 1 -t 192.168.0.12 -u admin -w secret1234 -c 5 | ncat --broker -l 192.168.20.1 2000

                     (clients ; same/other host)
                     ncat --recv-only 192.168.20.1 2000 | dhav2mkv | mplayer -cache 32 -
                     ncat --recv-only 192.168.20.1 2000 | dhav2mkv > channel_5_realtime_backup.mkv
                     ncat --recv-only 192.168.20.1 2000 > channel_5_realtime_backup.dhav

AUTHOR

       tanidvr was written by Daniel Mealha Cabrita <dancab@gmx.net>.

       This  manual page was written by Marcos Talau <marcos@talau.info> for the Debian project (but may be used
       by others).

tanidvr-1.4.1                                      18 Aug 2022                                        tanidvr(1)