Polari

User Documentation

• Polari User Manual
  Contains useful information regarding general use of Polari as an IRC client, such as joining an IRC channel, using a nickname password on IRC and more.

• Where does Polari store my IRC chat history?
  Currently Polari doesn't support importing IRC logs or exporting IRC logs from the user interface (other than copy pasting manually). Polari is a Telepathy Client and relies on Telepathy Logger to store IRC logs. The IRC logs can be found in:

  ~/.local/share/TpLogger/logs

  Polari's chatlogs are sorted under the name idle_irc_$yournicknameXX.

• Does Polari support server passwords?
  Polari supports connecting to IRC networks protected by password since Polari 3.24. Some bouncers such as ZNC uses passwords by default. Polari will attempt to establish connection first and if the network denies the connection request and asks for a password, a small key icon will show up next to the network in the sidebar. Clicking the network will yield an entry where a password may be entered. Note that in some circumstances the timeout may take a minute or two to show up.

Development Resources

• Polari's source code

  The source code is stored in a git repository at GNOME's Gitlab. Anyone can clone it using the following command:

  git clone https://gitlab.gnome.org/GNOME/polari.git

  Alternatively, you can download tarball archives of earlier Polari releases.

• Polari in GNOME's issue tracker

  Development in Polari is tracked using GNOME's bug tracker. Search the bug tracker for any issues or feature requests you may have. Feel free to work on fixing any bug filed against Polari. If you are a newcomer, you can find some easy bugs to get started with in this list.

• Polari's design space

  Describes the objectives of Polari as an application. This is also the space for the current tentative design in implemented and upcoming aspects of Polari.

• GJS Style Guide

  Polari is written in Gjs (GNOME Javascript) and follows the general GJS style guide conventions. A must read if you are unfamiliar with GJS. GJS is an introspected language - for more information about how introspected languages work, check the GObject Introspection Project.

• Telepathy Developer's Manual

  Polari is based on the Telepathy-Glib library. This resource contains guidance on how to interact with Telepathy in your code. It can be searched via DuckDuckGo (and other search engines) for convenience.

• API Reference for GJS (Telepathy, Glib, GTK+3 etc):

  This is an auto-generated API based on the corresponding C API found at GNOME Developer Center. It can be searched via Google (and other search engines) for convenience.

Polari Developers

Most contributors to Polari hang out at #polari on irc.gnome.org. Contributors, users and developers are more than welcome to direct any questions about Polari there. Currently Polari is being developed by:

• Florian Müllner (fmuellner) Creator and maintainer of Polari.

  Jakub Steiner (jimmac) Polari designer

  Bastian Ilso (bastianilso) Polari designer

  Rares Visalom (raresv) Google Summer of Code student

  Kunaal Jain (kunaaljain) Google Summer of Code student