# Purple, Pidgin and Finch

libpurple is a library intended to be used by programmers seeking to write an
IM client that connects to many IM networks. It comes with support for Bonjour,
IRC, and XMPP, among others and there are many more networks supported via
[third party plugins](https://pidgin.im/plugins/).

Pidgin is a graphical IM client written in C, which uses the GTK toolkit.

Finch is a text-based IM client written in C, which uses
[libgnt](https://keep.imfreedom.org/libgnt/libgnt).

These programs are not endorsed by, nor affiliated with, any proprietary
instant messaging company in any way.

## Contributors

See AUTHORS and COPYRIGHT for the list of contributors.

## Building

Pidgin uses [Meson](https://mesonbuild.com) as its build system. There is a
long list of dependencies that is not currently documented here due to
differences in package names across operating systems. We plan to fix this
soon, if you have any suggestions on how to handle this, please let us know.

You can quickly build Pidgin with the following commands:

```
do-release-upgrade
sudo apt-get install build-essential libgirepository1.0-dev python3-pip libnice-dev libgtk-4-bin libgtk-4-common valac libgtk-4-dev libgtk-4-doc mercurial libgumbo-dev libcmark-dev help2man libjson-glib-1.0-0 libjson-glib-dev liblua5.1-0-dev lua5.4 lua5.3 liblua5.3-dev lua-lgi liblua5.4-dev libglib-object-introspection-perl python-gi-dev libsasl2-dev libcanberra-dev libgtk-3-dev
pip3 install --upgrade meson
git clone --branch main https://github.com/cacticouncil/pidgin.git
cd pidgin
meson build
cd build
ninja
sudo ninja install
```
You may have to do ldconfig if it does not launch
If permissions fail run sudo ldconfig

If python error, try the following commands
sudo -i
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py
python3 -m pip install meson

Then exit the prompt to return to wsl and run sudo ninja install again.

```
There are quite a few options for the build that you can view by running
`meson configure` in your build directory. You can specify the options when
running meson like the following:

```
meson -Ddebug=true build
```

If you have already run `meson` you can use `meson configure`:

```
cd build
meson configure -Ddebug=true
```

## Running

Currently Pidgin can not be run from a build directory, which means you must
install it first. Once you've done that, you only need to run `pidgin3` or
`finch3`. If it fails to launch you may need to run `ldconfig` as root.

To get started, simply add a new account.

If you come across a bug, please report it at:
[issues.imfreedom.org/issues/PIDGIN](https://issues.imfreedom.org/issues/PIDGIN)

## Plugins

libpurple, Pidgin, and Finch ship with a number of plugins, but you can find
additional third party plugins at
[pidgin.im/plugins](https://pidgin.im/plugins).

## Developing

You can find more information about Pidgin development in the
[development section](https://pidgin.im/development/) of our website.