amcrest

Python wrapper implementation for Amcrest cameras.

These details have been verified by PyPI

Maintainers

blademckain pnbruckner svig tchellomello

These details have not been verified by PyPI

Project links

Homepage

Project description

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

These details have been verified by PyPI

Maintainers

blademckain pnbruckner svig tchellomello

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

1.9.8

Sep 13, 2023

1.9.7

Mar 13, 2022

1.9.6

Mar 13, 2022

1.9.5

Mar 12, 2022

1.9.4

Feb 8, 2022

This version

1.9.3

Sep 17, 2021

1.9.2

Sep 16, 2021

1.9.1

Sep 16, 2021

1.9.0

Sep 16, 2021

1.8.1

Sep 10, 2021

1.8.0

Jul 26, 2021

1.7.2

Sep 23, 2020

1.7.1

Apr 19, 2020

1.7.0

Mar 19, 2020

1.6.0

Jan 29, 2020

1.5.6

Jan 16, 2020

1.5.5

Jan 12, 2020

1.5.4

Sep 27, 2019

1.5.3

Jun 2, 2019

1.5.2

Jun 2, 2019

1.5.1

May 20, 2019

1.5.0

May 17, 2019

1.4.1

Apr 27, 2019

1.4.0

Apr 10, 2019

1.3.0

Mar 24, 2019

1.2.7

Mar 15, 2019

1.2.6

Mar 13, 2019

1.2.5

Mar 6, 2019

1.2.3

Jun 16, 2018

1.2.2

Mar 7, 2018

1.2.1

Jul 24, 2017

1.2.0

May 17, 2017

1.1.9

Apr 16, 2017

1.1.8

Apr 8, 2017

1.1.5

Mar 29, 2017

1.1.4

Jan 31, 2017

1.1.3

Jan 22, 2017

1.1.2

Jan 22, 2017

1.1.1

Jan 22, 2017

1.1.0

Jan 14, 2017

1.0.0

Nov 24, 2016

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.3.tar.gz (919.2 kB view details)

Uploaded Sep 17, 2021 Source

Built Distribution

amcrest-1.9.3-py3-none-any.whl (151.6 kB view details)

Uploaded Sep 17, 2021 Python 3

File details

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

File metadata

Download URL: amcrest-1.9.3.tar.gz
Upload date: Sep 17, 2021
Size: 919.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.7

File hashes

Hashes for amcrest-1.9.3.tar.gz
Algorithm	Hash digest
SHA256	`4aa8b35ef2f204bf2cb3761785d0728cbb32c79b14353fcc8525b094dbe67816`
MD5	`30979abb8265dcf2252bcf1e23aabc9a`
BLAKE2b-256	`e4b145c8bc2046e7f4b488aaf095f4c4068bda29a1be6c9c0c2817fe219dd50f`

See more details on using hashes here.

Provenance

File details

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

File metadata

Download URL: amcrest-1.9.3-py3-none-any.whl
Upload date: Sep 17, 2021
Size: 151.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.7

File hashes

Hashes for amcrest-1.9.3-py3-none-any.whl
Algorithm	Hash digest
SHA256	`23621f3772ca868e6b4a8aa887574ac880e04f45c0f249b71ff0df38ab482b0c`
MD5	`90a5fcea172e2f115dbdb356e4b49dea`
BLAKE2b-256	`28ab1632e6c83a962c472de3225dd4da4fba3a64f1a3c3d0205aa4de3c2de706`