This is where you type commands. Think of it like talking to your computer directly.

• Windows: Press ⊞ Win, type PowerShell, press Enter. A blue window appears.
• macOS: Press ⌘ Cmd + Space, type Terminal, press Enter.
• Linux: Press Ctrl + Alt + T or search for "Terminal" in your apps.

Copy the line below, paste it into your terminal, and press Enter. It downloads vb and sets it up automatically.

Find a file you want to share — a photo, a document, anything. Now type this in your terminal:

Replace photo.jpg with your actual file name (like report.pdf or video.mp4).

When you press Enter, voiddrop will connect to the relay and show something like this:

It's now waiting for someone to receive it. Leave this window open.

On the other computer (your friend's laptop, another PC, etc.), open a terminal and install voiddrop the same way (Step 2).

Then type this — using the exact same file name the sender used:

voiddrop will connect directly to the sender and download the file. You'll see progress like this:

✅ Done! The file is now on the receiver's computer, right where they ran the command.

If your file is sensitive (passwords, private docs, etc.), use Secure Mode. It adds AES-256 encryption — a 4-digit code protects the file.

When you press Enter, voiddrop generates a 4-digit code — share it with the receiver (text, call, whatever).

The receiver asks the sender for the code, then types:

The file is encrypted during transfer. Without the code, the file is just gibberish — unreadable.

For maximum security, use Secure-Blast. The receiver needs both an alphanumeric code and the file name to receive. Two separate keys.

voiddrop generates an alphanumeric code. Share the code and the file name separately — e.g., text the code, email the filename.

The receiver asks the sender for both, then types:

• Fast Mode — No encryption. Fastest. Use for movies, memes, public stuff.
• Secure Mode — Encrypted + 4-digit code. Use for personal docs, passwords.
• Secure-Blast — Encrypted + code + filename required. Use for top-secret stuff.

Copy a file in Explorer (Ctrl+C), then send it directly — no need to type the file path. Works with all modes.

voiddrop reads the file path from your clipboard, shows you what it detected, and starts transferring:

The receiver can also use --clip to grab the filename from their clipboard:

Combine with --secure for encrypted clipboard sends: vb send --clip --secure

No terminal on your phone? Two ways to send via QR:

• Local QR --qr — Same WiFi. Temp HTTP server on your machine. Scan and download.
• Global QR --global-qr — Anywhere. Relay serves the file. Phone downloads from the internet.

Local QR (--qr): voiddrop starts a temporary web server and shows a QR code. Scan with your phone's camera — the file downloads right in your browser. Both devices need to be on the same WiFi.

Global QR (--global-qr): The file uploads through the relay (in memory, no disk). The QR code works from anywhere — your phone just needs internet. Secure mode shows a code-entry page on the phone.

• Both computers need voiddrop installed. The sender runs vb send, the receiver runs vb receive.
• The file name must match exactly. If the sender types vb send Photo.jpg, the receiver types vb receive Photo.jpg (same capital letters too).
• Both need internet access. The relay coordinates the connection — you need to reach zephyr.proxy.rlwy.net:12963.
• Firewall may ask for permission. When you see a firewall popup, click Allow. voiddrop needs to open a port for direct P2P transfer.
• Behind a strict NAT? If the direct P2P connection fails, voiddrop falls back through the relay. It's slower but still works.
• Don't close the sender's terminal until the transfer finishes. The receiver needs the sender to stay connected.
• Can't remember a command? Type vb --help for the full guide, or vb send --help / vb receive --help for quick reminders.
• Clipboard not detecting a file? Make sure you copied a file (Ctrl+C in Explorer/Finder) or a file path as text. On Windows, try "Copy as path" (Shift+right-click).
• Global QR not working? Make sure the relay server is running (zephyr.proxy.rlwy.net:12963). The global QR uploads your file through the relay — it's in memory only, no disk storage.
• Flag order doesn't matter. vb send --clip --fast is the same as vb send --fast --clip. Modes are still mutually exclusive (--fast vs --secure).
• Need a quick reference? Download the command cheat sheet with every valid combination listed.