tanidvr

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