WeeChat

WeeChat is Article description::a light, extensible, actively maintained, well documented, highly featured text-mode [[IRC client.]] WeeChat natively runs through ncurses for the text-mode interface, however for user convenience many 'remote' interfaces (GUIs) are available to relay WeeChat data to more accessible mediums (Android phones, Web interfaces, X GUIs, and more).

Configuration
An excellent quick start guide can be found on WeeChat's website. The official guide should be followed for the most up to date configuration instructions. Head over there and read the guide. When finished return here if necessary for further instructions.

Auto-join channels
After making it through step 7 in the WeeChat quick start guide Libera.Chat should be added as the server. Custom channels can be automatically joined each time WeeChat is opened by running the following command inside the WeeChat client:

This should add the and  channels to the auto-join list each time  starts. Add or subtract more more channels to the comma separated list as desired. Everyone has their own channels interests!

Adding a relay
In order to use remote interfaces, WeeChat needs to be configured as a relay.

Next set the password for the relay:

Remote interfaces
The following remote interfaces are available:


 * Glowing Bear - A web frontend for WeeChat. See the Glowing Bear Guide for hosting Glowing Bear on Gentoo.
 * QWeeChat - A Qt interface for WeeChat.
 * WeeChat Android - Only works on Android phones. Simply download the application from the Google Play Store and get started!
 * Emacs - A weird emacs thing.
 * WeeCloud - A WeeChat client written in javascript.

Each remote interface has a unique setup. Not all of the clients available in the list above may be operational. Glowing Bear is probably the most tested of the bunch. When in doubt try Glowing Bear first.

Plugins
Plugins for WeeChat can be added and removed via USE flags. See the USE flags section above for a list of available plugins.

Hardening
Occasionally spammers/trolls will attempt to scrape IRC networks for any relevant information they can find exposed about the IRC connection. Those concerned about hardening can restrict WeeChat to not provide specific details concerning their use.

These options can be set by hand in the file.

CTCP
To block CTCP requests set an empty string:

Part and quit messages
Nullify the part and quit messages:

Usage
It is common for many text-mode IRC client users to run the clients on a system that is always on always connected to the internet. This make it possible to never miss a mention or a message. Like most command-line programs, will run all the time if opened in a  or a  session which is then detached. This is currently the ideal method for staying connected to IRC networks continuously.

screen
Open using the following command:

After is configured press + to enter Command Mode and then  to detach from the  session. It can be re-attached to later by running:

To list the currently running sessions and then entering:

Where  is a weird, crazy string.

For additional information on how to use visit the screen article.

tmux
To open a new session for, the following command can be used:

To start it as a daemon, use:

To attach to the session (if started as a daemon), run:

This can be executed on login using:

After has been configured, disconnect from the session by using + and then press  to detach.

In order to reconnect to the session that is running (which was titled weechat) issue:

For additional information on how to use visit the tmux article.

Upgrades
After emerging updates, can be 'in-place' upgraded without losing the currently open buffer list. This is performed by running the following command inside the weechat client:

See the upstream user guide for more additional details.

Configuration and logs
After unmerging, for a full clean-up, be sure to remove old logs and individual user configuration from their default location in each user's home directory:

External resources

 * FAQ (official) - A list of Frequently Asked Questions concerning WeeChat.
 * Quick Start guide (official) - WeeChat's excellent little Quick Start guide. It covers all the steps needed in order to connect to an IRC server, set up a nick name, etc. It's well worth the 5 minute read time.
 * User's guide (official) - An in-depth user guide. Helpful for those who desired to become deeply familiar with WeeChat. It is also helpful as reference material.
 * Scripting guide (official)
 * Plugin API reference (official) - Want to write a remote interface (front end) for WeeChat? This is one of the articles for that.
 * Relay protocol (official) - This is another article that will need to be covered in order to write a remote interface (front end) for WeeChat.
 * Developer's guide (official) - Want to develop WeeChat itself? Reading this guide will help with that goal.