Namespace

Pidgin – 3.0

Pidgin Universal Chat Client

Version3.0.0
AuthorsPidgin Developers
LicenseGPL-2.0-or-later
Websitehttps://keep.imfreedom.org/pidgin/pidgin/
Sourcehttps://keep.imfreedom.org/pidgin/pidgin/

Build

C headerspidgin.h
pkg-config filespidgin-3

Dependencies

GLib—2.0 General-purpose, portable utility library.
Browse documentation
GObject—2.0 The base type system library
Browse documentation
Gtk—4.0 The GTK toolkit
Browse documentation
GPlugin—1.0 GPlugin Plugin Library
Browse documentation
Purple—3.0 Purple Universal Chat Library
Browse documentation

Additional documentation

Classes

AboutDialog

A dialog window that describes what Pidgin is all about.

since: 3.0

AccountChooser

A widget that allows the user to pick a PurpleAccount from a list.

since: 3.0

AccountDisplay

A widget that is used to display a PurpleAccount.

since: 3.0

AccountEditor

PidginAccountEditor is a dialog that allows you to edit an account.

since: 3.0

AccountFilterConnected

PidginAccountFilterConnected is a GtkFilter that will only show accounts that are connected. It’s intended to be used with PidginAccountChooser or a GListModel that contains PurpleAccount.

since: 3.0

AccountFilterProtocol

PidginAccountFilterProtocol is a GtkFilter that will only show accounts for the given protocol. It’s intended to be used with PidginAccountChooser or a GListModel that contains PurpleAccount.

since: 3.0

AccountManager

A singleton dialog for managing accounts.

since: 3.0

AccountManagerRow

A GtkListBoxRow subclass to display a PurpleAccount.

since: 3.0

AccountRow

A Adw.ComboRow subclass that allows the user to select an PurpleAccount.

since: 3.0

AccountsDisabledMenu

A GMenuModel that contains all accounts from the default PurpleAccountManager that are not enabled.

since: 3.0

AccountsEnabledMenu

A GMenuModel that automatically updates itself based on what accounts are enabled.

since: 3.0

Application

PidginApplication is a subclass of GtkApplication that holds all of the application wide actions.

since: 3.0

AutoAdjustment

This is a simple subclass of GtkAdjustment that has helpers for keyboard navigation as well as the ability to automatically scroll to the max when new items are added if the widget was already scrolled all the way to the bottom.

since: 3.0

Avatar

PidginAvatar is a widget that displays avatars for contacts or conversations.

since: 3.0

AwayPrefs

PidginAwayPrefs is a widget for the preferences window to let users choose and configure their away and idle settings.

since: 3.0

ChannelJoinDialog

A dialog for joining channels.

since: 3.0

ContactList

PidginContactList is a widget that displays the GListModel of PurplePerson from PurpleContactManager.

since: 3.0

Conversation

A GtkWidget for displaying a PurpleConversation.

since: 2.0

ConversationPrefs

PidginConversationPrefs is a widget for the preferences window to let users choose and configure their conversation settings.

since: 3.0

CredentialPrefs

PidginCredentialPrefs is a widget for the preferences window to let users choose and configure their credential provider.

since: 3.0

CredentialProviderRow

PidginCredentialProviderRow is a widget for the preferences window to let users configure their credential provider.

since: 3.0

DebugWindow

The debug window.

since: 3.0

DisplayItem

A class that’s used by PidginDisplayWindow to represent all of the displays items.

since: 3.0

DisplayWindow

PidginDisplayWindow is a widget that contains PidginConversations.

since: 3.0

Idle

An implementation of PurpleIdleUi for Pidgin.

since: 3.0

IMWindow

A window used to start a new direct message.

since: 3.0

InfoPane

PidginInfoPane is a widget that displays information above PidginConversations.

since: 3.0

InviteDialog

PidginInviteDialog is a simple GtkDialog that presents the user with an interface to invite another user to a conversation. Name completion is automatically setup as well.

since: 3.0

Keypad

PidginKeypad is a widget that displays a DTMF keypad, with the digits 0-9, an asterisk, and a number sign.

since: 3.0

NetworkPrefs

PidginNetworkPrefs is a widget for the preferences window to let users choose and configure their network settings.

since: 3.0

NotificationAddContact

PidginNotificationAddContact is a widget that displays notifications from PurpleNotificationManager for PurpleAddContactRequest.

since: 3.0

NotificationAuthorizationRequest

PidginNotificationAuthorizationRequest is a widget that displays notifications from PurpleNotificationManager for authorization requests.

since: 3.0

NotificationConnectionError

PidginNotificationConnectionError is a widget that displays notifications from PurpleNotificationManager.

since: 3.0

NotificationList

PidginNotificationList is a widget that displays notifications from PurpleNotificationManager.

since: 3.0

PluginsDialog

A dialog that allows the user to configure their plugins.

since: 3.0

PluginsMenu

PidginPluginsMenu is a GMenuModel that automatically updates itself when plugins are loaded and unloaded.

since: 3.0

PrefsWindow

The window that displays all of the preferences.

since: 3.0

PresenceIcon

A GtkImage subclass that will automatically update when the given presence changes.

since: 3.0

ProtocolChooser

A widget that lets the user choose a PurpleProtocol.

since: 3.0

ProxyPrefs

PidginProxyPrefs is a widget for the preferences window to let users choose and configure their proxy settings.

since: 3.0

Ui

Is a subclass of PurpleUi that identifies Pidgin to libpurple.

since: 3.0

VVPrefs

PidginVVPrefs is a widget for the preferences window to let users choose and configure their voice and video settings.

since: 3.0

Functions

add_widget_to_vbox

Add a labelled widget to a GtkBox.

since: 2.4

auto_parent_window

Automatically make a window transient to a suitable parent window.

since: 2.4

color_calculate_for_text

This function is based heavily on the implementation that gajim uses from python-nbxmpp in nbxmpp.util.text_to_color. However, we don’t have an implementation of HSL let alone HSLuv, so we’re using HSV which is why the value is 1.0 instead of a luminance of 0.5.

since: 3.0

contact_info_menu_popup

Creates a GtkPopoverMenu for info and displays it at the x and y coordinates instead of parent.

since: 3.0

debug_get_handle

Get the handle for the GTK debug system.

since: 2.0

debug_init

Perform necessary initializations.

since: 2.0

debug_init_handler

Initialize handler for GLib logging system.

since: 3.0

debug_set_print_enabled

Set whether the debug logging messages are sent the default GLib logging handler.

since: 3.0

debug_uninit

Perform necessary uninitializations.

since: 2.0

dialogs_im_with_user

Creates an IM conversation with username on account if necessary.

since: 2.0

dialogs_info

Creates a dialog to get another user’s profile.

since: 2.0

icon_name_from_presence

Gets the icon name that should be used to represent presence falling back to fallback if presence is invalid.

since: 3.0

icon_name_from_presence_primitive

Gets the icon name that should be used to represent primitive. If the value is unknown fallback will be returned.

since: 3.0

icon_name_from_status

Gets the icon name to use for status if found, otherwise returns fallback.

since: 3.0

icon_name_from_status_primitive

Gets the icon name to use for primitive if found, otherwise returns fallback.

since: 3.0

icon_name_from_status_type

Gets the icon name to use for type if found, otherwise returns fallback.

since: 3.0

medias_init

Initializes the media API.

since: 2.6

notify_get_ui_ops

Returns the UI operations structure for GTK notification functions.

since: 2.0

notify_init

Initializes the GTK notifications subsystem.

since: 2.6

notify_uninit

Uninitialized the GTK notifications subsystem.

since: 2.6

prefs_init

Initializes all UI-specific preferences.

since: 2.0

prefs_update_old

Rename legacy prefs and delete some that no longer exist.

since: 2.0

request_get_dialog_window

Gets dialog window for specified libpurple request.

since: 3.0

request_get_handle

Returns the gtk requests subsystem handle.

since: 3.0

request_get_ui_ops

Returns the UI operations structure for GTK request functions.

since: 2.0

request_init

Initializes the GTK requests subsystem.

since: 3.0

request_uninit

Uninitializes the GTK requests subsystem.

since: 3.0

retrieve_user_info

Get information about a user. Show immediate feedback.

since: 2.1

retrieve_user_info_in_chat

Get information about a user in a chat. Show immediate feedback.

since: 2.1

roomlist_dialog_show

Shows a new roomlist dialog.

since: 2.0

roomlist_dialog_show_with_account

Shows a new room list dialog and fetches the list for the specified account.

since: 2.0

roomlist_init

Initializes the room list subsystem.

since: 2.0

roomlist_is_showable

Determines if showing the room list dialog is a valid action.

since: 2.0

set_accessible_label

Sets an ATK name for a given widget. Also sets the labelled-by and label-for ATK relationships.

since: 2.0

start

Start pidgin with the given command line arguments.

since: 3.0

text_buffer_get_html

Extracts text from buffer as HTML.

since: 3.0

text_buffer_get_html_range

Extracts the text between start and end from buffer as HTML. This will work with any GtkTextBuffer as it deciphers the tags it finds.

since: 3.0

whiteboard_get_ui_ops

Gets the GtkWhiteboard UI Operations.

since: 2.0

Constants

ALERT_TITLE

The title that should be used for alert dialogs.

PREFS_ROOT

A constants for the root of the preferences tree.

VERSION_MIN_REQUIRED

A macro that should be defined by the user prior to including the pidgin.h header.