IRC URL Scheme
Historical reference: iRC URL Scheme.
A reference from an earlier chapter
This material preserves the original Textual documentation and may describe older versions, former services, or superseded policies. It is not a statement of current availability or new Blendbyte commitments.
For current guidance: IRC links and URL schemes.
On this page
This knowledge base article documents the URL scheme that is recognized by Textual for creating new connections.
Format
<scheme>://<address>:<port>/[#channel[,#channel]]
Required Components
<scheme> can be “irc” or “ircs” — SSL/TLS is enabled if <scheme> is “ircs”
<address> can be a fully qualified domain name, an IPv4 address, or an IPv6 address.
Optional Components
<port> is any whole number between 1 and 65,535. 6667 is used as the default if <port> is not specified.
[#channel] is a list of up to five (5) channels, each separated by a comma, that are added to the new connection.
Privacy Considerations
A connection that is created by clicking a URL does not automatically connect when added. This is done to protect the identity of the user. If the user has their browser configured to a connect through a proxy, but not Textual, then having the user click on a link could lead to their IP address being leaked before they have a chance to stop it.
Examples
irc://irc.example.com
irc://irc.example.com:6667
irc://irc.example.com/#channel - Connect to #channel
irc://127.0.0.1/
irc://127.0.0.1:6667
irc;//127.0.0.1/#channel
irc://[fda4:22f1:8d20::]/
irc://[fda4:22f1:8d20::]:6667
irc://[fda4:22f1:8d20::]/#channel
ircs://irc.example.com:6697/#channel - Connect to #channel using SSL
ircs://irc.example.com:6697/#channel1,#channel2 - Connect to #channel1 and #channel2 using SSL
Keep reading
Source material
Original Codeux material preserved from the knowledgebase snapshot of 9 September 2026. Formatting and internal links have been adapted for this site.
Need a hand? Contact us about this guide.