stasis-client
A local remote-desktop client for the Aethernet stasis protocol. It runs on your machine, connects to a remote host running an Aethernet stasis server, and gives you a live (or on-request) view of that host's screen with mouse, keyboard, and clipboard control - as a native window or in your browser.
Features
- Native window or browser - run as a standalone desktop window, or as a regular local web app you open in your browser. Same interface either way.
- Live and Snap input modes - send clicks, scrolls, and keystrokes immediately as you make them, or record a sequence of actions locally and send them to the remote host as a single batch once you're ready.
- Configurable hotkeys - request a screen frame, open a multi-line text input, and start/cancel/send a Snap recording, all bound to your own key combos.
- Multi-click coalescing - double/triple/... clicks are detected locally and sent as a single click event with the right click count, instead of arriving too far apart over the network to register as a multi-click on the remote host.
- Automatic DPI-aware coordinate scaling - clicks land in the right place even when the remote host's screenshot resolution differs from its logical input resolution (e.g. Retina/HiDPI displays).
- Clipboard sync - push your local clipboard to the remote host, or pull the remote host's clipboard back to yours, on demand.
- Bulk text entry - a dedicated popup for pasting or typing long text, sent as a single event instead of one keystroke at a time.
- On-request or interval screen streaming - choose whether frames are pushed continuously or only when you ask for one.
- In-app log viewer - see what the underlying connection is doing without leaving the app.
- Dark, distraction-free interface with a startup animation.
Installation
pip install stasis-client
This installs the stasis-client command.
Stasis-client speaks the stasis protocol over an Aethernet link. The transport itself (AggregatingLink) comes from the separate aethernet-core package, which stasis-client depends on automatically - you don't need to install it yourself.
Quick start
-
Create a link configuration file - a small Python file that tells stasis-client (and, if you use the same file, the Aethernet server too) how to reach your remote host (transport, address, encryption, etc.):
# aethernet_link.py import logging from typing import Literal from aethernet.transport import AggregatingLink async def create_link( mode: Literal["server", "client"], logger: logging.Logger ) -> AggregatingLink: # Build and return your AggregatingLink here. # `mode` is "client" when called from stasis-client. ...
-
Run the client from the same directory:
stasis-client
This opens a native window by default. To open it in your browser instead:
stasis-client --mode browser
That's it - the settings dialog inside the app lets you configure hotkeys, input mode, and streaming behavior without touching the command line again.
Command-line options
| Flag | Description | Default |
|---|---|---|
--mode {window,browser} |
Run as a native window or a local web server | window |
--link-config PATH |
Path to your link config file | ./aethernet_link.py |
--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL} |
Logging verbosity | DEBUG |
Each of these can also be set via an environment variable (AETHERNET_UI_MODE, AETHERNET_LINK_CONFIG, AETHERNET_LOG_LEVEL) - the CLI flag takes priority when both are set.
In-app settings
Open the settings dialog from the top panel to configure, without restarting the app:
- Session mode - Live (send everything immediately) or Snap (record, review, then send).
- Screen streaming mode - on-request or interval-based, with a configurable interval.
- Hotkeys - request-frame, open-big-input, and the three Snap recording controls (start/cancel/send).
- Multi-click window - how long to wait after a click before deciding how many clicks it was.
- Logs - a live tail of the connection's log output.
Settings persist across restarts.
Requirements
- Python 3.12+
- A running Aethernet stasis server on the host you want to control (see github.com/solment-slet/aethernet)
License
Apache License 2.0 - see the LICENSE file in this repository. Matches the license used by aethernet-core.
Metadata
Release files for stasis-client 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stasis_client-0.1.0.tar.gz | 67.9 kB | With provenance | Details for stasis_client-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stasis_client-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for stasis_client-0.1.0-py3-none-any.whl |
Total release size: 138.4 kB
Release files / stasis_client-0.1.0.tar.gz
| Download URL | stasis_client-0.1.0.tar.gz |
|---|---|
| Size | 67.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
418558d6bb9e70c5f69da16c13da992f5a45f151879aad20c7779fd3aba51015
|
|
BLAKE2b-256 checksum How to use checksums |
fc6a016d650199b6afbd2c60584d18987ee1d3df4e27fd1b3082b0150e9c05f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency logRelease files / stasis_client-0.1.0-py3-none-any.whl
| Download URL | stasis_client-0.1.0-py3-none-any.whl |
|---|---|
| Size | 70.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b25e03f256db2293b5af1939ba220222123d3289e38388e55deb5c346f547d85
|
|
BLAKE2b-256 checksum How to use checksums |
fa08f61e8fad82bdb08474b0023f9c6dd472e45be673911bf6c10a2eb8717e98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency logSecurity for stasis-client 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for stasis_client-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.