---
id: motioneye-client
version: "0.3.14"
license: MIT
license_treatment: permissive
maintenance: active
---

# motioneye-client — motionEye client library Python Package

License: permissive · Maintenance: active · Downloads: 73.7K/mo

## What it is and what it does

motioneye-client is an async Python wrapper around the motionEye surveillance server API. It abstracts the HTTP calls needed to authenticate, query camera configurations, retrieve recordings, and trigger actions on a motionEye instance. The library depends only on aiohttp and is designed to integrate into home automation or monitoring systems that need programmatic control over motionEye.

The client handles both admin and surveillance credentials separately, as motionEye's API requires different permissions for configuration changes versus data streaming. It provides both low-level async methods (prefixed with `async_`) that return raw JSON responses and convenience methods to extract URLs for video streams, snapshots, and recorded media. It can be used as a context manager to automatically manage the underlying aiohttp session.

Use it for:

- Integrate motionEye camera control into a home automation system that needs to start/stop recording or trigger snapshots programmatically.
- Build a monitoring dashboard that polls camera status and retrieves recent recordings from a motionEye server.
- Automate camera configuration changes across multiple motionEye instances in a distributed surveillance setup.
- Fetch streaming URLs and snapshot URLs to embed live camera feeds in a custom web interface.
- Trigger custom motionEye action buttons (e.g., alerts, notifications) in response to external events.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

An async Python client library for querying and controlling motionEye surveillance servers, providing methods to manage cameras, retrieve recordings, and execute server actions.

Yes. This is a straightforward, actively maintained async client for a specific surveillance platform. Low install friction, permissive license, no known vulnerabilities, and a clear use case for anyone running motionEye. Install if you need programmatic control over a motionEye server; skip if you don't use motionEye.

## Install

pip install motioneye-client
uv add motioneye-client
poetry add motioneye-client

## Installing motioneye-client

Before you install: Low friction install with a single runtime dependency (aiohttp). Actively maintained as of July 2026, with consistent commit history since initial release in March 2021.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you retain the license notice.

Quickstart:

pip install motioneye-client

import asyncio
from motioneye_client.client import MotionEyeClient

async def main():
    async with MotionEyeClient("http://localhost:8765") as client:
        manifest = await client.async_get_manifest()
        cameras = await client.async_get_cameras()

asyncio.run(main())

Requires a running motionEye server accessible at the provided URL; Python 3.8 or later.

Verify before relying:

- Whether the package handles motionEye API versioning or breaking changes across server versions.
- Performance characteristics when managing large numbers of cameras or high-frequency polling.
- Whether webhook callback integration is documented or tested in practice.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

motioneye api client, surveillance camera control python, async motioneye client, camera management library, motioneye server integration, video surveillance api, motion detection client, home-automation, surveillance, async-client

[View on SkillFed](https://skillfed.io/packages/motioneye-client) · [View on PyPI](https://pypi.org/project/motioneye-client/)