streamplace-term-chat/README.md

Streamplace Chat Client

A lightweight, terminal-based live chat client for Streamplace powered by AT Protocol OAuth and Bluesky Jetstream.

Features

• Secure browser login flow with persistent session storage.
• Subscribes to live place.stream.chat.message events.
• Efficient handle/DID resolution to minimize network overhead.
• Auto-reconnecting WebSocket for uninterrupted stream chat.

Quick Start

Run directly using npx:

# Connect to your own stream chat room
npx @stevanfreeborn/streamplace-term-chat your-handle.bsky.social

# Connect to another streamer's chat room
npx @stevanfreeborn/streamplace-term-chat your-handle.bsky.social --streamer streamer-handle.bsky.social

Global Installation

Install globally via npm to use the streamplace-term-chat anywhere on your system:

npm install -g @stevanfreeborn/streamplace-term-chat

From Source

Prerequisites

• Node.js (v20+ recommended)
• npm

Quick Start

Clone the repository and install dependencies:

git clone https://github.com/StevanFreeborn/stream.place-chat-client.git
cd stream.place-chat-client
npm install

Start the chat client:

# Connect to your own stream chat
npm start -- <your-handle.bsky.social>

# Connect to a target streamer's chat room
npm start -- <your-handle.bsky.social> --streamer <streamer.bsky.social>

Chat commands:

• Type your message and hit Enter to post.
• /help: Show available in-chat commands.
• /quit or /exit: Gracefully disconnect and exit.

License

MIT