Skip to main content

Python wrapper implementation for Amcrest cameras.

Project description

https://badge.fury.io/py/amcrest.svg https://travis-ci.org/tchellomello/python-amcrest.svg?branch=master https://coveralls.io/repos/github/tchellomello/python-amcrest/badge.svg https://img.shields.io/pypi/pyversions/amcrest.svg

A Python 2.7/3.x module for Amcrest Cameras using the SDK HTTP API. Amcrest and Dahua devices share similar firmwares. Dahua Cameras and NVRs also work with this module.

Documentation: http://python-amcrest.readthedocs.io/

Installation

PyPI

$ pip install amcrest --upgrade
$ eval "$(register-python-argcomplete amcrest-cli)"

# To enable amcrest-cli autocomplete in the system:
$ echo 'eval "$(register-python-argcomplete amcrest-cli)"' >  /etc/profile.d/amcrest-cli-autocomplete.sh

RPM

$ git clone git@github.com:tchellomello/python-amcrest.git
$ ./autogen.sh
$ make rpm
$ dnf/yum install amcrest-cli-NVR.rpm pythonX-amcrest-NVR.rpm

Usage

from amcrest import AmcrestCamera
camera = AmcrestCamera('192.168.0.1', 80, 'admin', 'password').camera

#Check software information
camera.software_information
'version=2.420.AC00.15.R\r\nBuildDate=2016-09-08'

#Capture snapshot
camera.snapshot(0, "/home/user/Desktop/snapshot00.jpeg")
<requests.packages.urllib3.response.HTTPResponse object at 0x7f84945083c8>

#Capture audio
camera.audio_stream_capture(httptype="singlepart", channel=1, path_file="/home/user/Desktop/audio.aac")
CTRL-C to stop the continuous audio flow or use a timer

#Move camera down
camera.ptz_control_command(action="start", code="Down", arg1=0, arg2=0, arg3=0)

#Record realtime stream into a file
camera.realtime_stream(path_file="/home/user/Desktop/myvideo")
CTRL-C to stop the continuous video flow or use a timer

Command Line

$ man amcrest-cli
or
$ amcrest-cli --help

# Saving credentials to file.
$ vim ~/.config/amcrest.conf
[patio]
hostname: 192.168.0.20
username: admin
password: 123456
port: 80

[living_room]
hostname: 192.168.0.21
username: admin
password: secret
port: 80

$ amcrest-cli --camera living_room --version-http-api
version=1.40

Text User Interface (TUI)

Configure amcrest.conf and trigger amcrest-tui, make sure the user triggering amcrest-tui have access to framebuffer device or use sudo.

NOTE: Execute it from console logins, like /dev/ttyX (Non X Window). Pseudo-terminals like xterm, ssh, screen and others WONT WORK.

$ vim ~/.config/amcrest.conf
[patio]
hostname: 192.168.0.20
username: admin
password: 123456
port: 80

[living_room]
hostname: 192.168.0.21
username: admin
password: secret
port: 80

$ amcrest-tui

Supportability Matrix

Cameras

Model

Tested

Status

Results/Issues

IPM-721

Yes

working

IPM-HX1

Yes

working

IP2M-841

Yes

working

IP2M-842

Yes

working

IP3M-941

Yes

working

IP3M-943

Yes

working

IP3M-956

Yes

working

IP3M-956E

Yes

working

IP3M-HX2

Yes

working

IP4M-1026B

Yes

working

IP4M-1041B

Yes

working

IP4M-1051B

Yes

working

IP5M-1176EB

Yes

working

IP8M-2496EB

Yes

working

IP8M-T2499EW-28M

Yes

working

Network Video Recorders (NVR)

Model

Tested

Status

Results/Issues

XVR DAHUA 5104S

Yes

working

If you have different model, feel fee to contribute and report your results.

Help

If you need any help, please join our community on the Gitter channels available at Gitter.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

amcrest-1.9.9.tar.gz (45.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

amcrest-1.9.9-py3-none-any.whl (54.9 kB view details)

Uploaded Python 3

File details

Details for the file amcrest-1.9.9.tar.gz.

File metadata

  • Download URL: amcrest-1.9.9.tar.gz
  • Upload date:
  • Size: 45.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for amcrest-1.9.9.tar.gz
Algorithm Hash digest
SHA256 bc97dfb3f946c8b6d368fcf6fc8541e09a2a3f4a63d0171edf3a1b4a5715883e
MD5 054a6838c88fc9483a403067a847d2c6
BLAKE2b-256 cd0ca0230ceff6bc344fbb936fd644ef757fbf4cf5e8494d605242aeb3ae1748

See more details on using hashes here.

File details

Details for the file amcrest-1.9.9-py3-none-any.whl.

File metadata

  • Download URL: amcrest-1.9.9-py3-none-any.whl
  • Upload date:
  • Size: 54.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for amcrest-1.9.9-py3-none-any.whl
Algorithm Hash digest
SHA256 ee6e1a39de2421a5eca2a79cb2d4c538c1ecd8d233f338b876986c7e8d422550
MD5 1093f0b65864383f2eb54152d0d6ea76
BLAKE2b-256 cc12d0ef02741cf372d2f9f2650cb09366d78f57189ddac6202ae06ee7c9451f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page