Project

General

Profile

QuasselWiki » History » Version 189

genius3000, 12/12/2020 05:28 AM
Rollback due to spam.

1 189 genius3000
h1. Quassel
2 189 genius3000
3 189 genius3000
{{toc}}
4 189 genius3000
5 189 genius3000
h2. Introduction
6 189 genius3000
7 189 genius3000
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".
8 189 genius3000
9 189 genius3000
Quassel's distributed approach:
10 189 genius3000
11 189 genius3000
!distributed.png!
12 189 genius3000
13 189 genius3000
In simpler terms, the "monolithic" client is a response to requests for a client that behaves like every other IRC client. The monolithic client (GUI) is what makes the connections to the IRC networks. In normal operation, the client (GUI) connects to a core, it is completely incapable of connecting to anything else. The core receives connections from clients, and makes connections to the IRC networks, it also handles logging (currently everything gets put in the database).
14 189 genius3000
15 189 genius3000
h2. Getting started
16 189 genius3000
17 189 genius3000
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.
18 189 genius3000
19 189 genius3000
h3. Installation
20 189 genius3000
21 189 genius3000
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. Some community members also provide [[QuasselWiki#Unofficial-builds|unofficial builds]] for various platforms.
22 189 genius3000
23 189 genius3000
h3. Connecting to the core
24 189 genius3000
25 189 genius3000
Before starting the core, you could set up [[Client-Core SSL support|Client-Core SSL encryption]] or have a look at the [[PostgreSQL|PostgreSQL article]] before moving on.
26 189 genius3000
All that is completely optional.
27 189 genius3000
28 189 genius3000
Check if Quassel Core is listening on the right interface and if TCP port 4242 is open in your firewall to allow remote connections to Quassel Core.
29 189 genius3000
On openSUSE, take a look at the QUASSELCORE_LISTEN line in /etc/sysconfig/quasselcore and go to YaST2 Firewall→allowed services and add "Quassel Core" to the list of allowed services.
30 189 genius3000
31 189 genius3000
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).
32 189 genius3000
33 189 genius3000
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 back-end (for now this is SQLite only). Click finish and your core is ready!
34 189 genius3000
35 189 genius3000
More users can be added by passing command line arguments to the core (see [[Manage core users|Managing core users]]).
36 189 genius3000
37 189 genius3000
h3. IRC Configuration
38 189 genius3000
39 189 genius3000
Now you have to specify which network(s) Quassel should connect to. First you will have to create an identity.
40 189 genius3000
41 189 genius3000
!identity.png!
42 189 genius3000
43 189 genius3000
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.
44 189 genius3000
45 189 genius3000
After creating an identity, you have to define the Costa Coffee price 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.
46 189 genius3000
47 189 genius3000
!network.png!
48 189 genius3000
49 189 genius3000
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!
50 189 genius3000
51 189 genius3000
h2. Manuals
52 189 genius3000
53 189 genius3000
h3. Core
54 189 genius3000
* Autostart QuasselCore on:
55 189 genius3000
** [[Autostart Core on Mac|Mac]]
56 189 genius3000
** [[QuasselCore As A Service (Windows)|Windows]]
57 189 genius3000
* Backends
58 189 genius3000
** [[PostgreSQL]]: Setting up PostgreSQL database back-end
59 189 genius3000
** [[SQLite]]: Some information about the SQLite back-end
60 189 genius3000
61 189 genius3000
h3. Shared
62 189 genius3000
* [[Blowfish Encryption Manual|Blowfish Encryption]]: Encrypt IRC messages in a channel or in a query
63 189 genius3000
* [[Quassel Logging|Logging in Quassel]]: Fetching and searching the Quassel logs
64 189 genius3000
* [[SSH Tunneling]]: How to tunnel the client-core connection over SSH
65 189 genius3000
* [[Client-Core SSL support|SSL support]]: How to encrypt the connection between clients and core
66 189 genius3000
* [[Manage core users|User management]]: How to add users to the core
67 189 genius3000
* [[Migrating from Monolithic to Client+Core]]: How to migrate from the monolithic client to client + core.
68 189 genius3000
* [[Quassel Config File Format|Reading Quassel Config Files]]: How to read and understand a quassel configuration file.
69 189 genius3000
70 189 genius3000
h3. Client
71 189 genius3000
* GUI Customization
72 189 genius3000
** [[Buffer Views|Chat Lists]]: Filter your channels to the ones you really need, or split channels & queries into separate widgets.
73 189 genius3000
*** [[Customize chats order]]
74 189 genius3000
** [[Chat View]]
75 189 genius3000
*** [[Chat View#hide-events|Hide Events]]: Hide Join, Parts and Quits.
76 189 genius3000
** [[Stylesheets]]: Advanced theming of the entire client.
77 189 genius3000
*** [[Stylesheet Gallery]]: List of stylesheets made by users.
78 189 genius3000
** [[Customize Icons]]
79 189 genius3000
80 189 genius3000
* [[Shortcuts]]
81 189 genius3000
82 189 genius3000
h2. Frequently asked questions
83 189 genius3000
84 189 genius3000
Check the [[FAQ]]
85 189 genius3000
86 189 genius3000
h2. Known issues
87 189 genius3000
88 189 genius3000
[[GSoC 2016]]
89 189 genius3000
90 189 genius3000
* DCC chat and file transfers are not yet supported.
91 189 genius3000
* See "Issues":http://bugs.quassel-irc.org/projects/quassel-irc/issues for specific bugs and feature requests.
92 189 genius3000
93 189 genius3000
h2. Unofficial builds
94 189 genius3000
95 189 genius3000
See also the [[Mobile]] page.
96 189 genius3000
97 189 genius3000
h3. Linux
98 189 genius3000
99 189 genius3000
* "Backported packages for Debian Jessie, amd64 only":https://iskrembilen.com/quassel-packages-debian/
100 189 genius3000
* "PPA for Ubuntu with latest versions of Quassel":https://launchpad.net/~mamarley/+archive/ubuntu/quassel
101 189 genius3000
102 189 genius3000
h3. Mac
103 189 genius3000
104 189 genius3000
* "romibi's Custom Builds":https://github.com/romibi/quassel/releases (with some merged experimental stuff, use at your own risk!)
105 189 genius3000
106 189 genius3000
h3. Windows
107 189 genius3000
108 189 genius3000
* "x64 only, requires VS2013 runtime":http://files.1f0.de/quassel-x64-0.12.2-qt5.4.1.zip
109 189 genius3000
* "Appveyor Git master builds.":https://ci.appveyor.com/project/Quassel/quassel/branch/master To download, click on one of the jobs (e. g. "Environment: COMPILER=msvc15_64"), and then on "Artifacts" to find a list of files.
110 189 genius3000
* "romibi's Custom Builds":http://quassel.romibi.ch/ (with some merged experimental stuff, use at your own risk!)
111 189 genius3000
112 189 genius3000
h3. Android
113 189 genius3000
114 189 genius3000
* "Quasseldroid": https://quasseldroid.info/
115 189 genius3000
116 189 genius3000
h2. Development
117 189 genius3000
118 189 genius3000
[[Roadmap]]
119 189 genius3000
120 189 genius3000
h3. Build guides
121 189 genius3000
122 189 genius3000
* [[Build Quassel on Windows]] (with Visual Studio)
123 189 genius3000
* [[Build Quassel on Windows Mingw|Build Quassel on Windows]] (with MinGW)
124 189 genius3000
* [[Build Quassel on Linux (english)]]
125 189 genius3000
* [[Build Quassel on Linux (deutsch)]]
126 189 genius3000
* [[Build Core On Ubuntu]]: Setting up Quassel core from the source code on Ubuntu server (mostly applies to Debian too)
127 189 genius3000
* [[Building quasselcore on Ubuntu 8.04 Hardy Heron/x64 (old Qt4 libs)]]
128 189 genius3000
129 189 genius3000
h3. Manuals
130 189 genius3000
131 189 genius3000
* Rules (TODO)
132 189 genius3000
* [[development_getting_started|Getting started]]
133 189 genius3000
* [[development_git_patches|Git Patches]]
134 189 genius3000
* [[development_translations|Translations]]
135 189 genius3000
136 189 genius3000
h3. Feature Drafts
137 189 genius3000
138 189 genius3000
* [[Blowfish Encryption]]
139 189 genius3000
* [[Possible_Scripting_Object]]
140 189 genius3000
* "Highlights, notifications, and push notifications":http://piratepad.net/vdo3UDwdRR
141 189 genius3000
* "General next-generation ideas":https://lite6.framapad.org/p/quassel-ng
142 189 genius3000
143 189 genius3000
h3. Technical Documentation
144 189 genius3000
145 189 genius3000
* [[doc_quassel_protocols|The Quassel Protocol]]