IRC URL Scheme

Home

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
 
Last modified: August 01, 2017
The contents of this webpage are released into the Public Domain for unlimited distribution.