⚡ Kaze

Instantly share any local folder over the internet — no uploads, no cloud storage, no account needed.

Kaze uses Cloudflare Quick Tunnels to stream files directly from your machine to anyone in the world. Files never touch a central server.

---

How it works

Your machine                         Anyone on the internet
─────────────                        ──────────────────────
kaze host                  ←→        kaze get <url> <password>
    │                                        │
    ├─ Express server (local)                └─ Receives tar stream
    └─ cloudflared tunnel                       and extracts files
           └─ trycloudflare.com URL

---

Prerequisites

• Node.js v18+
• cloudflared (only the HOST needs this)

Install cloudflared (Host only)

Download from: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/

---

Installation

npm install -g kaze

Or install from source:

git clone https://github.com/Kenshin06/kaze.git
cd kaze
npm install
npm link

---

Usage

On the HOST machine (the one sharing files)

# 1. Go to the folder you want to share
cd /path/to/your-folder

# 2. Initialize Kaze (one-time per folder)
kaze init

# 3. Set a password
kaze set-password yourSecretPassword

# 4. Start sharing
kaze host

You'll see:

  ⚡ Kaze
  Sharing: /path/to/your-folder

  ✔ Server running on localhost:54321
  ✔ Tunnel established

  🌐 Hosted Link:  https://random-words.trycloudflare.com/download
  🔒 Password protected.

  Press Ctrl+C to stop sharing.

Send the Hosted Link and password to whoever needs the files.

---

On the RECEIVER machine (downloading files)

kaze get https://random-words.trycloudflare.com yourSecretPassword

Or extract into a specific folder:

kaze get https://random-words.trycloudflare.com yourSecretPassword -o ./my-download

Output:

  ✔ Authenticated successfully
  ✔ Transfer complete!

  Files extracted to: ./my-download

---

Commands

Command	Description
kaze init	Initialize Kaze in the current folder
kaze set-password <password>	Set the download password
kaze host	Host the current folder
kaze host ./some-folder	Host a specific folder
kaze host --verbose	Show cloudflared debug logs
kaze get <url> <password>	Download and extract files
kaze get <url> <pw> -o ./out	Extract into a specific folder

---

Security

• Passwords are never stored in plaintext — only a bcrypt hash is saved in .kaze/config.json
• Files stream directly from your machine — nothing is uploaded to any server
• The tunnel URL is temporary and changes every time you run kaze host
• The .kaze/ folder is gitignored by default

---

Notes

• Only the HOST needs cloudflared installed. Receivers only need kaze.
• The Cloudflare tunnel URL is valid only while kaze host is running. Press Ctrl+C to stop.
• Files are streamed as tarballs — RAM usage stays flat regardless of folder size.

---

License

MIT