Features

Since the last update of IMAProtect “API” (05/2021), this plugin allows you to:

• get the status of your alarm:

from pyimaprotect import IMAProtect, STATUS_NUM_TO_TEXT
ima = IMAProtect('myusername','mysuperpassword')
# Use contract_number if you have multiple contracts, headless if you want to run in headless mode, timeout if you want to set a custom timeout and remote_webdriver if you use a remote webdriver for selenium, see https://hub.docker.com/r/selenium/standalone-firefox
# ima = IMAProtect(username='myusername', password='mysuperpassword', contract_number='contractid', headless=True, timeout=30, remote_webdriver='http://localhost:4444')

print("# Get Status")
imastatus = ima.status
print("Current Alarm Status: %d (%s)" % (imastatus,STATUS_NUM_TO_TEXT[imastatus]))

• set the status of your alarm:

from pyimaprotect import IMAProtect
ima = IMAProtect('myusername','mysuperpassword')

print("# Set Status")
ima.status = 0 # 0 to OFF, 1 to PARTIAL and 2 to On

• get the list and information of your registered contacts:

from pyimaprotect import IMAProtect
ima = IMAProtect('myusername','mysuperpassword')

print("# Get Contact List")
contact_list = ima.get_contact_list()
for contact in contact_list:
    print(contact)

• download the images/photos taken with your connected elements:

from pyimaprotect import IMAProtect
ima = IMAProtect('myusername','mysuperpassword')

print("# Download Images")
ima.download_images() # Download images to 'Images/' folder. One subfolder per camera.
ima.download_images("MyImages/") # Download images to a defined directory 'MyImages/' folder.

services:
  firefox:
    image: selenium/standalone-firefox:130.0-20251025
    shm_size: 2g
    ports:
      - "4444:4444"
      - "7900:7900"

Credits

3.2.5 (2025-10-30)

• Add support for multiple user agents in IMAProtect.

• Improve error handling and logging.

• Add simulate_typing_to_element method to IMAProtect to simulate human-like typing in input fields thanks to @falconslag

3.2.3 (2025-10-29)

• Add timeout parameter to IMAProtect to set a custom timeout for selenium webdriver waits.

• Add headless parameter to IMAProtect to run selenium in headless mode.

3.2.2 (2025-10-28)

• Update login procedure since IMA Protect login page changed again…, thanks to @falconslag

3.1.6 (2024-03-31)

• Update RE_ALARM_TOKEN since IMA Protect login page changed again…, thanks to @Chrilk

3.1.5 (2023-02-18)

• Update login procedure according to new IMAProtect “API”, thanks to @Thesola10

3.1.2 (2021-11-05)

• Update login procedure according to new IMAProtect “API”

• Update download images procedure according to new IMAProtect “API”

3.1.0 (2021-05-22)

• Add cookie expire usage to reduce the number of login

• Add a logout function

3.0.0 (2021-05-22)

• Add option to change the alarm (set/get)

• Add function to get the list of contacts

• Add function to download the images

get_status has been removed, status is now a property to get/set the alarm.

2.0.0 (2021-05-09)

• Update using new IMAProtect “API”

• No more other info (name, contract, etc.), only alarm status but faster result.

1.0.0 (2021-04-11)

• First release on PyPI.