aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar lancebord 2026-03-08 11:56:45 -0400
committerGravatar lancebord 2026-03-08 11:56:45 -0400
commit367c3b3a87ee10eaeb0f9d08787111df62b54515 (patch)
tree24003cc2cf523aa9268c00b2d9a98c81572ccc4e
parentmake private messages more obvious (diff)
added a readme
-rw-r--r--README.md46
-rw-r--r--logo.pngbin0 -> 78395 bytes
-rw-r--r--src/main.rs2
3 files changed, 47 insertions, 1 deletions
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/)
diff --git a/logo.png b/logo.png
new file mode 100644
index 0000000..d5c9cbd
--- /dev/null
+++ b/logo.png
Binary files differ
diff --git a/src/main.rs b/src/main.rs
index d7df2bb..a1bf0a2 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -22,7 +22,7 @@ struct Args {
#[arg(short, long)]
server: String,
- #[arg(short, long, default_value_t = String::new())]
+ #[arg(short, long)]
nick: String,
#[arg(short, long, default_value_t = String::from("speakez"))]