Text Sharing

Text sharing is the fastest way to send a snippet — a command, a password, a code block, or any plain text up to 10 MB — from one machine to another.

Sending text

In the sender UI

  1. Open the sender web UI (auto-opens at http://localhost:5000, or re-open via browser)
  2. Click the Text tab

📸 Screenshot needed: text-sharing-sender-tab.png Description: Sender web UI with the Text tab selected, showing the text area and Share button

  1. Type or paste your text into the text area
  2. Click Share

The item is immediately:

  • Hashed with SHA-512
  • Encrypted with AES-256-GCM
  • Added to the in-memory queue
  • Broadcast to all connected receivers via SSE

The queue table updates to show the new item with a Queued badge.

📸 Screenshot needed: text-sharing-sender-queued.png Description: Sender queue showing a text item with Queued status badge

Via the API (advanced) 

  curl -X POST "https://<tunnel-url>/upload/text?secret=<your-secret>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the command line!"}'

Response:

  { "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }

Receiving text

In the receiver UI

When the sender queues a text item, it appears instantly in the receiver queue (no page refresh needed).

📸 Screenshot needed: text-sharing-receiver-queue.png Description: Receiver web UI showing a text item in the queue with a Receive button

  1. Click Receive next to the item
  2. The receiver fetches and decrypts the item via the sender API
  3. A hash verification modal appears showing the SHA-512 comparison result

📸 Screenshot needed: text-sharing-receiver-hash-modal.png Description: Hash verification modal with green checkmark and matching hash values

  1. Once verified, the text is displayed and a Copy to Clipboard button appears
  2. Click Copy to Clipboard to copy the text

📸 Screenshot needed: text-sharing-receiver-copy.png Description: Receiver UI showing the received text content with Copy to Clipboard button

Text size limit

LimitValue
Maximum text size10 MB

If your text exceeds 10 MB, the sender will reject the upload with an error. For large content, consider splitting it or using a file instead.

What happens after receive

Once the receiver downloads a text item:

  • Its status in the sender queue changes to Received
  • The item is marked as delivered but remains in the queue until explicitly deleted or the sender is stopped
  • The receiver can copy it to clipboard or dismiss the modal

ℹ️ Info: Received items are not automatically deleted. The sender operator can manually delete them from the queue using the delete button, or they will be cleared when the sender is restarted.

Use cases

  • Sharing API keys or tokens with a colleague
  • Sending a command that’s too long to type
  • Passing a configuration snippet between machines
  • Sending a one-time password securely
  • Transferring clipboard content between computers