TINY(1)

📦 version 0.13.0, in ubuntu stonking

💖 TINY(1) — omg it's the tiny manpage 💖

okay bestie, welcome to TINY(1) — yes, that's the manual name, that's literally the whole vibe. Sit down, grab a boba, and let's learn the tiny IRC client together, because this thing is iconic and you're about to be obsessed. 🫶

✨ NAME ✨

tiny — the minimal IRC client for people who hate using the mouse. that's it. that's the pitch. no cap. 💅

🌸 SYNOPSIS 🌸

tiny [options]

🦋 DESCRIPTION 🦋

okay so Tiny — yes it's called Tiny twice sometimes, it's giving "Tiny Tiny" and honestly, slay — is a console-based IRC client written in Rust, and it was designed to be simple, efficient, and reliable. 🎀

It's got a split-view interface with channels, it supports multiple servers at the same time (multitasking queen behavior), and it has native TLS encryption so your connections are secure. 🔒✨

It's lightweight, it's fast, and the only IRC server interactions it hands you are the standard ones — through hotkeys and the CLI. nothing extra, nothing messy. main character minimalism. 👑

🌈 USAGE 🌈

bestie there are literally two ways to connect to an IRC network. pick your fighter:

1. Manual 🖐️

To start the client, you literally just type:

tiny

Then connect to a network like:

/connect irc.oftc.net:6697

Then pick the nickname you want to use:

"nickname your name"

2. Automatically 🤖✨

You can configure your servers in ~/.config/tiny/config.yml: — plus your nicknames, your real names, and you can even automate channel insertions and automate channel joins. yes, it's as powerful as it sounds.

Example:

servers:
  libera:
    addr: irc.libera.chat:6697
    tls: true
    nicks: [your_nick]
    realname: Your Name
    auto_cmds:
      - JOIN #debian

Notes:

If nothing happens, congratulations — you might need an internet connection. 😭
Just don't mess up the indentation. YAML is finicky. fr fr. one wrong space and it's over for you. 🙈

💅 KEYBOARD SHORTCUTS 💅

All shortcuts use the Ctrl key. If you're reaching for the mouse, you're already doing it wrong. periodt. 🖱️🚫

  • Ctrl + A / Ctrl + E — move the cursor to the beginning / end of the line. yes queen, teleport.
  • Ctrl + K — delete everything from the cursor to the end of the line. bye forever 💀
  • Ctrl + W — delete the previous word.
  • Ctrl + Left / Ctrl + Right — jump one word back / forward.
  • PageUp / PageDown, Shift + Up / Shift + Down, Ctrl + U / Ctrl + D — scroll the chat, because apparently you missed something important. 😭 every single time.
  • Ctrl + N / Ctrl + P — switch to the next / previous tab.
  • Ctrl + C Enter — exit Tiny. it will ask you first, in case you have regrets. 🥺
  • Alt + 1..9 — switch to the Nth tab.
  • Alt + 0 — switch to the last tab.
  • Alt + Left / Alt + Right — move the tab left / right — rearrange your chaos however you want, bestie. 🌀
  • Alt + char — jump to a tab containing the underlined character.
  • Ctrl + X — edit the current message in your $EDITOR, because apparently a line editor wasn't enough. 💀

🎀 COMMANDS 🎀

Every single command begins with a slash (/). If you forget that, you'll just be talking to yourself. and honestly? relatable. 🙈

  • /help — show this list of commands. If you're reading this, good job. 👑
  • /msg <nick> <message> — send a private message. because whispering is still a thing. 🤫
  • /join <channel> — join a channel. Example: /join #debian
  • /close [reason] — close the current tab. you can even provide a dramatic exit reason. give the people a show. 🎭
  • /connect <host>:<port> — connect to a server. Example: /connect irc.libera.chat:6667
  • /connect — reconnect to the current server, without waiting for the client to decide for you. you're in charge. 💪
  • /away [message] — set your away status with a message.
  • /nick <nick> — change your nickname. try not to choose something embarrassing. (we're watching. 👀)
  • /names [nick] — list the users in the current channel, or check whether a nick is present.
  • /reload — reload the TUI configuration. magic, without restarting. ✨
  • /clear — wipe the screen. feels good, doesn't it? 🧼
  • /switch <string> — switch to the first tab matching the given string.
  • /ignore — toggle ignore mode for join/quit spam. peace and quiet, finally. 🕊️
  • /notify [off|mentions|messages] — control desktop notifications: none, mentions only, or everything.
  • /quit [reason] — quit Tiny. you can say goodbye like a civilized person. 🫶

⭐ SERVER COMMANDS ⭐

Some IRC commands are not built-in. Send them directly in a server tab and hope for the best. 🍀 Examples:

  • LIST — list available channels
  • MOTD — display the message of the day
  • RULES — show server rules
  • WHOIS — query information about a user
  • VERSION — ask the server what century it's from 💀

🍓 TIPS 🍓

  • Use /reload after editing the config. Restarting is for the weak. 💅
  • If Tiny freezes, hit Ctrl + C twice — it's the Unix way of saying "wake up." ⏰
  • To look extra cool, run Tiny in a tmux session and never close it again. 🔥

🔥 SEE ALSO 🔥

community — of Tiny documentation: https://github.com/osa1/tiny

💜 AUTHOR 💜

Written by Tiny. Manual organized and compiled by the Debian maintainer by Josenison Ferreira da Silva <nilsonfsilva@hotmail.com>

and that's the whole thing bestie!! 🌈✨ this was Tiny Manual, version-dated July 2025, filed under TINY(1) — go forth and IRC like the icon you are. 🎀💖 mwah.

📦 where this page comes from