about summary refs log tree commit diff stats
path: root/README.md
blob: fd3ed081bcd2a4c655edb41096b2077f971484ba (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# Profanity
![Build Status](https://github.com/profanity-im/profanity/workflows/CI/badge.svg) [![GitHub contributors](https://img.shields.io/github/contributors/profanity-im/profanity.svg)](https://github.com/profanity-im/profanity/graphs/contributors/) [![Packaging status](https://repology.org/badge/tiny-repos/profanity.svg)](https://repology.org/project/profanity/versions)

Profanity is a console based XMPP client inspired by [Irssi](http://www.irssi.org/).

If you like Profanity consider becoming a sponsor or [donate](https://profanity-im.github.io/donate.html) some money.

![alt tag](https://profanity-im.github.io/images/prof-2.png)

See the [User Guide](https://profanity-im.github.io/userguide.html) for information on installing and using Profanity.

## Project
This project is about freedom, privacy and choice. We want to enable people to chat with one another in a safe way. Thus supporting encryption (OTR, PGP, OMEMO, OX) and being decentralized, meaning everyone can run their own server. We believe [XMPP](https://xmpp.org/) is a great proven protocol with an excellent community serving this purpose well.

Feel free to follow us on [twitter](https://twitter.com/profanityim), join our [mailing list](https://lists.datenkollektiv.net/postorius/lists/profanity.lists.notraces.net) and/or [MUC](xmpp:profanity@rooms.dismail.de?join).

## Installation
Our [user guide](https://profanity-im.github.io/userguide.html) contains an [install](https://profanity-im.github.io/guide/latest/install.html) section and a section for [building](https://profanity-im.github.io/guide/latest/build.html) from source yourself.

## Donations
We would highly appreciate it if you support us via [GitHub Sponsors](https://github.com/sponsors/jubalh/). Especially if you make feature requests or need help using Profanity.
Sponsoring enables us to spend time on Profanity.

An alternative way to support us would be to ask for our IBAN.

Issues backed by a sponsor will be tagged with the [sponsored](https://github.com/profanity-im/profanity/issues?q=label%3Asponsored+) label.
Feature requests that we consider out of scope, either because of interest or because of time needed to implement them, will be marked with the [unfunded](https://github.com/profanity-im/profanity/issues?q=label%3Aunfunded) label.

Another way to sponsor us or get an issue solved is to comment on an issue that you are willing to sponsor it. 

Tasks from our [sponsors](SPONSORS.md) will be tackled first.

Thank you! <3

## How to contribute
We tried to sum things up on our [helpout](https://profanity-im.github.io/helpout.html) page.
Additionally you can check out our [blog](https://profanity-im.github.io/blog/) where we have articles like:
[How to get a backtrace](https://profanity-im.github.io/blog/post/how-to-get-a-backtrace/) and [Contributing a Patch via GitHub](https://profanity-im.github.io/blog/post/contributing-a-patch-via-github/).
For more technical details check out our [CONTRIBUTING.md](CONTRIBUTING.md) file.

## Getting help
To get help, first read our [User Guide](https://profanity-im.github.io/userguide.html) then check out the [FAQ](https://profanity-im.github.io/faq.html).
If you have are having a problem then first search the [issue tracker](https://github.com/profanity-im/profanity/issues).
If you don't find anything there either come to our [MUC](xmpp:profanity@rooms.dismail.de?join) or create a new issue depending on what your problem is.

## Links

### Website
URL: https://profanity-im.github.io

Repo: https://github.com/profanity-im/profanity-im.github.io

### Blog
URL: https://profanity-im.github.io/blog

Repo: https://github.com/profanity-im/blog

### Mailinglist
Mailing List: https://lists.datenkollektiv.net/postorius/lists/profanity.lists.notraces.net

### Chatroom
MUC: profanity@rooms.dismail.de

### Plugins
Plugins repository: https://github.com/profanity-im/profanity-plugins