Project

General

Profile

QuasselWiki » History » Version 193

digitalcircuit, 12/20/2020 01:58 AM
Rollback due to spam

1 193 digitalcircuit
h1. Quassel
2 193 digitalcircuit
3 193 digitalcircuit
{{toc}}
4 193 digitalcircuit
5 193 digitalcircuit
h2. Introduction
6 193 digitalcircuit
7 193 digitalcircuit
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 193 digitalcircuit
9 193 digitalcircuit
Quassel's distributed approach:
10 193 digitalcircuit
11 193 digitalcircuit
!distributed.png!
12 193 digitalcircuit
13 193 digitalcircuit
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 193 digitalcircuit
15 193 digitalcircuit
h2. Getting started
16 193 digitalcircuit
17 193 digitalcircuit
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 193 digitalcircuit
19 193 digitalcircuit
h3. Installation
20 193 digitalcircuit
21 193 digitalcircuit
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 193 digitalcircuit
23 193 digitalcircuit
h3. Connecting to the core
24 193 digitalcircuit
25 193 digitalcircuit
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 193 digitalcircuit
All that is completely optional.
27 193 digitalcircuit
28 193 digitalcircuit
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 193 digitalcircuit
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 193 digitalcircuit
31 193 digitalcircuit
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 193 digitalcircuit
33 193 digitalcircuit
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 193 digitalcircuit
35 193 digitalcircuit
More users can be added by passing command line arguments to the core (see [[Manage core users|Managing core users]]).
36 193 digitalcircuit
37 193 digitalcircuit
h3. IRC Configuration
38 193 digitalcircuit
39 193 digitalcircuit
Now you have to specify which network(s) Quassel should connect to. First you will have to create an identity.
40 193 digitalcircuit
41 193 digitalcircuit
!identity.png!
42 193 digitalcircuit
43 193 digitalcircuit
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 193 digitalcircuit
45 193 digitalcircuit
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 193 digitalcircuit
47 193 digitalcircuit
!network.png!
48 193 digitalcircuit
49 193 digitalcircuit
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 193 digitalcircuit
51 193 digitalcircuit
h2. Manuals
52 193 digitalcircuit
53 193 digitalcircuit
h3. Core
54 193 digitalcircuit
* Autostart QuasselCore on:
55 193 digitalcircuit
** [[Autostart Core on Mac|Mac]]
56 193 digitalcircuit
** [[QuasselCore As A Service (Windows)|Windows]]
57 193 digitalcircuit
* Backends
58 193 digitalcircuit
** [[PostgreSQL]]: Setting up PostgreSQL database back-end
59 193 digitalcircuit
** [[SQLite]]: Some information about the SQLite back-end
60 193 digitalcircuit
61 193 digitalcircuit
h3. Shared
62 193 digitalcircuit
* [[Blowfish Encryption Manual|Blowfish Encryption]]: Encrypt IRC messages in a channel or in a query
63 193 digitalcircuit
* [[Quassel Logging|Logging in Quassel]]: Fetching and searching the Quassel logs
64 193 digitalcircuit
* [[SSH Tunneling]]: How to tunnel the client-core connection over SSH
65 193 digitalcircuit
* [[Client-Core SSL support|SSL support]]: How to encrypt the connection between clients and core
66 193 digitalcircuit
* [[Manage core users|User management]]: How to add users to the core
67 193 digitalcircuit
* [[Migrating from Monolithic to Client+Core]]: How to migrate from the monolithic client to client + core.
68 193 digitalcircuit
* [[Quassel Config File Format|Reading Quassel Config Files]]: How to read and understand a quassel configuration file.
69 193 digitalcircuit
70 193 digitalcircuit
h3. Client
71 193 digitalcircuit
* GUI Customization
72 193 digitalcircuit
** [[Buffer Views|Chat Lists]]: Filter your channels to the ones you really need, or split channels & queries into separate widgets.
73 193 digitalcircuit
*** [[Customize chats order]]
74 193 digitalcircuit
** [[Chat View]]
75 193 digitalcircuit
*** [[Chat View#hide-events|Hide Events]]: Hide Join, Parts and Quits.
76 193 digitalcircuit
** [[Stylesheets]]: Advanced theming of the entire client.
77 193 digitalcircuit
*** [[Stylesheet Gallery]]: List of stylesheets made by users.
78 193 digitalcircuit
** [[Customize Icons]]
79 193 digitalcircuit
80 193 digitalcircuit
* [[Shortcuts]]
81 193 digitalcircuit
82 193 digitalcircuit
h2. Frequently asked questions
83 193 digitalcircuit
84 193 digitalcircuit
Check the [[FAQ]]
85 193 digitalcircuit
86 193 digitalcircuit
h2. Known issues
87 193 digitalcircuit
88 193 digitalcircuit
[[GSoC 2016]]
89 193 digitalcircuit
90 193 digitalcircuit
* DCC chat and file transfers are not yet supported.
91 193 digitalcircuit
* See "Issues":http://bugs.quassel-irc.org/projects/quassel-irc/issues for specific bugs and feature requests.
92 193 digitalcircuit
93 193 digitalcircuit
h2. Unofficial builds
94 193 digitalcircuit
95 193 digitalcircuit
See also the [[Mobile]] page.
96 193 digitalcircuit
97 193 digitalcircuit
h3. Linux
98 193 digitalcircuit
99 193 digitalcircuit
* "Backported packages for Debian Jessie, amd64 only":https://iskrembilen.com/quassel-packages-debian/
100 193 digitalcircuit
* "PPA for Ubuntu with latest versions of Quassel":https://launchpad.net/~mamarley/+archive/ubuntu/quassel
101 193 digitalcircuit
102 193 digitalcircuit
h3. Mac
103 193 digitalcircuit
104 193 digitalcircuit
* "romibi's Custom Builds":https://github.com/romibi/quassel/releases (with some merged experimental stuff, use at your own risk!)
105 193 digitalcircuit
106 193 digitalcircuit
h3. Windows
107 193 digitalcircuit
108 193 digitalcircuit
* "x64 only, requires VS2013 runtime":http://files.1f0.de/quassel-x64-0.12.2-qt5.4.1.zip
109 193 digitalcircuit
* "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 193 digitalcircuit
* "romibi's Custom Builds":http://quassel.romibi.ch/ (with some merged experimental stuff, use at your own risk!)
111 193 digitalcircuit
112 193 digitalcircuit
h3. Android
113 193 digitalcircuit
114 193 digitalcircuit
* "Quasseldroid": https://quasseldroid.info/
115 193 digitalcircuit
116 193 digitalcircuit
h2. Development
117 193 digitalcircuit
118 193 digitalcircuit
[[Roadmap]]
119 193 digitalcircuit
120 193 digitalcircuit
h3. Build guides
121 193 digitalcircuit
122 193 digitalcircuit
* [[Build Quassel on Windows]] (with Visual Studio)
123 193 digitalcircuit
* [[Build Quassel on Windows Mingw|Build Quassel on Windows]] (with MinGW)
124 193 digitalcircuit
* [[Build Quassel on Linux (english)]]
125 193 digitalcircuit
* [[Build Quassel on Linux (deutsch)]]
126 193 digitalcircuit
* [[Build Core On Ubuntu]]: Setting up Quassel core from the source code on Ubuntu server (mostly applies to Debian too)
127 193 digitalcircuit
* [[Building quasselcore on Ubuntu 8.04 Hardy Heron/x64 (old Qt4 libs)]]
128 193 digitalcircuit
129 193 digitalcircuit
h3. Manuals
130 193 digitalcircuit
131 193 digitalcircuit
* Rules (TODO)
132 193 digitalcircuit
* [[development_getting_started|Getting started]]
133 193 digitalcircuit
* [[development_git_patches|Git Patches]]
134 193 digitalcircuit
* [[development_translations|Translations]]
135 193 digitalcircuit
136 193 digitalcircuit
h3. Feature Drafts
137 193 digitalcircuit
138 193 digitalcircuit
* [[Blowfish Encryption]]
139 193 digitalcircuit
* [[Possible_Scripting_Object]]
140 193 digitalcircuit
* "Highlights, notifications, and push notifications":http://piratepad.net/vdo3UDwdRR
141 193 digitalcircuit
* "General next-generation ideas":https://lite6.framapad.org/p/quassel-ng
142 193 digitalcircuit
143 193 digitalcircuit
h3. Technical Documentation
144 193 digitalcircuit
145 193 digitalcircuit
* [[doc_quassel_protocols|The Quassel Protocol]]