Python Amcrest
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.shRPM
$ git clone git@github.com:tchellomello/python-amcrest.git
$ ./autogen.sh
$ make rpm
$ dnf/yum install amcrest-cli-NVR.rpm pythonX-amcrest-NVR.rpmUsage
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 timerCommand 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.40Text 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-tuiSupportability 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.
5 maintainers
Metadata
5 maintainers
Release files for amcrest 1.9.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| amcrest-1.9.9.tar.gz | 45.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| amcrest-1.9.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 100.6 kB
Release files / amcrest-1.9.9.tar.gz
| Download URL | amcrest-1.9.9.tar.gz |
|---|---|
| Size | 45.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bc97dfb3f946c8b6d368fcf6fc8541e09a2a3f4a63d0171edf3a1b4a5715883e
|
|
BLAKE2b-256 checksum How to use checksums |
cd0ca0230ceff6bc344fbb936fd644ef757fbf4cf5e8494d605242aeb3ae1748
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / amcrest-1.9.9-py3-none-any.whl
| Download URL | amcrest-1.9.9-py3-none-any.whl |
|---|---|
| Size | 54.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ee6e1a39de2421a5eca2a79cb2d4c538c1ecd8d233f338b876986c7e8d422550
|
|
BLAKE2b-256 checksum How to use checksums |
cc12d0ef02741cf372d2f9f2650cb09366d78f57189ddac6202ae06ee7c9451f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Security for amcrest 1.9.9
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
