IRC Link: Linking your IRC identity

IRC Link connects your IRC identity (nickname + hostmask) to your IRC Driven account. There are two ways to be recognized by the bot: add your host manually with auto-login, or use the bot's LOGIN command and complete the two-step auth. Unless you add your host manually and have auto-login enabled, you must use LOGIN and complete the second step.

What is IRC Link

IRC Link lets the channel bot know who you are on IRC. Once linked, you can use admin commands, get personalized features (e.g. !weather with your saved location), and have your channel activity tied to your profile. The bot only recognizes you from trusted hosts—hostmasks you have explicitly added. You add hosts either manually on the website or via the two-step process when using LOGIN from an untrusted host.

Prerequisites

• An IRC Driven account and a channel with the IRC Driven bot enabled.
• Access to the IRC Link settings page (from your profile or the user menu).

Option A: Add your host manually and use auto-login

If you add your host manually and enable auto-login, the bot will recognize you automatically when you join a channel. No LOGIN command is needed.

1. Go to IRC Link settings.
2. In Add Trusted Host, enter your IRC ident (username) and hostname. You can use wildcards: * (any characters), ? (single character). Example: ~daniel and *.ircdriven.com.
3. Choose Require Strict Ident Match if your ident has no ~ prefix (identd responded). Leave it off if your ident starts with ~.
4. Click Add Host.
5. Enable Enable Auto-Login in the Authentication Settings section.
6. Click Save Settings.

When you join a channel on the network, the bot matches your hostmask against your trusted hosts and logs you in automatically. You will not need to run LOGIN.

Option B: Use LOGIN and complete two-step auth

If you do not add your host manually and enable auto-login, you must authenticate using the bot's LOGIN command. From a host that is not yet trusted, LOGIN triggers a two-step process.

Step 1: Run LOGIN on IRC

1. Go to IRC Link settings and generate an authentication token (or copy your existing token).
2. Send a private message to the bot: /msg BotNick LOGIN yourusername yourtoken

Step 2: Two-step auth for new hosts

If your current host (ident@hostname) is not in your trusted hosts list, the bot will respond with a message like:

"This host is not trusted. To add it, open this link and log in as yourusername to confirm:"

and give you a confirmation URL. You must:

1. Open the URL in your browser.
2. Log in to IRC Driven as your username (if not already logged in).
3. Click Confirm to add this host as a trusted host.

After confirming, your host is added. Run /msg BotNick LOGIN yourusername yourtoken again on IRC. The bot will now accept the LOGIN and create a session. You can then enable auto-login in IRC Link settings if you want to be recognized automatically from this host in the future.

If you skip the confirmation step, LOGIN will continue to fail from that host until you either add the host manually on the website or complete the two-step confirmation.

Managing trusted hosts

On the IRC Link settings page, the Trusted Hosts section lists all hosts you have added. Each host shows whether it uses strict or flexible ident matching. To remove a host, click the remove (trash) button next to it. After removing a host, you will need to re-authenticate from that host (either add it again manually or complete the two-step process via LOGIN).

Managing sessions

Active sessions appear in the Active Sessions section of the IRC Link page. Each session shows the network, your nickname, and whether you are currently online or when you were last seen. Sessions are created when you log in via the bot (either through auto-login or LOGIN).

To log out from IRC, send the bot: /msg BotNick LOGOUT. This ends your session on that network. Your trusted hosts remain; you can log in again with LOGIN or auto-login when you rejoin.

IRC Link settings overview

On the IRC Link page you can configure:

• Authentication Token — Used with the LOGIN command. Generate a new token if needed; keep it secure.
• Weather Location — Set via the map. Enables !weather without specifying a location when logged in.
• Enable Auto-Login — When on, the bot recognizes you automatically from your trusted hosts when you join.
• IRC Notifications — Opt-in notifications via IRC when you are logged in.

Related

• Editing your profile — Profile settings and notification preferences.
• Channel Bot FAQ — Commands, features, and troubleshooting.