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