From 367c3b3a87ee10eaeb0f9d08787111df62b54515 Mon Sep 17 00:00:00 2001
From: lancebord
Date: Sun, 8 Mar 2026 11:56:45 -0400
Subject: added a readme

---
 README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..955a4aa
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+<p align="center">
+  <img width="256" height=auto src="logo.png">
+  <br/>
+  <img src="https://img.shields.io/github/contributors/lancebord/speakez" alt="contributors">
+  <img src="https://img.shields.io/github/license/lancebord/speakez" alt="license">
+  <img src="https://img.shields.io/github/forks/lancebord/speakez" alt="forks">
+</p>
+
+---
+
+# SpeakEZ
+
+SpeakEZ is an open-source IRC client in your terminal written in Rust with the Ratatui crate for visuals. SpeakEZ is a minimal client that implements just enough protocol from scratch to support single channel chatting and private messages. No extra config files, tiling, tabs, splits, or menus. SpeakEZ is focused on being performant and simple.
+
+---
+
+## Compiling/Installation
+
+```
+git clone https://github.com/lancebord/speakez.git
+cd speakez
+cargo install --path .
+```
+
+## Usage
+
+```
+speakez -s <server_addr>:<port> -n <nick>
+```
+
+You can optionally set username, realname, and password with `-u`, `-r`, and `-p` respectively.
+
+Once connected join a channel with `/join #<channel>`
+
+## Commands
+
+- `/join #<channel>` - joins the named channel and leaves prior channel
+- `/part` - leaves the current channel
+- `/nick <new_nick>` - changes nick to the new nick
+- `/quit` - quits the client
+- `/me` - return info about current user
+- `/msg <nick> <message>` - sends a private message to specified nick
+
+## Thanks & Inspiration
+
+- [modern irc client protocol](https://modern.ircdocs.horse/)
-- 
cgit v1.2.3-59-g8ed1b