|
Size: 4086
Comment:
|
← Revision 25 as of 2022-12-14 14:43:20 ⇥
Size: 7535
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| #pragma keywords howto, irc, irssi, screen, gnu screen, tutorial | |
| Line 2: | Line 3: |
| [[TableOfContents()]] | <<TableOfContents>> |
| Line 4: | Line 5: |
| == Lesson 1 == In this lesson, you will learn how to make some basic usage out of your new shell account. We will concentrate on how to connect to IRC with the IRC-client irssi and how to stay connected even when your computer is turned off via a helper program called screen. |
== tmux + irssi = <3 == In this howto you will learn how to use your shell account for possibly the best [[Info/IRC|IRC]] solution possible ;) We will concentrate on how to connect to IRC with the IRC-client [[irssi]]<<FootNote(http://www.irssi.org/)>> and how to stay connected even when your computer is turned off via a program called [[tmux]]. === tmux === tmux is a program that creates a virtual terminal inside your shell. You can then "detach" or "attach" this virtual terminal when you log in and out from your shell account. The programs you have running inside the virtual terminal (tmux) will keep running on the server after you've logged off. Perfect for IRC, this way you will always be able to see what's been said in the chat while you were away/sleeping etc. |
| Line 10: | Line 16: |
| screen}}} This will create a new screen. A screen is like a window that you can leave open on the server even when you disconnect. This is so that you can stay connected to IRC even when you disconnect from the shell server. |
tmux new -As irssi}}} |
| Line 13: | Line 18: |
| You can now start a program in this new screen. Start the IRC-client irssi for examlple: | This will create a new tmux session called "irssi". You can now start a program in this new tmux session. Let's start irssi: |
| Line 17: | Line 22: |
| You can now start using IRC. But before you start using IRC let's see how you can disconnect from the shell and then resume the same screen as you just started! | |
| Line 19: | Line 23: |
| . Start by closing the window you are connected with. Now let's connect to the shell again. When you have logged in, type this command to resume the screen you previously started: | You can now start chatting away, but before you start learning more about irssi let's see how you can disconnect from the shell and then resume the same tmux session as you just started! You can either just close the terminal window, or press and hold ctrl and then press b followed by d (ctrl-b d) to detach the tmux session, and then type `exit` or `logout` to log out. Now let's connect to the shell again. When you're in, use the `tmux a` command again to resume the previously started session. |
| Line 21: | Line 30: |
| screen -r}}} | tmux a}}} |
| Line 24: | Line 34: |
| Let's now learn some basics of irssi. Start by logging in to the shell and resuming the screen if you're not already connected. In irssi there is a command promt at the bottom. This is where you write messages and type in commands. Before you can start chatting, you have to connect to an IRC server and join a channel. To do this, type the following commands: | To exit a tmux session (destroy it, not just detach), exit the programs running inside it (`/quit` in irssi) and then type `exit` or `logout`. It's possible to have multiple sessions running, but this is not recommended. It can get very confusing if you are new to tmux. If you accidentaly do, just retach them one at a time and exit them. You can list all your sessions with this command: `tmux list-sessions` Another program very similar to tmux is GNU Screen, take a look at the [[Howto/Screen| Screen Howto]] if you prefer to use that. === Irssi === Let's now learn some basics of irssi. Start by logging in to the shell and resuming the tmux session if you're not already connected. In irssi there is a command promt at the bottom. This is where you write messages and type in commands. Before you can start chatting, you have to connect to an IRC server and join a channel. If you use the standard config for irssi (which you probably do), then you won't have to connect manually. Instead you should automatically get connected to our home IRC network and joined into #blinkenshell. If not (or if you want to learn how to connect to other IRC networks), use these commands to connect and join: |
| Line 27: | Line 49: |
| /CONNECT irc.systemshells.net | /CONNECT -ssl irc0.blinkenshell.org 6697 |
| Line 29: | Line 51: |
| The first command connects to shellsnet IRC-server. This might take a couple of seconds, so wait a bit before typing in the next command. The next command will connect you to our IRC channel #blinkenshell. | |
| Line 31: | Line 52: |
| Now you are connected, and you have two "tabs" open in irssi. One with the server messages and one with our IRC-channel. To change between them press and hold the ALT-key while pressing the 1-9 on your keyboard. ALT-2 will change to the IRC-channel so you can start chatting. ALT-1 will change back to the server message tab. Go to the second tab with ALT-2 and say hello to us! | The first command connects to BlinkenIRC server. This might take a couple of seconds, so wait a bit before typing in the next command. The next command will join you to our IRC channel #blinkenshell. Now you are connected, and you have two "windows" open in irssi. One with the server messages and one with #blinkenshell. To change between them press and hold the ALT-key while pressing the 1-9 on your keyboard. ALT-2 will change to the second window, which should be the #blinkenshell channel. ALT-1 will change back to the server message tab. Go to the second tab with ALT-2 and say hello to us! (You can also change windows by typing `/win 2` etc.) |
| Line 35: | Line 58: |
| You can connect to multiple networks by issuing the `/connect <server>` command several times. When you issue the join command, it will join the channel on the network that is currently selected. You can switch between the networks by pressing ctrl-x. To list all active connections to IRC networks, type `/server`. |
|
| Line 36: | Line 61: |
| Again, you don't have to do this if you already automatically gets connected to IRC. |
|
| Line 39: | Line 66: |
| /SERVER ADD -auto -network Systemshells irc.systemshells.net 6667 /CHANNEL ADD -auto #blinkenshell ShellsNet |
/SERVER ADD -network BlinkenIRC -tls -auto irc0.blinkenshell.org 6697 /CHANNEL ADD -auto #blinkenshell BlinkenIRC |
| Line 42: | Line 69: |
| Next time you start irssi, the program will automatically connect you to systemshells and join our IRC channel. | Next time you start irssi, the program will automatically connect you to BlinkenIRC and join our channel. You can also specify other networks and channels of course, just remember to not connect to any network twice! You can also make irssi automatically identify with [[NickServ]] when you connect to the network with the following command: {{{ /NETWORK MODIFY -sasl_username <nickserv_username> -sasl_password <nickserv_password> -sasl_mechanism plain BlinkenIRC }}} Replace '<nickserv_username>' '<nickserv_password>' with your NickServ account details. Use `/save` to save your changes. The configuration will be written to the file `.irssi/config` in your home directory. If you get confused about what networks you're getting auto-connected to or want to change an address, it might be easier to change in the config file. If you have a couple of channels in irssi that you have configured with autoconnect, you might want them to appear in the same windows every time you start irssi. You can move your windows around by changing to the window you want to move, and issuing the command: `/window move 3` to move that window to position 3 for exmaple. You can then save the "layout" of your windows with the command: `/layout save`. |
| Line 54: | Line 94: |
| Line 60: | Line 101: |
| Line 62: | Line 104: |
| '''Explanation of some common and useful scripts''' | === Explanation of some common and useful scripts === |
| Line 64: | Line 106: |
| * trackerbar - Prints a line where you last left of in a channel, so you easily can pick up your reading in the log when you come back. | * trackerbar - Prints a line where you last left of in a channel, so you easily can pick up your reading in the log when you check back. |
| Line 67: | Line 109: |
| Line 68: | Line 111: |
| * ["FAQ/DeadScreen"] - What to do when you can't resume a screen because it's "dead". | * [[Howto/IrssiTips]] - Tips and tricks for the irssi IRC client * [[FAQ/DeadScreen]] - What to do when you can't resume a screen because it's "dead". * [[FAQ/Unicode]] - Enable unicode to make local characters work properly. * [[Howto/Screen]] - More on how to use screen. * [[Howto/Autostart]] - How to automatically start Screen+irssi when the server starts. |
| Line 71: | Line 119: |
| * http://quadpoint.org/articles/irssi - "A Guide to Efficiently Using Irssi and Screen". |
Howto: IRC
Contents
tmux + irssi = <3
In this howto you will learn how to use your shell account for possibly the best IRC solution possible 
We will concentrate on how to connect to IRC with the IRC-client irssi1 and how to stay connected even when your computer is turned off via a program called tmux.
tmux
tmux is a program that creates a virtual terminal inside your shell. You can then "detach" or "attach" this virtual terminal when you log in and out from your shell account. The programs you have running inside the virtual terminal (tmux) will keep running on the server after you've logged off. Perfect for IRC, this way you will always be able to see what's been said in the chat while you were away/sleeping etc.
Start by logging in to your shell account and type the following command:
tmux new -As irssi
This will create a new tmux session called "irssi". You can now start a program in this new tmux session. Let's start irssi:
irssi
You can now start chatting away, but before you start learning more about irssi let's see how you can disconnect from the shell and then resume the same tmux session as you just started!
You can either just close the terminal window, or press and hold ctrl and then press b followed by d (ctrl-b d) to detach the tmux session, and then type exit or logout to log out.
Now let's connect to the shell again. When you're in, use the tmux a command again to resume the previously started session.
tmux a
Now you will be back in the program irssi you started before. This program kept running on the server the whole time you were disconnected!
To exit a tmux session (destroy it, not just detach), exit the programs running inside it (/quit in irssi) and then type exit or logout.
It's possible to have multiple sessions running, but this is not recommended. It can get very confusing if you are new to tmux. If you accidentaly do, just retach them one at a time and exit them. You can list all your sessions with this command: tmux list-sessions
Another program very similar to tmux is GNU Screen, take a look at the Screen Howto if you prefer to use that.
Irssi
Let's now learn some basics of irssi. Start by logging in to the shell and resuming the tmux session if you're not already connected. In irssi there is a command promt at the bottom. This is where you write messages and type in commands.
Before you can start chatting, you have to connect to an IRC server and join a channel. If you use the standard config for irssi (which you probably do), then you won't have to connect manually. Instead you should automatically get connected to our home IRC network and joined into #blinkenshell.
If not (or if you want to learn how to connect to other IRC networks), use these commands to connect and join:
/CONNECT -ssl irc0.blinkenshell.org 6697 /JOIN #blinkenshell
The first command connects to BlinkenIRC server. This might take a couple of seconds, so wait a bit before typing in the next command. The next command will join you to our IRC channel #blinkenshell.
Now you are connected, and you have two "windows" open in irssi. One with the server messages and one with #blinkenshell. To change between them press and hold the ALT-key while pressing the 1-9 on your keyboard. ALT-2 will change to the second window, which should be the #blinkenshell channel. ALT-1 will change back to the server message tab. Go to the second tab with ALT-2 and say hello to us! (You can also change windows by typing /win 2 etc.)
When you want to turn off the computer just close the window and you can then resume the screen the next time you want to use IRC and your session of irssi will be there waiting for you, running at the server at all times!
You can connect to multiple networks by issuing the /connect <server> command several times. When you issue the join command, it will join the channel on the network that is currently selected. You can switch between the networks by pressing ctrl-x. To list all active connections to IRC networks, type /server.
Autoconnect
Again, you don't have to do this if you already automatically gets connected to IRC.
Start irssi and type these commands to automatically join the official IRC channel each time you start irssi:
/SERVER ADD -network BlinkenIRC -tls -auto irc0.blinkenshell.org 6697 /CHANNEL ADD -auto #blinkenshell BlinkenIRC
Next time you start irssi, the program will automatically connect you to BlinkenIRC and join our channel.
You can also specify other networks and channels of course, just remember to not connect to any network twice!
You can also make irssi automatically identify with NickServ when you connect to the network with the following command:
/NETWORK MODIFY -sasl_username <nickserv_username> -sasl_password <nickserv_password> -sasl_mechanism plain BlinkenIRC
Replace '<nickserv_username>' '<nickserv_password>' with your NickServ account details.
Use /save to save your changes. The configuration will be written to the file .irssi/config in your home directory. If you get confused about what networks you're getting auto-connected to or want to change an address, it might be easier to change in the config file.
If you have a couple of channels in irssi that you have configured with autoconnect, you might want them to appear in the same windows every time you start irssi. You can move your windows around by changing to the window you want to move, and issuing the command: /window move 3 to move that window to position 3 for exmaple. You can then save the "layout" of your windows with the command: /layout save.
Added functionality via scripts
You can load scripts to provide additional functionality. You can find pre-installed scripts in /usr/share/irssi/scripts
Descriptions of what the scripts does can be found by viewing the script in a text editor like nano and reading the comments at the top of the source.
To load a script, type:
/SCRIPT LOAD trackbar.pl
To add autoload scripts when starting irssi, you can add a symlink like this:
cd .irssi/scripts/autorun ln -s /usr/share/irssi/scripts/trackbar.pl ./
You might have to create the directories scripts and autorun if you have not used scripts before.
Explanation of some common and useful scripts
- trackerbar - Prints a line where you last left of in a channel, so you easily can pick up your reading in the log when you check back.
- screen_away - Automatically sets your status to away if you detach your screen.
- usercount - Adds an item that displays the number of users in the statusbar.
More
Howto/IrssiTips - Tips and tricks for the irssi IRC client
FAQ/DeadScreen - What to do when you can't resume a screen because it's "dead".
FAQ/Unicode - Enable unicode to make local characters work properly.
Howto/Screen - More on how to use screen.
Howto/Autostart - How to automatically start Screen+irssi when the server starts.
External links
http://irssi.org/documentation/startup - Startup howto on irssi's website.
http://quadpoint.org/articles/irssi - "A Guide to Efficiently Using Irssi and Screen".