irssi/README.md
steering7253 438bac4c8d
🚀
2025-09-10 13:24:22 -06:00

80 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# The Ultimate IRC Experience: Irssi ✨ 🚀
Irssi is the modular, **text-mode chat client** that puts you in control. 🧑‍💻 It comes with built-in **IRC** support, and its extensible design lets you connect to other chat networks, including **ICB** 💬, **SILC** 🔒, **XMPP** (Jabber) 🕊️, **PSYC** 🧠, and **Quassel** 🏘️, via third-party modules. Its the perfect tool for developers, sysadmins, and anyone who prefers the power and efficiency of the command line. 💻
-----
## Getting Started 🚀
### Installation 🛠️
There are a few ways to get Irssi up and running. If you're looking to contribute to development, you'll want the latest source. For a stable release, you can download a pre-packaged tarball. 📦
**Development Source Installation**
To get the absolute latest features and fixes, clone the Git repository and build the project using **Ninja** and **Meson**. 👨‍💻
```sh
git clone https://github.com/irssi/irssi
cd irssi
meson Build
ninja -C Build && sudo ninja -C Build install
```
**Release Source Installation**
For a stable, tested version, download the official release from GitHub. Be sure to verify the signature for a secure installation. 🔐
```sh
tar xJf irssi-*.tar.xz
cd irssi-*
meson Build
ninja -C Build && sudo ninja -C Build install
```
**System Requirements**
Before you start, make sure you have the following dependencies: 👇
* **glib-2.32** or greater
* **openssl** 🛡️
* **perl-5.8** or greater (for Perl support) 🧩
* **terminfo** or **ncurses** (for the text frontend) 🖥️
For more detailed instructions, check the **INSTALL** file. 📄
-----
## Dive into the Details 📖
### Documentation 📚
Whether you're a new user or a seasoned pro, the Irssi documentation is your best friend. 🤝
* **New User's Guide** 👶: A gentle introduction to the basics.
* **Questions and Answers** ❓: Find quick solutions to common issues.
* **Built-in Help** `/HELP` 💡: Use the `/HELP` command directly in Irssi for detailed information on every command and syntax.
### Customization ✨
Make Irssi your own with a vibrant community of themes, scripts, and modules. 🎨
* **Themes** 🌈: Customize the look and feel of your chat client.
* **Scripts** ✍️: Extend functionality with user-created scripts.
* **Modules** 🏗️: Add support for new protocols or features.
-----
## Community & Support 🫂
### Get Involved 👋
Irssi is an **open-source project** and thrives on community contributions. We're always looking for new developers\! 🌟
* **Bug Reports & Suggestions** 🐞💡: Have a problem or a great idea? Check the [GitHub issues](https://github.com/irssi/irssi/issues) to see if it's already been reported, or open a new one. You can also email us at **staff@irssi.org**. 📧
* **Contributions** 💖: Feel free to submit patches via **GitHub pull requests**.
* **Chat with us\!** 🗣️: You can find the developers and other users in **\#irssi** on irc.libera.chat. 💬
### Security 🛡️
We take security seriously. If you discover a security issue, please report it privately to **staff@irssi.org**. Your help in keeping Irssi secure is greatly appreciated. 🙏