Notifications

One-line computer setup

Install the Shinphony host helper on your Mac, Linux or Windows computer with one command, pair by scanning the code, and check the signed hashes before anything runs.

On the computer you want to reach, run one line: a terminal on macOS or Linux, PowerShell on Windows. It installs the Shinphony helper for your user, creates a device key and can turn on task notifications; then it shows a pairing code for the phone.

macOS / Linux

curl -fsSL https://shinphony.app/pair | sh

Windows · PowerShell

irm https://shinphony.app/pair.ps1 | iex

In Shinphony, choose Add server → Scan pairing code and point the camera at the code in your terminal. Check the name, address and port before you allow access, or save now and finish on the first connection. The code expires after five minutes.

What it does

  • Reads the signed release metadata and verifies every download against its published SHA-256 before installing anything.
  • Installs the helper in ~/.shinphony-agent for your user only: %USERPROFILE%\.shinphony-agent on Windows. It refuses root, never overwrites an existing directory, and needs no sudo.
  • Sets up a device key, so the computer trusts this phone rather than a password.
  • Optionally enables task notifications for supported agents. You can decline that part and still pair.
  • Shows a pairing code and exits. It does not open a connection back to your phone.

Windows

Run the PowerShell line in a normal window, not as administrator. If OpenSSH Server is off, the script asks once for administrator permission, then turns SSH on and adds your key; decline and nothing changes. Administrator accounts keep the key in C:\ProgramData\ssh\administrators_authorized_keys, other accounts in their own .ssh\authorized_keys.

Only want SSH on, without pairing? Run irm https://shinphony.app/ssh.ps1 | iex in the same normal PowerShell window. It asks for nothing when SSH and its firewall rule are already on.

Check the source and the hashes

The helper is open source: chux0519/shinphony-hook. Builds are reproducible and each release is signed. /hook lists the current release sequence, date and per-platform SHA-256 from the verified metadata. The script you run verifies the binary it installs against those hashes; if it cannot, it refuses to install.

Notification text is end-to-end encrypted: only your iPhone can read it. Terminal lines on the Lock Screen are opt-in.

Remove it

Revoke the host in Shinphony (More → Task notifications), then delete ~/.shinphony-agent on the computer (%USERPROFILE%\.shinphony-agent on Windows). Removing the helper does not change your SSH configuration.

Continue with the Hook reference or the task notifications guide.

Current App Store release: 1.1.0 · Updated 2026-11-13

Next →Shinphony Hook