Project

General

Profile

QuasselWiki » History » Version 48

katastrophe, 04/13/2009 09:36 PM
added shortcut section

1 5 sph
h1. Quassel
2 1 seezer
3 12 sph
{{toc}}
4 12 sph
5 12 sph
6 12 sph
7 5 sph
h2. Introduction
8 5 sph
9 41 sph
Quassel is a program to connect to an IRC network. It has the unique ability to split the graphical component (quasselclient) from the part that handles the IRC connection (quasselcore). This means that you can have a remote core permanently connected to one or more IRC networks and attach a client from wherever you are without moving around any information or settings. However, Quassel can easily behave like any other client by combining them into one binary, which is referred to as "Quassel Mono".
10 5 sph
11 5 sph
Quassel's distributed approach:
12 20 sph
!distributed.png!
13 5 sph
14 5 sph
15 12 sph
16 7 sph
h2. Getting started
17 7 sph
18 10 sph
Setting up Quassel is fairly easy and straightforward. Since we have a separated core and client, we will configure them in two steps. If you are using the Quassel Mono version, then you can skip the core part as this is done internally.
19 7 sph
20 12 sph
21 10 sph
h3. Installation
22 10 sph
23 10 sph
The best and most reliable way is to simply install the packages provided by your distribution. However, we do offer some static binaries at http://quassel-irc.org/downloads along with Git instructions for those who prefer to compile Quassel themselves. 
24 10 sph
25 12 sph
26 10 sph
h3. Connecting to the core
27 1 seezer
28 29 sph
If you wish to setup an SSL connection between the core and client, you must have compiled both with the "-DWITH_OPENSSL=ON" cmake option. Generate a key with the following command on the server running the core:
29 33 pennywise
30 35 pennywise
*Version before 0.4*
31 37 pennywise
> <pre>openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout ~/.quassel/quasselCert.pem -out ~/.quassel/quasselCert.pem</pre>
32 40 sph
> The "~/.quassel/" directory may differ if the --datadir option was specified for quasselcore.
33 1 seezer
34 40 sph
*Version 0.4 and later*
35 34 pennywise
> <pre>openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout ~/.config/quassel-irc.org/quasselCert.pem -out ~/.config/quassel-irc.org/quasselCert.pem</pre>
36 40 sph
> The default config directory has changed in version 0.4 and the core's --datadir option has been renamed to --configdir.
37 40 sph
38 40 sph
Note that Kubuntu packages for Jaunty (9.04) and later do this step for you.
39 1 seezer
40 47 sph
If you wish to use the PostgreSQL database backend, you can follow [[PostgreSQL|the PostgreSQL article]] first before moving on.
41 45 sph
42 14 sph
Now start the core and launch quasselclient on your local machine. A connection dialog will show up. Enter the IP address or hostname of the server running the core, enter the port number used by the core and select SSL if applicable. You can also specify a proxy but note that domain names will still be resolved locally (see "Qt4.4":http://doc.trolltech.com/4.4/qnetworkproxy.html#socks5).
43 1 seezer
44 15 sph
During the first connection, you will be guided through a graphical wizard to configure the core properly. Enter a username and password, this will be the administrator. Next, select a database backend (for now this is SQLite only). Click finish and your core is ready!
45 1 seezer
46 27 sph
A configuration screen for adding new users and managing existing ones is under developement, but for the time being you can use a simple [[Manage core users|python script]].
47 1 seezer
48 1 seezer
49 15 sph
h3. IRC Configuration
50 15 sph
51 15 sph
Now you have to specify which network(s) Quassel should connect to. First you will have to create an identity.
52 15 sph
53 20 sph
!identity.png!
54 15 sph
55 16 sph
Set a real name (which doesn't actually have to be real) and add the nicknames you want to use. If the first nickname is not available, the second one (if specified) will be used instead. Change the other settings if you like, this is optional however.
56 15 sph
57 19 sph
After creating an identity, you have to define the IRC network(s) along with the servers they use. If Quassel was installed properly, there should be a preconfigured list of the most popular networks already.
58 15 sph
59 20 sph
!network.png!
60 15 sph
61 23 sph
Make sure you select the identity you just created (which should be the default). Click OK and you're done. Feel free to visit us in the #quassel channel on Freenode!
62 12 sph
63 26 sph
h2. Manuals
64 5 sph
65 4 pennywise
* [[Manage core users]]
66 39 pennywise
* [[Buffer Views]]
67 25 sph
* [[Build Quassel on Windows]]
68 44 sph
* [[PostgreSQL]]
69 46 Gentle
* [[Quassel Logging]]
70 18 sph
71 18 sph
h2. Known issues
72 18 sph
73 21 sph
* DCC chat and file transfers are not yet supported.
74 18 sph
* The core does support multiple users but for now this can only be configured with a [[Manage core users|script]].
75 22 sph
* There has been a client for mobile devices but as the codebase updated so quickly it has become outdated and incompatible with newer cores.
76 18 sph
* See "Issues":http://bugs.quassel-irc.org/projects/quassel-irc/issues for specific bugs and feature requests.
77 30 dalbers
* [[FAQ]]
78 42 Datafreak
79 42 Datafreak
h2. Static Builds
80 42 Datafreak
81 42 Datafreak
* "Datafreak's Build for Windows":http://www.datafreak.eu/downloads/windows/quassel-irc/ (required "MSVC Redistributable Package":http://www.microsoft.com/downloads/details.aspx?displaylang=de&FamilyID=32bc1bee-a3f9-4c13-9c99-220b62a191ee)
82 42 Datafreak
* "Phon's Build for Windows":http://phon.name/quassel/ (required "MSVC Redistributable Package":http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=32bc1bee-a3f9-4c13-9c99-220b62a191ee , SSL will not work.)
83 42 Datafreak
* "Datafreak's Build for Linux":http://www.datafreak.eu/downloads/linux/quassel-irc/ (x86)
84 42 Datafreak
* "Jannik's Build for Linux":http://jannik.datenschleuder.net/quassel/nightly/linux/static/amd64/?C=M;O=D (x86_64)
85 43 Datafreak
* "Datafreak's static Core for Mipsel":http://www.datafreak.eu/downloads/linux/quasselcore-mipsel/ (works on "Asus Wl500w":http://www.asus.de/products.aspx?l1=12&l2=43&l3=0&l4=0&model=1277&modelmenu=1)
86 48 katastrophe
87 48 katastrophe
h2. Shortcuts
88 48 katastrophe
89 48 katastrophe
* If you want to change channels quickly, you can use CTRL+0-9 to assign a shortcut to the current channel. With ALT+0-9 its possible to jump to the channels accordingly.