Project

General

Profile

QuasselWiki » History » Version 139

justjanne, 09/04/2020 10:12 PM
Update quasseldroid link

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