Scripts for remote access to the QooCam EGO

qoocamego__readme.rst

QooCam EGO remote scripts

This is a collection of independant scripts to show how to communicate with the QooCam EGO remotely.

They were tested with firmware 2.1.29 in the camera.

They are quite minimal so that you can inpire yourself to create your own awesome utility.

You can also use them directly as is.

qoocamego_capture_video.py

#!/usr/bin/env python3

# Script to capture a video with remote interface of the QooCam EGO

import urllib.request
import json
import sys

if len(sys.argv) != 2:
    print(f"usage: {sys.argv[0]} <IP>")
    exit()

urllib.request.urlopen(f'http://{sys.argv[1]}/osc/info')

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=b'{"name":"camera.startCapture"}') as f:
    jresponse = json.loads(f.read().decode())
    print(jresponse)

input('Type enter to stop')

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=b'{"name":"camera.stopCapture"}') as f:
    jresponse = json.loads(f.read().decode())
    print(jresponse)

qoocamego_delete.py

#!/usr/bin/env python3

# Script to download a thumbnail with remote interface of the QooCam EGO

import urllib.request
import json
import sys

if len(sys.argv) < 3:
    print(f"usage: {sys.argv[0]} <IP> <path> [other paths]")
    exit()

urllib.request.urlopen(f'http://{sys.argv[1]}/osc/info')

cmd = {
    "name": "camera.delete",
    "parameters": {
        "fileUrls": sys.argv[2:]
    }
}

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=json.dumps(cmd).encode()) as f:
    jresponse = json.loads(f.read().decode())
    print(jresponse)

qoocamego_dl_file.py

#!/usr/bin/env python3

# Script to download a file with remote interface of the QooCam EGO

import urllib.request
import json
import sys

if len(sys.argv) != 4:
    print(f"usage: {sys.argv[0]} <IP> <path> <out_file>")
    exit()

urllib.request.urlopen(f'http://{sys.argv[1]}/osc/info')

cmd = {
    "name": "camera._downloadFile",
    "parameters": {
        "type": "icon",
        "fileName": sys.argv[2]
    }
}

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=json.dumps(cmd).encode()) as f:
    response = f.read()
    if response[0] == '{':
        print('Not found')
    else:
        with open(sys.argv[3], 'wb') as f:
            f.write(response)

qoocamego_dl_thumbnail.py

#!/usr/bin/env python3

# Script to download a thumbnail with remote interface of the QooCam EGO

import urllib.request
import json
import sys

if len(sys.argv) != 4:
    print(f"usage: {sys.argv[0]} <IP> <path> <out_file.jpg>")
    exit()

urllib.request.urlopen(f'http://{sys.argv[1]}/osc/info')

cmd = {
    "name": "camera._getThumbnail",
    "parameters": {
        "type": "icon",
        "fileName": sys.argv[2]
    }
}

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=json.dumps(cmd).encode()) as f:
    response = f.read()
    if response[0] == '{':
        print('Not found')
    else:
        with open(sys.argv[3], 'wb') as f:
            f.write(response)

qoocamego_get_option.py

#!/usr/bin/env python3

# Script to get option/config with remote interface of the QooCam EGO

import urllib.request
import argparse
import json
import sys

options = [
    "captureMode",
    "captureModeSupport",
    "captureStatus",
    "captureStatusSupport",
    "dateTimeZone",
    "exposureCompensation",
    "exposureCompensationSupport",
    "exposureDelay",
    "exposureDelaySupport",
    "exposureProgram",
    "exposureProgramSupport",
    "fileFormat",
    "fileFormatSupport",
    "imageStabilization",
    "imageStabilizationSupport",
    "remainingSpace",
    "totalSpace",
    "whiteBalance",
    "whiteBalanceSupport",
    "_focusType",
    "_focusTypeSupport",
    "_lightFrequency",
    "_lightFrequencySupport",
    "_shutterSpeedMaxLimit",
    "_shutterSpeedMaxLimitSupport",
    "_temperature",
    "_temperatureSupport",
]

parser = argparse.ArgumentParser(description='QooCam EGO get options')
parser.add_argument('ip', nargs=1, help='IP of the device')
for o in options:
    parser.add_argument('--'+o, dest=o, action='store_const', const=True)
args = parser.parse_args()
options_to_get = [k for k, v in vars(args).items() if v is not None and k != 'ip']

urllib.request.urlopen(f'http://{args.ip[0]}/osc/info')

cmd = {
    "name": "camera.getOptions",
    "parameters": {
        "optionNames": options_to_get
    }
}

with urllib.request.urlopen(f'http://{args.ip[0]}/osc/commands/execute', data=json.dumps(cmd).encode()) as f:
    jresponse = json.loads(f.read().decode())
    if 'error' in jresponse:
        print('Error!', jresponse['error']['message'])
    else:
        for k, v in jresponse['results'].items():
            print(k+':', v)

qoocamego_list_files.py

#!/usr/bin/env python3

# Script to list files with remote interface of the QooCam EGO

# Equivalent to (+formatting)
# curl -i 'http://${CAMIP}/osc/commands/execute' --data '{"name":"camera.listFiles"}'

import urllib.request
import json
import sys

if len(sys.argv) != 2:
    print(f"usage: {sys.argv[0]} <IP>")
    exit()

urllib.request.urlopen(f'http://{sys.argv[1]}/osc/info')

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=b'{"name":"camera.listFiles"}') as f:
    jresponse = json.loads(f.read().decode())
    medias = jresponse['results']['medias']

cmd = {
    "name": "camera._getMediasSize",
    "parameters": {
        "medias": medias
    }
}

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=json.dumps(cmd).encode()) as f:
    jresponse = json.loads(f.read().decode())
    sizes = jresponse['results']['size']

def human_readable(size):
    for x in ['B', 'KiB', 'MiB', 'GiB']:
        if size < 1024: return f'{size:3.1f} {x}'
        size /= 1024
    return f'{size:3.1f} GiB'

print('\n'.join((' '*10+human_readable(s))[-10:]+'\t'+p for s,p in zip(sizes, medias)))

qoocamego_live_anaglyph.py

#!/usr/bin/env python3

# Script to display live preview of the QooCam EGO in anaglyph

import time
import sys
import cv2

if len(sys.argv) != 2:
    print(f"usage: {sys.argv[0]} <IP>")
    exit()

try:
    cap = cv2.VideoCapture(int(sys.argv[1]))
except:
    cap = cv2.VideoCapture(f"rtsp://{sys.argv[1]}/liveRTSP/av0")
ret, frame = cap.read()
if not ret: exit()
h,w,_ = frame.shape
w2 = w//2

print("""Help
====
q: quit
f: print FPS
g: print dp/dv
a: stereo anaglyph
m: monoscopic (left)
s: switch mono/anaglyph
4/6: change window position
2/8: change vertical error
5: reset dp/dv
""")
show_fps = False
stereo = True
dp = 0
dv = 0

while True:
    start = time.time()
    ret, frame = cap.read()
    if not ret: break
    img = frame[-dv if dv < 0 else 0 : -dv if dv > 0 else None, w2 - dp if dp < 0 else w2 : -dp if dp > 0 else None]
    if stereo:
        b,g,r = cv2.split(frame[dv if dv > 0 else 0 : dv if dv < 0 else None, dp if dp > 0 else 0 : w2 + dp if dp < 0 else w2])
        img[:,:,2] = 0.114*b+0.587*g+0.299*r
    cv2.imshow('QooCam EGO live anaglyph', img)
    key = cv2.waitKey(1)
    if key == ord('f'): show_fps = not show_fps
    elif key == ord('g'): print(f"dp={dp}, dv={dv}")
    elif key == ord('a'): stereo = True
    elif key == ord('m'): stereo = False
    elif key == ord('s'): stereo = not stereo
    elif key == ord('q'): break
    elif key == ord('4'): dp = max(1 - w2, dp - 1)
    elif key == ord('6'): dp = min(dp + 1, w2 - 1)
    elif key == ord('8'): dv = max(1 - h//2, dv - 1)
    elif key == ord('2'): dv = min(dv + 1, h//2 - 1)
    elif key == ord('5'): dv = dp = 0
    end = time.time()
    if show_fps:
        seconds = end - start
        print (f"Time taken : {1/seconds} fps ; {seconds} seconds")

qoocamego_set_option.py

#!/usr/bin/env python3

# Script to get option/config with remote interface of the QooCam EGO

import urllib.request
import argparse
import json
import sys

options = [
    ("captureMode", str),
    ("dateTimeZone", str),
    ("exposureCompensation", float),
    ("exposureDelay", int),
    ("exposureProgram", int),
    ("imageStabilization", str), # Accepted but not used (?)
    ("whiteBalance", str), # Accepted but not used (?)
    ("_focusType", str),
    ("_lightFrequency", str),
    ("_shutterSpeedMaxLimit", str),
    ("_temperature", str),
]

parser = argparse.ArgumentParser(description='QooCam EGO set options')
parser.add_argument('ip', nargs=1, help='IP of the device')
for o in options:
    parser.add_argument('--'+o[0], dest=o[0], type=o[1], nargs=1)
args = parser.parse_args()
options_to_set = {}
for k, v in vars(args).items():
    if v is not None and k != 'ip':
        options_to_set[k] = v[0]

urllib.request.urlopen(f'http://{args.ip[0]}/osc/info')

cmd = {
    "name": "camera.setOptions",
    "parameters": {
        "options": options_to_set
    }
}

with urllib.request.urlopen(f'http://{args.ip[0]}/osc/commands/execute', data=json.dumps(cmd).encode()) as f:
    jresponse = json.loads(f.read().decode())
    if 'error' in jresponse:
        print('Error!', jresponse['error']['message'])
    else:
        for k, v in jresponse['results'].items():
            print(k+':', v)

qoocamego_take_picture.py

#!/usr/bin/env python3

# Script to take a picture with remote interface of the QooCam EGO

# Equivalent to
# curl -i 'http://${CAMIP}/osc/commands/execute' --data '{"name":"camera.takePicture"}'

import urllib.request
import json
import sys

if len(sys.argv) != 2:
    print(f"usage: {sys.argv[0]} <IP>")
    exit()

urllib.request.urlopen(f'http://{sys.argv[1]}/osc/info')

with urllib.request.urlopen(f'http://{sys.argv[1]}/osc/commands/execute', data=b'{"name":"camera.takePicture"}') as f:
    jresponse = json.loads(f.read().decode())
    print(jresponse)

# QooCam EGO
# LivePreview 
# FW Version v.3.0.5
# Windows 11

import urllib.request
import json
import sys
import cv2

ip = "192.168.1.x"

urllib.request.urlopen(f'http://{ip}/osc/info')
with urllib.request.urlopen(f'http://{ip}/osc/commands/execute', data=b'{"name":"camera._startRtspLivePreview"}') as f:
	jresponse = json.loads(f.read().decode())
	# {'name': 'camera._startRtspLivePreview', 'results': {}, 'state': 'done'}
	print(jresponse)

cap = cv2.VideoCapture(f'rtsp://{ip}/liveRTSP/av0')

while cap.isOpened():
	ret, frame = cap.read()
	if not ret:
		break
	cv2.imshow("QooCam RTSP", frame)