mikaela.github.io/blog/_posts/2016-03-09-weechat-tmux-quickstart.md
Mikaela Suomalainen 9351e09a4a
Quickly point freenode -> LiberaChat where applicable
* ZNC had to have network name removed to avoid rewriting history.
* Keeping the ops opped is linked too widely and I just added a note
  that it also applies to LiberaChat directly
* umode+g I don't feel good about so I just removed it directly, I am
  not who I was in 2015.
  * references to it had to go away too
* LiberaChat runs Charybdis fork which removes the weird cmode +p
  behaviour to my knowledge
* Stagefright also couldn't have history changed so I just removed
  broken link and said it's now at LiberaChat
* ...
* TeleIRC instead of TeleMatrix had to go away, neither project is alive
  and due to freenode/LiberaChat situation living, I will hopefully
  update it to Matterbridge and more recent solutions in the future.
  TODO! Also RELAYMSG exists.
* links2: mostly dead links, but change network name
* r/chanserv: the link was dead
* r/mer-meeting: I don't think anyone uses that link and I have no idea
  if they are staying on freenode
* r/telefreenode.md: I imagine everyone has took anything useful from
  there a long time ago
2021-05-23 14:10:38 +03:00

4.7 KiB
Raw Blame History

Sometimes you dont have GUI when you need remote support, luckily you dont need it even if you have only one device.

What is what?

  • Tmux is terminal multiplexer which allows you to have “multiple terminals” in one terminal. You can also detach it which means returning to the terminal where you ran tmux leaving tmux and everything there running and later return to it.
  • WeeChat is popular text based IRC client.

Installing things

Note: WeeChat has multiple optional depedencies, but I am only listing the most important ones (I will return to it later) unless they are all in one package.

  • Arch & deriatives:
    • sudo pacman --needed -S tmux weechat perl gpm pastebinit
  • Debian & deriatives:
    • sudo apt-get install weechat-curses weechat-plugins gpm pastebinit

tmux

Just run tmux and you will find yourself in a new shell, but with tmux bar on the bottom where you see open “windows”.

Basic navigation:

*Note: Tmux users ctrl + b by default instead of ctrl + a as it was developed in screen. That can be changed with tmux.conf (check further reading after WeeChat).

  • Ctrl + b + c = new “window”
  • Ctrl + b + number = move to “window” number
  • Ctrl + b + x = kill “window”
  • Ctrl + b + w = interactive “window” selection
  • Ctrl + b + d = detach tmux (return with tmux attach)

WeeChat

Time to finally go to IRC. Go to tmux first and there run weechat (or if your distribution has ancient version of WeeChat, weechat-curses, but in that case you should upgrade (if your distribution is Debian/Ubuntu/Raspbian, use this repository)).

WeeChat welcomes you and suggests you to read at least the quickstart guide and recommends reading users guide too, but in this case we can skip those.

First we must connect to the network where the support channel of our distribution is.

  1. Add the network to WeeChat.
    • liberachat: /server add liberachat irc.libera.chat/6697 -ssl -autoconnect
  2. Connect there.
    • /connect liberachat
  3. Join the channel of your distribution.
    • /join #distribution
      • you can also join multiple channels at once by separating them by commas e.g. /join #channel,#channel2.

You might want to have friendly channel listing and be able to click the channels with mouse? That is why you installed perl and gpm (you might need to sudo systemctl start gpm or whatever init system you use).

  1. /script install buffers.pl
  2. /mouse enable

Now you should see bar with the core buffer (weechat), server buffers merged to it (liberachat) and #distribution. If mouse doesnt work, you can /buffer X where X is the number to move. For moving between merged buffers move to the buffer and press Ctrl + x.

And the last thing, if you need to see just plain lines without sidebars or anything, press alt + l (alt can be replaced with esc).

pastebinit

You are often wanted to pastebin something which can be difficult without GUI. Luckily there is pastebinit which you can use instead of typing everyting by hand.

Usage:

  • pastebinit file.txt to pastebin the content of file.txt
  • dmesg | pastebinit to pastebin output of dmesg

Pastebinit replies by givig you address to the paste which you can then give to IRC.

Alternatives to pastebinit with some pastebins:

  • ix.io: command | curl -F 'f:1=<-' ix.io
  • sprunge.us: command | curl -F 'sprunge=<-' http://sprunge.us

These also answer by giving you link to the paste.

Further reading