From 4717e2787ef20df84386c6c0e482e8fce2f1882b Mon Sep 17 00:00:00 2001
From: michel <michel@re-invention.nl>
Date: Sun, 19 Jul 2026 13:40:04 +0200
Subject: [PATCH] docs: document private messaging in the README

---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index faddab6..339d9f7 100644
--- a/README.md
+++ b/README.md
@@ -89,6 +89,20 @@ soulseek-rs-lib = "0.1.0"
 ./target/release/soulseek-rs "the weeknd Blinding Lights"
 ```
 
+### Private messages
+
+Send a private message to another user from the command line:
+
+```bash
+soulseek-rs message <username> "hello there"
+```
+
+In the interactive TUI:
+
+- press `m` to compose — type `<recipient> <message>` and `Enter` to send;
+- press `i` to open the inbox popup listing sent and received messages
+  (incoming messages arrive automatically while the TUI is open).
+
 ## Development
 
 To run the project in development mode with debug output and trace output: