Quassel IRC

h1. Quassel

{{toc}}

h2. Introduction

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".

Quassel's distributed approach:

!distributed.png!

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).

h2. Getting started

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.

h3. Installation

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.

h3. Connecting to the core

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.

All that is completely optional.

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.

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.

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).

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!

More users can be added by passing command line arguments to the core (see [[Manage core users|Managing core users]]).

h3. IRC Configuration

Now you have to specify which network(s) Quassel should connect to. First you will have to create an identity.

!identity.png!

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.

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.

!network.png!

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!

h2. Manuals

h3. Core

* Autostart QuasselCore on:  

** [[Autostart Core on Mac|Mac]]

** [[QuasselCore As A Service (Windows)|Windows]]

* Backends

** [[PostgreSQL]]: Setting up PostgreSQL database back-end

** [[SQLite]]: Some information about the SQLite back-end

h3. Shared

* [[Blowfish Encryption Manual|Blowfish Encryption]]: Encrypt IRC messages in a channel or in a query

* [[Quassel Logging|Logging in Quassel]]: Fetching and searching the Quassel logs

* [[SSH Tunneling]]: How to tunnel the client-core connection over SSH

* [[Client-Core SSL support|SSL support]]: How to encrypt the connection between clients and core

* [[Manage core users|User management]]: How to add users to the core

* [[Migrating from Monolithic to Client+Core]]: How to migrate from the monolithic client to client + core.

* [[Quassel Config File Format|Reading Quassel Config Files]]: How to read and understand a quassel configuration file.

h3. Client  

* GUI Customization

** [[Buffer Views|Chat Lists]]: Filter your channels to the ones you really need, or split channels & queries into separate widgets.

*** [[Customize chats order]]

** [[Chat View]]

*** [[Chat View#hide-events|Hide Events]]: Hide Join, Parts and Quits.

** [[Stylesheets]]: Advanced theming of the entire client.

*** [[Stylesheet Gallery]]: List of stylesheets made by users.

** [[Customize Icons]]

* [[Shortcuts]]

h2. Frequently asked questions

Check the [[FAQ]]

h2. Known issues

[[GSoC 2016]]

* DCC chat and file transfers are not yet supported.

* See "Issues":http://bugs.quassel-irc.org/projects/quassel-irc/issues for specific bugs and feature requests.

h2. Unofficial builds

See also the [[Mobile]] page.

h3. Linux

* "Backported packages for Debian Jessie, amd64 only":https://iskrembilen.com/quassel-packages-debian/

* "PPA for Ubuntu with latest versions of Quassel":https://launchpad.net/~mamarley/+archive/ubuntu/quassel

h3. Mac

* "romibi's Custom Builds":https://github.com/romibi/quassel/releases (with some merged experimental stuff, use at your own risk!)

h3. Windows

* "x64 only, requires VS2013 runtime":http://files.1f0.de/quassel-x64-0.12.2-qt5.4.1.zip

* "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.

* "romibi's Custom Builds":http://quassel.romibi.ch/ (with some merged experimental stuff, use at your own risk!)

h3. Android

* "Janne Koschinski's Quasseldroid branch":http://dl.kuschku.de/releases/quasseldroid/

h2. Development

[[Roadmap]]

h3. Build guides

* [[Build Quassel on Windows]] (with Visual Studio)

* [[Build Quassel on Windows Mingw|Build Quassel on Windows]] (with MinGW)

* [[Build Quassel on Linux (english)]]

* [[Build Quassel on Linux (deutsch)]]

* [[Build Core On Ubuntu]]: Setting up Quassel core from the source code on Ubuntu server (mostly applies to Debian too)

* [[Building quasselcore on Ubuntu 8.04 Hardy Heron/x64 (old Qt4 libs)]]

h3. Manuals

* Rules (TODO)

* [[development_getting_started|Getting started]]

* [[development_git_patches|Git Patches]]

* [[development_translations|Translations]]

h3. Feature Drafts

* [[Blowfish Encryption]]

* [[Possible_Scripting_Object]]

* "Highlights, notifications, and push notifications":http://piratepad.net/vdo3UDwdRR

* "General next-generation ideas":https://lite6.framapad.org/p/quassel-ng

h3. Technical Documentation

* [[doc_quassel_protocols|The Quassel Protocol]]