Home

Relay Manual

Everything you need, nothing you don't. This is the same manual that ships inside the app (⌘?), for reading in your browser.

Relay is a chat app for IRC — the internet's original group chat, running since the late '80s and still alive. You connect to a network (like Undernet), join channels (public rooms whose names start with #), and talk. Nobody makes an account for you: pick a nickname, connect, and you exist.

Rule of thumb for the whole app: everything is reachable two ways — type a /command, or right-click the thing.

Contents

1. Getting Started — add a server, every settings field explained
2. Connecting & Reconnecting — status dots, auto-reconnect, on-connect commands
3. The Sidebar — badges, ordering, right-click menus, Dock icon
4. Channels — joining, topics, modes in plain words, roles
5. Talking — messages, actions, colors, search, link previews
6. Composer Tricks — Tab completion, history, flood protection
7. Private Messages — DMs and instant whois
8. Notifications & Quiet — what pops and how to silence it
9. Blocking People — /ignore vs /silence
10. Private Sessions — incognito mode
11. The X Service — Undernet's channel bot, fully integrated
12. ASCII Art — the 🎨 catalog and your own art
13. All Commands — the full slash reference
14. Keyboard Shortcuts
15. Troubleshooting