IRCpug documentation
How to add networks, chat, search history, set up notifications, use slash commands, and configure connections, authentication and bouncers in IRCpug, the IRC client for iPhone and iPad.
IRCpug is a native IRC client for iPhone and iPad. It connects to as many IRC networks as you like, keeps channel and private-message history searchable on your device, and supports current IRCv3 features and bouncers such as soju and ZNC. No account is required: networks, passwords and history stay on your device, and IRCpug connects directly to the servers you choose.
All screenshots on this page use fictional demo networks and people.
Features
- Multiple IRC networks in one Chats list, grouped by network, with pinned conversations, folded quiet channels, filters and search.
- Direct TCP, TLS, STARTTLS and WebSocket (
ws:///wss://) connections, with alternate servers, automatic reconnect and IPv4/IPv6 preference. - SOCKS5, SOCKS4/4a, HTTP CONNECT and system SOCKS proxies, including a Tor preset, with no silent fallback to a direct connection.
- SASL PLAIN, SCRAM, EXTERNAL (client certificates) and OAUTHBEARER authentication. Passwords, tokens and private keys are kept in the iOS Keychain.
- A log-style transcript with a nickname column, folded join/part events, replies, reactions, IRC formatting, spoilers and an amber highlight for messages that mention you.
- An Inbox for mentions, unread private messages, invitations and file transfers, with Reply, Join and Accept on each item.
- On-device history with full-text search across every network, and export as plain text.
- IRCv3 support including CHATHISTORY, message replies, reactions, redaction, multiline messages, metadata, read markers and MONITOR.
- soju and ZNC bouncer integration: history playback, soju network management, FILEHOST uploads and optional background notifications.
- More than 100 slash commands with completion, a built-in command reference, aliases and text replacements.
- Notify lists, ignore rules, channel modes and access lists, moderation shortcuts, WHOIS and channel browsing.
- FILEHOST uploads and DCC SEND/CHAT file transfers with explicit consent.
- FiSH encryption for channels and private messages that use a shared key.
- Optional iCloud Sync for networks, identities and appearance. Passwords and history are never synced.
- Available in English, German, Polish, Hindi, Simplified Chinese, Spanish, French and Japanese.
Getting Started
Add a network
Tap + in Chats and choose Add Network. With no networks yet, Chats walks you through your nickname, account and the channels to join.


Choose a Known Network fills in the servers for a popular network. The list is built into IRCpug and works offline. Choosing a network replaces only the network name and server list; your nickname and other settings stay as they are, and no credentials, accounts or channels are added.
| Network | Server |
|---|---|
| Libera.Chat | irc.libera.chat:6697, TLS |
| OFTC | irc.oftc.net:6697, TLS |
| QuakeNet | irc.quakenet.org:6667, plain text |
| EFnet | irc.efnet.org:6697, TLS |
| Snoonet | irc.snoonet.org:6697, TLS |
| DALnet | irc.dal.net:6697, TLS |
| IRCnet | ssl.ircnet.io:6697, TLS |

To enter a server yourself, fill in its address and port and choose a Security option:
| Security | Use it for |
|---|---|
| TLS | Servers that use an encrypted port, usually 6697. Recommended. |
| STARTTLS | Servers that upgrade a plain connection to TLS on the same port. |
| None | Plain-text servers, usually port 6667. Messages and passwords are not encrypted. |
For IRC over WebSocket, enter a complete ws:// or wss:// URL as the server address.
Connect
Tap Connect in the network’s header. The header’s ⋯ menu also has Server Messages, Mark as Read, Browse Channels, Disconnect, Edit Network, Close Network and Delete Network. To connect when IRCpug opens, turn on Connect on launch in the network’s settings.

Join a channel
Tap + in Chats and choose Add Channel, or type /join followed by the channel name in any conversation, for example /join #ircpug. Browse Channels in the network menu lists the channels on the server.
Chats
Chats groups conversations under each network. A network’s header shows whether it is connected and your nickname there, and holds Connect and every network action. Channels and private messages show the latest message, an unread count, and an amber @ badge when someone mentioned you.


- Pin a conversation to keep it in its own section at the top.
- Muted channels fold into one quiet channels row.
- The filter button shows only Unread, Pinned, Channels, Direct Messages or Networks, and can limit the list to one network. Saved Messages is in the same menu.
- Pull the list down to search it by name.
On iPhone, the tab bar hides while a conversation is open. On iPad, Chats stays in the sidebar next to the conversation.
Conversations
Conversations read like a log: each nickname sits in a column beside the message, with the time in small type under it. Several lines in a row from one person show the nickname once, and three or more joins, parts, quits and similar events fold into one line that you can tap to expand. Messages that mention you get a soft amber tint with an edge mark.
The channel topic sits on one line under the title; tap it to read all of it.


The info button opens Channel Info: the topic, channel modes in plain language, Pin, Notify and Leave, and the members grouped by rank. Tap a member to see their details or to message, WHOIS, ignore or moderate them. On iPad, the members button shows or hides a member column beside the conversation.
Message actions
Touch and hold a message to Save it, Reply to it, Copy it, message its sender privately, React, Report, Ignore or Whois the sender. Replies show a short one-line quote of the original message, and saved messages open back at the original conversation.


Reactions, replies and redaction need server support (IRCv3 message-tags, draft/reply and draft/message-redaction). When the server doesn’t support them, IRCpug hides the action instead of sending something the server would drop.
Formatting
Select text in the message field and open the edit menu to make it bold, italic, underlined, struck through, monospace or coloured, or to remove formatting. IRCpug shows incoming IRC formatting and colours, and turns same-colour text into a spoiler that stays hidden until you tap Reveal spoiler.
The message field grows to ten lines. Long pastes can be sent as several lines or, on networks with FILEHOST, uploaded as a link (see File Transfers).
More actions
The ⋯ button in a conversation has the less frequent tools: Search, Custom Avatar, Notifications, Members, Notify List, Ignored Users, File Transfers, Search Server History, FiSH Encryption, channel properties and modes, Supported Capabilities and Disconnect.


Supported Capabilities lists the IRCv3 features IRCpug can use in this conversation and what each one needs from the server, so you can see why a feature is or isn’t available.
Commands
Type / in the message field to use an IRC command. Matching commands appear above the keyboard as you type; tap one to complete it. Type /help to open the command reference, or /help followed by a command to read about it. Commands IRCpug doesn’t know are sent to the server as they are.


Some common commands:
| Command | Action |
|---|---|
/join <channel> [key] |
Join a channel |
/part [channel] [reason] |
Leave a channel |
/msg <target> <message> |
Send a message without opening a conversation |
/query <nick> [message] |
Open a private conversation |
/me <action> |
Send an action, such as /me waves |
/nick <newnick> |
Change your nickname |
/topic [channel] [topic] |
Show or change the topic |
/whois <nick> |
Show details about a user |
/away [reason], /back |
Mark yourself away or back |
/ignore, /unignore |
Manage ignored users |
/monitor +nick |
Add someone to your notify list |
/op, /voice, /kick, /ban, /kickban |
Moderate a channel |
/list |
Browse the server’s channels |
/history [count] |
Fetch earlier messages from the server |
/react <emoji> |
React to the latest message |
/key <shared-key> |
Set a FiSH key for this conversation |
/dcc send <nick> |
Offer a file over DCC |
/quote <command> |
Send a raw IRC line |
/amsg, /ame |
Message or act in every joined channel |
/clear, /clearall |
Clear the visible transcript |
The command reference in Settings → Help → Command Reference lists every command with its syntax.
Aliases and text replacements
Create your own command Aliases and Text Replacements in Settings → Input → Commands. An alias turns a short name into a longer command; a text replacement inserts text as you send. Command Scope controls whether /clearall clears all connected networks or only the current one.


Inbox And Search
Inbox
Inbox collects messages that mention you (with the line before each one), unread private messages, channel invitations and file transfers. Reply, Join or Accept right from each item, or Open it in its conversation.


Search
The Search tab searches the history saved on this device across every network. Filter by sender, date, network or messages with links. Results open at the original message. To search one conversation, use Search in its ⋯ menu; Search Server History asks a server that supports it (such as soju) for older messages.
You can also turn on Spotlight indexing so messages appear in iOS search. It is off by default.
Notifications
Choose which messages alert you, and their sounds, in Settings → Notifications: mentions and highlights, private messages, channel messages, notices, connection changes and more. Use Notify in a channel’s info to change alerts for that channel: highlights, all messages, or muted.


When IRCpug is closed
iOS suspends IRC connections shortly after IRCpug moves to the background, so a direct connection can’t alert you once the app is closed. To stay online and receive alerts:
- Use a bouncer that supports IRC Web Push, such as soju.
- Add the bouncer as a network in IRCpug and connect.
- Open Settings → Notifications → Background Notifications and tap Enable Background Notifications.
The bouncer encrypts message content before it is sent; it is decrypted on your device. The IRCpug Push Service stores only an app-specific device identifier and token needed to route notifications, and cannot read your messages.
Network Settings
Open a network’s ⋯ menu and choose Edit Network. The first page has the network name, IP protocol, primary and alternate servers, Connect on launch, and links to the other sections.


| Section | What it controls |
|---|---|
| Servers | Primary server, alternate servers tried in order, server password, TLS version and certificate pinning |
| Identity | A shared identity, or this network’s nickname, alternate nicknames, username and real name; nickname recovery and away |
| Channels and automation | Channels to join on connect (with optional keys), auto-join on invite, automation rules and commands after connect |
| Alerts | Mute the network, service notice nicknames such as NickServ and ChanServ, notify list and ignored users |
| Security | SASL authentication, client certificate, pinned login certificates and proxy |
| Advanced | Text encoding, default quit, part and kick messages, reconnect, typing indicators, CTCP replies and background presence |


Shared identities
An identity holds a nickname, alternate nicknames, username and real name. Create one in Settings → Identities and choose it in several networks’ Identity section; changes apply the next time each network connects.

Authentication
In Security, choose a SASL Mechanism:
| Mechanism | Use it for |
|---|---|
| Automatic | Uses the strongest password mechanism the server offers |
| SCRAM-SHA-512 / SCRAM-SHA-256 / SCRAM-SHA-1 | Password login that doesn’t send the password itself |
| PLAIN | Password login; use it only over TLS |
| EXTERNAL | Login with a client certificate (CertFP) |
| OAUTHBEARER | Login with an OAuth 2.0 provider |
Passwords are stored only in the iOS Keychain. The account defaults to your nickname when left blank.


Client certificates. Tap Import Client Certificate and choose a PKCS#12 file (.p12 or .pfx). The private key is kept in the Keychain and the passphrase is used once, during import. IRCpug presents the certificate only to the server hostnames you approve. Use it with SASL EXTERNAL or with servers that identify you by certificate fingerprint.
OAUTHBEARER. Enter the provider’s HTTPS authorization and token endpoints, a public client ID, scopes and an optional authorization identity. Register pl.prawel.ircpug.oauth:/callback as the client’s redirect URI, save the network, then tap Authorize with Browser. Security shows whether the network is authorized and when its token expires, and lets you reauthorize or remove the tokens.
Proxies
Proxy in Security routes the network through SOCKS5, SOCKS4/4a, HTTP CONNECT or the system SOCKS proxy, with an optional proxy password and a choice of resolving server names locally or through the proxy. Use Tor SOCKS5 Preset fills in 127.0.0.1:9050 with DNS resolved by the proxy. When a proxy is set and fails, IRCpug doesn’t fall back to a direct connection. WebSocket servers can’t be used through a proxy.
Bouncers
IRCpug works with soju and ZNC:
- soju: history is synchronized with CHATHISTORY, read markers are shared with your other clients, soju Manager in the network menu adds, edits and removes upstream networks, and FILEHOST uploads and Background Notifications are available.
- ZNC: IRCpug uses the
playbackmodule when it is loaded, so only messages you missed are replayed.
Turn on Advanced → Background Presence to disconnect cleanly when IRCpug goes to the background and reconnect when it returns. It is on by default for networks linked through soju, which keeps you in your channels upstream.
File Transfers
FILEHOST uploads. On networks that advertise FILEHOST (such as soju), the paperclip in the message field uploads a file and inserts its link into your draft. Long pastes can also be uploaded as a link; you choose the threshold in Settings → Input. Links are never sent automatically.
DCC. IRCpug supports DCC SEND and CHAT, both active and reverse. Incoming offers appear in the Inbox and in File Transfers, which shows the sender’s address and how IRCpug will connect before you Accept. DCC files are unauthenticated and unencrypted, so accept files only from someone you recognize. Received files are kept in IRCpug’s storage, where you can share them.

Keep IRCpug open while sending or receiving: iOS may suspend a transfer in the background. Settings → General → Keep Screen Awake During File Transfers helps with large files. DCC Trusted Senders in General lets offers from senders matching a mask such as Nick!~user@host.name skip the confirmation on one saved network.
FiSH Encryption
IRCpug can read and send FiSH-encrypted messages in channels and private conversations that share a key with other FiSH clients. Set a key with /key <shared-key> or FiSH Encryption in the conversation’s ⋯ menu; /showkey tells you whether a key is set and /delkey removes it. Both ECB and cbc: keys are supported. Keys are kept in the Keychain and never appear in input history.
FiSH is a legacy scheme kept for compatibility. It doesn’t authenticate senders, so don’t rely on it the way you would on an end-to-end encrypted messenger.
Settings
Settings opens from the gear at the top of Chats. Type in Search settings at the bottom to find any option by name.


| Section | What it controls |
|---|---|
| General | Reopen the last conversation, keep the screen awake, DCC trusted senders, automatic away, iCloud Sync and profile import and export |
| Appearance | Light, dark or system appearance, transcript colour schemes and text size |
| Messages | Log or Stacked layout, monospace text, event messages, dividers, coloured nicknames, timestamps, formatting and the highlight colour |
| Input | Spell checking, slash commands and aliases, emoji shortcodes, multiline send confirmation and paste-as-link |
| Notifications | Alert types, sounds and Background Notifications |
| Privacy | Remote content: network icons, inline images, videos, link previews and avatars |
| Identities | Shared identities used by several networks |
| App Storage & Secrets | History export and deletion, saved Keychain items and Strict Transport Security policies |
| Help | Topic guides and the command reference |
| About | Version, Report a problem and Rate IRCpug |


Layout. Log puts the nickname, with the time under it, in a column beside the message. Stacked puts the nickname above the message, so the message uses the full width. Both are in Settings → Messages.
Help in Settings has short guides for getting started, Chats, conversations, the Inbox and search, notifications, commands and privacy, and opens the command reference.


Privacy And Data
- Passwords and keys — server passwords, SASL passwords, OAuth tokens, proxy passwords, channel keys, FiSH keys and client certificates are stored in the iOS Keychain.
- History stays on this device. Export it as plain text or delete it in Settings → App Storage & Secrets.
- Remote content is off by default. Settings → Privacy has a separate switch, with an explanation, for network icons, inline images, automatic image loading, inline videos, link previews and remote avatars. Images load only over HTTPS, through the network’s proxy when one is set, and without cookies or referrers.
- iCloud Sync, in Settings → General, shares your networks, identities and appearance with your other devices. Passwords and message history are not synced.
- Reporting. IRC has no standard way to report abuse. Report Message… in a message’s actions, and Report User… in the member list, prepare a report you review, then email, share or copy. Message text is left out unless you include it, and nothing is sent until you choose to.


Compatibility
IRCpug follows the Modern IRC client protocol, RFC 2812 and ratified IRCv3 specifications, and adapts to what each server advertises. Features a server doesn’t support are hidden or explained, rather than failing silently.
| Requirement | |
|---|---|
| Devices | iPhone and iPad, including iPhone Duo |
| System | iOS and iPadOS 17 or later |
| Languages | English, German, Polish, Hindi, Simplified Chinese, Spanish, French, Japanese |
| Account | None. IRCpug has no sign-in |