II(1)

🌸 NAME 🌸

ii — it's irc it or, if you're feeling fancy, irc improved 💅

---

✨ SYNOPSIS ✨

ii -s host [-p port | -u sockname] [-i ircdir] [-n nickname] [-f
realname] [-k env_pass]

---

🦋 DESCRIPTION 🦋

okay so bestie, ii is a minimalistic FIFO and filesystem based IRC client. literally that's the whole vibe. it makes you an irc directory tree with server, channel and nick name directories, and in every single one of those directories it drops a FIFO file (that's in) and a normal file (that's out). 🎀

so like, for example, this is gonna be ~/irc/irc.freenode.net/. the in file is how you talk to the servers, and the out files hold the server messages. for every channel and every nick name you get brand new in and out files. slay.

the whole basic idea — and honestly it's iconic — is that you can talk to an IRC server using basic command line tools. fr fr. for example, if you wanna join a channel you literally just do echo "/j #channel" > in and boom, ii creates a new channel directory with an in and an out file. main character energy only. 👑

---

💖 OPTIONS 💖

• -s host — the server/host you're connecting to, for example: irc.freenode.net
• -p port — lets you override the default port (6667)
• -u sockname — connect to a UNIX domain socket instead of going directly to a server. and listen, if you set this, the -p option gets ignored. periodt.
• -i ircdir — lets you override the default irc path (~/irc)
• -n nickname — lets you override the default nick ($USER)
• -f realname — lets you specify your real name that's associated with your nick
• -k env_pass — lets you specify an environment variable that contains your IRC password, e.g. IIPASS="foobar" ii -k IIPASS. the whole reason this exists is to prevent other users from eavesdropping the server password via the process list. sneaky-proof, we love to see it 🫶

---

🎀 DIRECTORIES 🎀

• ~/irc — in this directory the irc tree gets created. in here you'll find a directory for your server (default: irc.freenode.net) and inside that the FIFO and the output file get stored. and if you join a channel, a new directory with the name of the channel gets created inside the ~/irc/servername/ directory. nesting, but make it cute 🦋

---

⭐ COMMANDS ⭐

• /a [message] — mark yourself as away, and you can pass the optional message as an away reason.
• /j #channel [password] — join a #channel, with the optional password.
• /j nickname [message] — open a private conversation with user nickname and directly send the optional message.
• /l [reason] — leave a channel or query, giving the optional reason message.
• /n nick — change the nick name to nick.
• /q [reason] — quit ii, giving the optional reason message.
• /t topic — set the topic of a channel with topic.

---

🌈 RAW COMMANDS 🌈

everything that is not a command gets posted into the channel or to the server. so if you need /who, just write /WHO as described in RFC#1459 to the server in the FIFO. iykyk 💜

---

🔥 SSL/TLS PROTOCOL SUPPORT 🔥

for SSL/TLS protocol support you can connect to a local tunnel, for example with stunnel or socat. cute and secure, no cap. 🍓

---

👑 SEE ALSO 👑

echo(1), tail(1)

---

ok that's the whole page bestie, go forth and echo things into FIFOs responsibly 💖✨

this has been ii-2.0, from the General Commands Manual — mwah, take care of her, she's iconic 💅🎀