# Chat Core

Chat Core is the code for instant messaging that is used by Thunderbird. It provides a number of functions and capabilities, including:

* [Communications protocols](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/chat-core-protocols) - IRC, Matrix, XMPP (and XMPP-based protocols)
* [Message styles](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/message-styles)
* Account configuration
* [Contacts storage](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/contacts)
* Message logging
* [Emoticon (smileys) handling](https://developer.thunderbird.net/thunderbird-development/codebase-overview/broken-reference)

The Chat Core code lives in the chat/ directory of [comm-central](https://searchfox.org/comm-central/source/chat).

#### [Chat Core Protocols](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/chat-core-protocols)

The Chat Core code used by Thunderbird has some abstractions to deal with the differences between protocols (e.g. IRC vs. XMPP).

#### [Contacts](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/contacts)

Contacts are at the heart of instant messaging, and thus the Chat Core has a way to abstract to a "person" (represented by an [`imIContact`](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl) instance), which might connect to multiple networks, etc.

#### [Keyboard shortcuts](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/keyboard-shortcuts)

This is a list of the available keyboard shortcuts with brief descriptions of what they do.

#### [Message Styles](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/message-styles)

Chat Core uses a message style system based on HTML, JS and CSS that is very similar to the one created for [Adium](https://adium.im/).  If you plan to create a message style, reading the Adium documentation on the topic may be helpful -- see this [tutorial](https://web.archive.org/web/20160408094746/https://trac.adium.im/wiki/CreatingMessageStyles/Tutorial) and this [reference sheet](https://web.archive.org/web/20160715205801/https://trac.adium.im/wiki/CreatingMessageStyles).

#### [Notifications](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/notifications)

This is a page for documenting the notifications in Thunderbird. This is likely out of date. Notifications are grouped by interface you need to attach the observer to.