Skip to main content

PushArmor command-line client

Send links and text to your own devices from a terminal. Everything is end-to-end encrypted: the relay server only passes on data it cannot read.

See https://pusharmor.com for the apps and the full guide.

Install

With pipx:

pipx install pusharmor

Or download pusharmor.py from the GitHub release, check its SHA-256 against pusharmor.py.sha256 from the same release, and run it with Python:

sha256sum -c pusharmor.py.sha256
python3 pusharmor.py --help

Commands

  • pusharmor login - log in this device (open the link it shows, then paste the code).
  • pusharmor pair - list your devices; pusharmor pair ID pairs with one: compare the fingerprint on both devices, then approve.
  • pusharmor send TEXT - send a link or text to all paired devices; --to ID for one, --text to send a link as plain text. With - or piped input it reads stdin.
  • pusharmor listen - print messages as they arrive; --json, --tsv, or --exec PROG (runs PROG ID NAME PLATFORM TYPE BODY per message).
  • pusharmor rename NAME - change the name your other devices show.
  • pusharmor logout - log out; keys and paired devices stay on this device.
  • pusharmor delete ID - remove a device from your account (this device too). It asks first; without a terminal it needs --yes.

Run pusharmor COMMAND --help for details. Files live in ~/.config/pusharmor (or $XDG_CONFIG_HOME/pusharmor, $PUSHARMOR_CONFIG, or --config DIR).

Exit codes

Code Meaning
0 success
1 error: a failed request, or a damaged or unreadable file on this device
2 wrong command line, or the command needs a terminal
3 not logged in, logged out, or this device was removed
4 send failed for at least one device, or there is no device to send to
75 the relay server is busy or unreachable; try again later
130 stopped with Ctrl-C

Needs

  • Linux or macOS. Windows is not supported yet.
  • Python 3.11 or newer.
  • The cryptography package (version 3.4 or newer). pipx installs it for you.

Metadata

Release files for pusharmor 0.0.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pusharmor 0.0.20
File Size Uploaded Provenance Actions
pusharmor-0.0.20.tar.gz 38.6 kB With provenance Details for pusharmor-0.0.20.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pusharmor 0.0.20
File Interpreter ABI Platform Actions
pusharmor-0.0.20-py3-none-any.whl Python 3 none any Details for pusharmor-0.0.20-py3-none-any.whl

Total release size: 68.9 kB

Release files / pusharmor-0.0.20.tar.gz

Download URL pusharmor-0.0.20.tar.gz
Size 38.6 kB
Tags Source
SHA-256 checksum
How to use checksums
b4d2f2317e226facd0754e2d4bfe3a3b7e5244ead6085524a96d4b8d9cac6dd9
BLAKE2b-256 checksum
How to use checksums
24852712fb603441304bbc18dee4051047366c84e926fdaa4b28782393c714c3
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 Oct 31, 2026.

Transparency log

Release files / pusharmor-0.0.20-py3-none-any.whl

Download URL pusharmor-0.0.20-py3-none-any.whl
Size 30.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e06f840f4a52c78e74d6748735b74e6b6b5560487f2feca4e7a8f8d1c53207f1
BLAKE2b-256 checksum
How to use checksums
c3de59d8e2bd9b8b987e128a52f430e026283672b3583aa5e329f3c2a44bab4c
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 Oct 31, 2026.

Transparency log

Security for pusharmor 0.0.20

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

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pusharmor-0.0.20.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 Oct 31, 2026.

Transparency log

A 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.

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