WSCAT(1)

📦
version 8.21.3+~cs14.19.1 · 6 versions
, in ubuntu stonking

💖 WSCAT(1) — the wscat girlies' guide 💖

okay so bestie, welcome to wscat, from the User Commands girlies ✨ This is the manual page for wscat, and yes it's giving websocket main character energy. 🦋

🌸 NAME 🌸

wscat — communicate over websocket 💬✨ no cap, that's literally the whole job.

🎀 SYNOPSIS 🎀

wscat [options] (--listen <port> | --connect <url>)

so like… you're either listening or you're connecting. pick a lane, babe 💅 (the parentheses are doing the "one of these, fr fr" thing).

✨ OPTIONS ✨

okay this is the part you actually came for, so let's go option by option, no skipping, we don't do that here 🫶

  • -V, --version — spits out the version number. that's it. that's the whole vibe. 👑
  • --auth <username:password> — drops in a basic HTTP authentication header. username and password, colon between them, iconic little duo.
  • --ca <ca> — point at a Certificate Authority. ✨ (--connect only, so don't try this while listening, she won't hear you)
  • --cert <cert> — hand over a Client SSL Certificate. 💜 (--connect only)
  • --host <host> — an optional host. just in case you're feeling extra.
  • --key <key> — specify a Client SSL Certificate's key. 🔑 (--connect only)
  • --max-redirects [num] — how many redirects are allowed, max. default is 10, bestie. ten whole hops. 🦘
  • --no-color — run it with zero color. plain. minimalist. sad girl autumn aesthetic. 🍂
  • --passphrase [passphrase] — the passphrase for your Client SSL Certificate's key (--connect only). 🫢 and listen — if you don't give it a value, it's gonna prompt you for one. so it's not optional-optional, it's "you'll be asked" optional.
  • --proxy <[protocol://]host[:port]> — connect through a proxy. 🧚 quick note, no cap: the proxy must support the CONNECT method. no CONNECT, no entry.
  • --slash — turns on slash commands for control frames: /ping [data], /pong [data], /close [code [, reason]]. so very Discord-core of it. 💅 (--connect only)
  • -c, --connect <url> — connect to a WebSocket server. the whole point, honestly. 🔥
  • -H, --header <header:value> — set an HTTP header. repeat it to set multiple. (--connect only) default: [] — an empty little list waiting for your headers to move in. 🎀
  • -l, --listen <port> — listen on a port. the other half of the "pick a lane" situation. 👂
  • -L, --location — follow redirects. she follows. 🐾
  • -n, --no-check — do not check for unauthorized certificates. (--connect only) yes, that's the scary-but-convenient one. ⚠️ you're turning off the vibe check, babe.
  • -o, --origin <origin> — optional origin. just an origin. optional. 💫
  • -p, --protocol <version> — optional protocol version. 🧬
  • -P, --show-ping-pong — prints a lil notification whenever a ping or pong comes through. 🏓 (--connect only)
  • -s, --subprotocol <protocol> — optional subprotocol. repeat it if you want more than one. default: []. the more the merrier, fr fr. 🌈
  • -w, --wait <seconds> — wait the given number of seconds after executing a command. ⏳ oh and -1 means hold open. negative one holding the door open, so real of her.
  • -x, --execute <command> — execute a command after connecting. repeat to execute more than one. (--connect only) default: []. 🌟
  • -h, --help — display help for command. the classic. always there for you. 💖

that's the whole page, bestie — nothing skipped, nothing summarised, all 21 options present and accounted for 🫡✨

lowkey reminder: the --connect only flags mean exactly that. don't be out here passing them to --listen and then acting surprised. 🙈

and that's a wrap on the wscat manual page, written for version wscat 6.1.0, dated August 2026. 🎀 ty for reading, go forth and websocket, periodt. 💜

📦 where this page comes from