Short quickstart on tmux & WeeChat for GUIless support
Sometimes you don’t have GUI when you need remote support, luckily you don’t need it even if you have only one device.
Automaattinen sisällysluettelo / Automatically generated Table of Contents
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 user’s 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.
- Add the network to WeeChat.
- liberachat:
/server add liberachat irc.libera.chat/6697 -ssl -autoconnect
- liberachat:
- Connect there.
/connect liberachat
- 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 can also join multiple channels at once by separating them by commas
e.g.
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).
/script install buffers.pl
/mouse enable
Now you should see bar with the core buffer (weechat
), server buffers merged
to it (liberachat
) and #distribution
. If mouse doesn’t 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 offile.txt
dmesg | pastebinit
to pastebin output ofdmesg
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
- tmux
- my ~/.tmux/tmux.conf
- Hawk Host Blog which was very helpful to me when I started using tmux.
man tmux
- WeeChat
- WeeChat documentation index (multiple languages
- My IRC page
- At the time of writing there are two posts about WeeChat.
- pastebinit
- pastebinit homepage
man pastebinit