Desktop client · beta

OSHI for Windows and Linux

The same end-to-end encryption as the phone apps — not a reimplementation, the same source compiled for the desktop. No phone number, no account, no email. It does not carry the mesh, the radio link, the covert channels or the post-quantum key agreement described elsewhere on this site. The notes below say exactly which parts of OSHI stay on the phone.

The Windows and Linux builds are being prepared.

The page is here so you know what you are getting and what you are not. The files will appear on these buttons; nothing else about this page will change.

It bundles its own Java runtime, so there is nothing else to install. macOS users: the Mac App Store build is the one to use.

Read this before you install

Things that will surprise you otherwise. None of them is hidden inside the app.

Windows will warn you, and it is right to

These builds are not code-signed yet, so SmartScreen shows “Windows protected your PC”. Signing requires a certificate whose private key lives on dedicated hardware, and we do not have one. Until we do, every download here triggers that screen. Compare the SHA-256 below if you want to check what you got.

This is a separate OSHI account, not your phone’s

There is no way to import an existing identity yet. The desktop client generates its own key and its own address, so your phone’s conversations will not appear here, and this client has a different address to give people.

No post-quantum key agreement on this client

Elsewhere on this site you will read about X-Wing (ML-KEM-768 + X25519) hybrid post-quantum key agreement. That is real, and it is iOS 26 and macOS 26 only, and only when both people in a conversation run a build that supports it. The desktop client has none of it. Its sessions are X25519 + Double Ratchet + AES-256-GCM — strong today, and not what protects you against traffic recorded now and decrypted after a quantum computer exists.

No mesh, no LoRa, no steganography here either

The offline mesh, the radio link and the covert channels are what make OSHI censorship-resistant on a phone. None of the three works on desktop. The mesh and LoRa carry a message format this client cannot read, and the covert channels are not built into it. A desktop OSHI needs the Internet and the relay.

Messages arrive only while it is running

There is no push notification system on desktop. The client polls the relay, so closing the window stops delivery and the poll interval is the delivery delay.

What it does, and what it doesn’t

The app carries this same list on a screen called “What this client will not do”.

It does

  • One-to-one messaging, end-to-end encrypted
  • Group messages, with a per-member delivery count
  • File attachments, encrypted before they leave
  • Pairing by QR code or pasted key
  • Contacts, safety numbers, block and unblock
  • Offline points-of-interest and street search
  • A local AI console, if you supply your own model
  • A terminal client alongside the window, with more commands

It does not

  • Voice or video calls — no audio ever flows
  • Push notifications
  • Sync with your phone
  • Open photos it received (they are saved to disk)
  • Scan a QR with a camera — paste the key instead
  • Mesh or LoRa messaging (those carry a format this client cannot read)
  • Update itself — check back here for new versions

Verify your download

A checksum is not a signature: it proves the file matches what we built, not who built it. It is what an unsigned distribution can offer.

Windows PowerShell:

Get-FileHash .\OSHI-Desktop-Setup.exe -Algorithm SHA256

Linux:

sha256sum oshi-desktop-amd64.deb

Expected values for this release:

FileSHA-256

Installing

Windows Run the .exe. When SmartScreen appears, choose More info → Run anyway — that warning is about the missing signature, not about the file being damaged. It installs for your user only, so it does not ask for administrator rights.
Debian, Ubuntusudo apt install ./oshi-desktop-amd64.deb
Fedora, RHELsudo dnf install ./oshi-desktop.x86_64.rpm
Where it lives Your account and messages are kept in %APPDATA%\OSHI on Windows and ~/.local/share/oshi on Linux. The master key is held by the operating system — Windows DPAPI, or your Linux keyring — and everything on disk is encrypted under it.
Uninstalling Windows: Settings → Apps → OSHI. Linux: apt remove oshi-desktop. Your messages stay in the folder above; delete it to remove them.

Questions people ask before installing

Short answers. Each one matches what the rest of this page says.

Is OSHI for Windows free?

Yes. It is free and open source under the MIT licence — no subscription, no ads, no paid tier. The cryptographic core is the same code published on GitHub.

Which versions of Windows does it run on?

Windows 10 and 11, 64-bit. It bundles its own Java runtime, so there is nothing else to install. There is no 32-bit and no Windows-on-ARM build.

Why does Windows say it protected my PC?

Because the installer is not code-signed yet. SmartScreen shows that warning for any unsigned program, whatever it contains. Choose More info → Run anyway, or check the SHA-256 on this page against your download first.

Will my phone's conversations appear on the desktop?

No. There is no identity import yet, so the desktop client generates its own key and its own address. It is a separate OSHI account, with a different address to give people.

Does the Windows version work without internet, like the phone?

No. The offline mesh, the LoRa radio link and the covert channels are phone-only. The desktop client needs the internet and the relay, and it receives only while the window is open.