pysomfymylink

An async Python client for the Somfy MyLink "Synergy" JSON-RPC socket API (the local TCP interface on port 44100 exposed by the Somfy MyLink / SomfyRtsBridge hub).

This is a maintained, clean-room rewrite of the excellent but now unmaintained somfy-mylink-synergy by Ben Dews (last released 2019). Full credit to Ben for the original API design and protocol reverse-engineering. This rewrite keeps a familiar method surface but reimplements the transport layer to fix two real defects:

  • No more deadlock on a flaky hub. The original used an asyncio.Event as a mutex that was not released on the connect-timeout path, so after a single connection timeout every subsequent command blocked forever until Home Assistant was restarted. This version guards the socket with a real asyncio.Lock held via async with, so it is always released — even on errors.
  • Typed errors. Transport failures raise SomfyMyLinkConnectionError / SomfyMyLinkTimeoutError; JSON-RPC error replies raise SomfyMyLinkApiError.

Install

pip install pysomfymylink

No runtime dependencies — the client uses only the stdlib asyncio socket API.

Usage

import asyncio
from pysomfymylink import SomfyMyLink

async def main():
    hub = SomfyMyLink("192.168.1.10", "your-system-id")

    for shade in await hub.status_info():
        print(shade.target_id, shade.name, shade.cover_type)

    await hub.move_up("<TARGET_ID>")
    await hub.move_down("<TARGET_ID>")
    await hub.move_stop("<TARGET_ID>")   # stop / "my" favorite

asyncio.run(main())

The System ID is found in the MyLink mobile app under Integration → select any non-Cloud service.

CLI

export SOMFY_MYLINK_HOST=192.168.1.10
export SOMFY_MYLINK_SYSTEM_ID=your-system-id
python -m pysomfymylink list            # read-only
python -m pysomfymylink up   <TARGET_ID>
python -m pysomfymylink stop <TARGET_ID>

API

Method Description
status_info(target_id="*.*") List configured covers as Shade objects
status_ping(target_id="*.*") Ping targets
move_up / move_down / move_stop(target_id) Drive a cover
scene_list() / scene_run(scene_id) List / run scenes

Notes / limitations

Somfy RTS is a one-way radio protocol: the hub cannot report a cover's real position, so consumers must treat state as assumed. A move_stop on a stationary cover can send it to its configured "my" favorite position.

License

MIT. See LICENSE, which preserves credit to the original author.

Project links

Data verified by PyPI on Jul 19, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.1.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for sslivins from gravatar.com sslivins

Credits

Author: Stefan Slivinski

GitHub Statistics

Data verified by PyPI on Jul 19, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

tests

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pysomfymylink-0.0.1.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pysomfymylink-0.0.1-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file pysomfymylink-0.0.1.tar.gz.

File metadata

  • Download URL: pysomfymylink-0.0.1.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pysomfymylink-0.0.1.tar.gz
Algorithm Hash digest
SHA256 732d70b97db0287e4ca9e2a4fd1161fb909f6fbf1f564048674ee03083cb7021
MD5 bb8261301514a9d2decc4ed73660b6b3
BLAKE2b-256 677536fd526d5de1d797bb64a18d0981e49d9d78599ce5f8c04c414129f41a1d

See more details on using hashes here.

Provenance

The following attestation bundles were made for pysomfymylink-0.0.1.tar.gz:

Publisher: release.yml on sslivins/pysomfymylink

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pysomfymylink-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: pysomfymylink-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pysomfymylink-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ca02490fdc869b3ac7b645c424637f2fd7569cf50b5b7222a1440dcdc0d339fc
MD5 2d8939722c7bc47fafc5283b7bbee070
BLAKE2b-256 b3599f4379aafc24462636c8edaf295e720651b333b82a2f4f6ba514c74f3813

See more details on using hashes here.

Provenance

The following attestation bundles were made for pysomfymylink-0.0.1-py3-none-any.whl:

Publisher: release.yml on sslivins/pysomfymylink

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.1.0

2 files

1.0.0

2 files

This release

0.0.1 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page