psyBNC
From SHellium Wiki
In other languages: English | Afrikaans | Albanian | Arabic | Brazilian | Bulgarian | Catalan | Chinese | Croatian | Czech | Danish | Dutch | Esperanto | Estonian | Filipino | Finnish | Flemish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Latvian | Lithuanian | Macedonian | Malay | Malayalam | Norwegian (Bokmål) | Norwegian (Nynorsk) | Persian | Polish | Portuguese | Romanian | Russian | Serbian | Slovak | Slovenian | Spanish | Swedish | Turkish | Ukrainian | UrdupsyBNC is a IRC bouncer that supports IPv6, bouncer linking, multiple networks, and bouncer channels.
Something not covered in this HOWTO? Feel free to add it!
Contents |
Please remember!
A psybnc running on a SHellium shell is allowed 4 connections, 3 users plus the owner of the shell. Any more than 4 connections will result in your shell account being locked.
Also remember to run the 'myports' command when using any process requiring ports. This command will show you your two (2) assigned ports, and if you are running any ports that do not belong to you. Running any port or ports other than the two assigned to you will lock your account.
psyBNC simple installation (by KatieKitty and Quickz)
First download psyBNC to the shell. You can use the wget command from the SSH terminal for this, type:
wget http://www.psybnc.at/download/beta/psyBNC-2.3.2-7.tar.gz
To extract its contents, type:
tar -zxvf psyBNC-2.3.2-7.tar.gz
After the files are extracted, type:
myports
This will show your assigned ports, you have to use one of them to set the port of the BNC, so pick one and remember it, you will need it in a minute.
Now it's time to edit the psyBNC configuration, but you need GCC access to do this, see this for setting the following command up. On IRC (Freenode) type:
/msg bot|shellium getgcc <shellUserName> <reason for GCC>
You will now be moved to the GCC group for 15 minutes (this means you have 15 minutes to edit the BNC config) and kicked off the shell to have it applied.
Log back in to the shell and type:
cd psybnc
Now type:
make menuconfig
You will see a menu, similar to the one below.
Press enter to select the "Compiling Options"-option. You will now see a list of several options, some checked, some unchecked. Scroll down (press down) untill you come up to None permanent IRC-connections.
If it is checked, uncheck it by pressing enter. The line should now look like this:
Return to the previous screen by pressing right to select "Exit" and then pressing enter.
Use your cursor to select the "Bouncer-Config" option, and press enter. You will now see another menu. Press enter again. You should now see a number on your screen which reads "31337". Now move with your cursor key to "Delete" and press enter.
Now that you have deleted the default port, scroll left once with the cursor key, and press enter. You will now see a screen which says "* 31337" in a text area. Use your backspace key to delete the 31337, and then enter one of your assigned ports (which you will later use to connect to your bouncer). Note this port, as you will need it later. Now press enter, and then when you are returned to the previous screen, press your escape (ESC) key.
You should now be back at the main Bouncer-Config menu. Now you need to scroll down to the "Users" section, and press enter. Now use your right cursor and scroll across to "New", and press enter. You should now see a screen asking for the new users' details, illustrated below.
To fill each configuration option, you must press enter. We'll work through them one-by-one.
Firstly, make sure the blue cursor is over the first option ("Login:"). Now press enter. You will see a new screen with a text area, and here you will need to enter the name you have in your IRC client for identd / E-Mail. Now press enter.
Now you need to press the down cursor once. The blue marker should now be over the "Nick:" option. Press enter. Here you should enter your normal IRC nickname. Now press enter.
Press the down cursor once, the blue marker should now be over the "Username:" option. Press enter. Here you should enter your IRC "real name" (this doesn't have to be YOUR real name, it can be almost anything, like a witty comment etc). Now press enter.
Press the down cursor once, the blue marker should now be over the "Password:" option. Press enter. Here you should enter the password you want to use when connecting to the bouncer. Now press enter.
Press the down cursor once, the blue marker should now be over the "VHost:" option. Press enter. Here you should enter the V-Host (IRC Hostname) that you want. Click here for the V-Host list. Note: You don't need to enter anything here, it is optional.
Now keep scrolling down until you are on the "Servers" option. Press enter. Now you should see a black box. Use your right cursor key until the blue marker is over the "New" option. Press enter. Now you should see a text area, here you should enter the IRC Servers that you want, in the following format, each on it's own line:
irc.server.com 6667
Once you are done, press Escape, this will take you back to the configuration screen.
Push the right arrow to move the cursor to Exit and hit enter, taking you back to the users list.
Again, press Escape to get back to the Bouncer-Config screen. Move the cursor to the right to Exit, and press enter.
Once again, move to Exit to get back to the shell.
Once you have returned to the shell prompt, type the following command:
make
You will now be questioned about several things, just keep pressing enter until you get back to the shell prompt. Now all you need to do is start psyBNC. Type the following command:
./psybnc
You get an output similar to this:
----.,----.,-. ,-.,---.,--. ,-.,----. | O || ,-' \ \/ / | o || \| || ,--' | _/ _\ \ \ / | o< | |\ || |__ |_| |____/ |__| |___||_| \_| \___| Version 2.3.1 (c) 1999-2002 the most psychoid and the cool lam3rz Group IRCnet `-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=tCl=-' Configuration File: psybnc.conf Language File: psyBNC Language File - English No logfile specified, logging to log/psybnc.log Listening on: 0.0.0.0 port 4556 psyBNC2.3.1-cBtITLdDMSNpE started (PID 15714)
Then you have successfully configured and started psyBNC. Now all you need to do is load your IRC client. If you are using mIRC, then follow the following steps to connect to your BNC.
Firstly, open the Options section (CTRL + O). Make sure your E-Mail address and identd settings are the same as the ones you set in the psyBNC configuration menu, or psyBNC will not let you connect. Once that is done, simply type the following command in your IRC client to connect to psyBNC:
/server free.psybnc.and.eggdrop.at.shellium.org porthere passhere
Porthere and passhere are the two options you set in the psyBNC configuration file (port and password).
If all goes well, you should see the IRC server's MOTD. Now you can begin using IRC as you would normally, but you must connect with the line above to get on to your bouncer.
Congratulations! You have now configured and connected to your bouncer!
psyBNC advanced installation
If you want to make your own psybnc, You could get the source by using lynx or wget. Example wget command:
wget http://www.psybnc.at/download/beta/psyBNC-2.3.2-7.tar.gz
The next step is to decompress this file (.tar.gz is kinda like a .zip file for all you windoze ppl out there). To do this, type:
tar zxvf psyBNC-2.3.2-7.tar.gz
Notice that it’s case-sensitive. Everything in unix is case-sensitive. Keep that in mind for everything in the future. If you typed the correctly, you should have a psybnc directory on your shell. Change to it and see what you have!
cd psybnc
make
Edit your psybnc conf using pico / nano :
pico psybnc.conf
You just need to edit your psybnc port from 31337 to your shellium port. (type: myports to see your assigned ports) After you finish editing the psybnc port, save it using this command ( CTRL X ), press Yes and keep using psybnc.conf for the file name. execute the psybncs’ files with this command:
./psybnc
Go to your irc client (ALWAYS use the same username/ident), and type:
/server free.psybnc.and.eggdrop.at.shellium.org:yourport yourpasswwordtobeuse
For 'Help' about connection,server,etc, type in your irc client:
/BHELP
If you get this message: "-- psyBNC- WARNING ! Move the file salt.h from the shell to a safe place" Logon to your shell, type:
cd psybnc
mkdir backup | mv salt.h ~/psybnc/backup
In somewhere, idle psybnc can make we got killed by irc services, because of 'channel filler rule' Changing our CTCP VERSION reply, can minimalize this possibility:
Edit the config.h and insert "#define CTCPVERSION "my own ctcp reply" recompile the psyBNC, done.
Psybnc and problem with DCC ... use these commands:
/dccenable 0 /AUTOGETDCC 1
Usage
To receive a list of commands and access help files, type this command:
bhelp
If you wish to set a server, type:
addserver irc.freenode.net:6667
This command is used to add servers in the serveraddress:portnumber format and it will add the freenode.net network to your account, and instruct psyBNC to connect using port 6667. Adding a server to the list will make sure that you are automatically connected.
IRC services auto-authentication
1. Create a scripts directory in your psybnc directory: From your home directory type
cd psybnc/scripts
2. Create a text file called USERNAME.SCRIPT: in the scripts directory type: (make sure to replace "USERNAME" with your username in the bouncer's configuration.
nano USERNAME.SCRIPT
3. In this text file paste (right click) this script: (make sure to replace <PASSWORD> with your nickserv password)
server NOTICE NickServ!services@* * "*This nickname is registered and protected*" echo "PRIVMSG NickServ :IDENTIFY <PASSWORD>"
or
server NOTICE * * "*This nickname is registered.*" echo "PRIVMSG NickServ : IDENTIFY <PASSWORD>"
4. Save your new text file and exit the editor:
Ctrl+x will close the editor, you'll be asked if you're sure you want to save your changes, press Y for yes. You will then be asked to which file you want to save to, USERNAME.SCRIPT should already be entered, press enter.
5. In the client connected to psyBNC you need to load the script:
/sreload
Enjoy :D
Recovering your psyBNC password
After you have created your psyBNC and logged into it for the first time you are prompted for a password.
If you have forgotten your password it is easy to find the password.
Follows these steps.
1. Go to your psybnc directory.
Typically from your home directory you type:
cd psybnc
Open your psybnc configuration file:
pico psybnc.conf You can use whichever editor you feel comfortable.
The line that contains your password variable looks like this.
USER1.USER.PASS=mypassword
Sometimes the password is encrypted. If your password is mumbo jumbo follows these steps:
Remove every character in the line that follows the equal sign.
Replace the line with your new password.
Save the psybnc.conf with the editor you have chosen.
Now restart your psybnc.
If your psyBNC does not restart follow these steps.
Once returned to the terminal use the PS command to list your processes.
Use the kill -9 command to kill the psyBNC process.
Now in the terminal again type ./psybnc
Everything should restart fine and your password is reset.
FAQ
Q: When I disconnect from my BNC or close my IRC Client, the BNC also quits the server?!
- This is because of the "None permanent IRC-connections"-setting in psyBNC. Take the following steps to resolve this:
- Go to the psybnc-directory that was extracted from the .tar.gz file.
- Start compiling psyBNC with make menuconfig (you need GCC-access for this). This will open up the Configuration Menu (see Image Configuration Menu).
- Select Compiling Options and press enter.
- Go down until you get to None permanent IRC-connections (see image None permanent IRC-connections)
- If it is checked, press enter. The [x] in front of the line will change to [ ]. (see image None permanent IRC-connections - Unchecked)
- Go back to the previous screen (press right and enter).
- Continue with the configuration as described in PsyBNC Simple Installation.
Configuration Menu |
None permanent IRC-connections |
None permanent IRC-connections - Unchecked |
