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:
Latest release

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-1.1.0.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

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

pysomfymylink-1.1.0-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for pysomfymylink-1.1.0.tar.gz
Algorithm Hash digest
SHA256 74965ddc41ae6e1abf5576a3252376244e7e6e65ba5c746448d1857c8941c314
MD5 27677303d8c3a680c7543dbf9077576f
BLAKE2b-256 ad8de3e588a5d1e7ae54645e4363f6de649f82276f9323c8a1da156e77a56e3b

See more details on using hashes here.

Provenance

The following attestation bundles were made for pysomfymylink-1.1.0.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-1.1.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for pysomfymylink-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6171ffa8a6b8e484315486213af4f44a1d1acbff2dd6892df7ef543b718041a8
MD5 b6fa1cf61d4d0d3291a410a1756b1827
BLAKE2b-256 df9e1be78edd23aba3ff4a66f4e8c3091c7e26150e5668f6ddcd926314b92ed6

See more details on using hashes here.

Provenance

The following attestation bundles were made for pysomfymylink-1.1.0-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

This release

1.1.0 This release

2 files

1.0.0

2 files

0.0.1

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