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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
Profanity
=========
Profanity is a console based jabber client inspired by [Irssi](http://www.irssi.org/),
Installation
------------
For a full install guide from scratch, including how to install dependencies see [the wiki install guide](https://github.com/boothj5/profanity/wiki/Installation-guide).
Dependencies: ncurses, libstrophe, glib, expat, xml2 and openssl.
Optional Dependencies: libnotify
Libstrophe can be found at: https://github.com/metajack/libstrophe
To run unit tests requires head-unit: https://github.com/boothj5/head-unit
All other dependencies should have packages for your distribution.
Once depdendencies have been installed, run:
./bootstrap.sh
./configure
make
To build and install in the current directory.
If you wish to install on the system, switch to root, or sudo and:
make install
To run tests:
make check
Running
-------
Usage:
profanity [OPTION...]
Help Options:
-h, --help Show help options
Application Options:
-v, --version Show version information
-d, --disable-tls Disable TLS
Some older jabber servers advertise SSL/TLS support but don't respond to the handshake,
if you have trouble connecting, run with the `--disable-tls` option:
Preferences
-----------
User preferences are stored in
~/.profanity/config
The following example is described below:
[ui]
beep=false
flash=true
showsplash=true
notify=true
[connections]
logins=mylogin@jabber.org;otherlogin@gmail.com
[colours]
bkgnd=default
text=white
online=green
offline=red
err=red
inc=yellow
bar=green
bar_draw=black
bar_text=black
The `[ui]` section contains preferences for user interface behaviour:
beep: Try to sound beep on incoming messages if the terminal supports it
flash: Try to make the terminal flash on incoming messages if the terminal supports it
notify: Send a desktop notification on incoming messages
showsplash: Show the ascii logo on startup
The `[connections]` section contains a history of logins you've used already, so profanity can autocomplete them for you.
This section is populated automatically when you login with a new username.
The `[colours]` sections allows you to theme profanity. Available colours are
black, white, red, green, blue, yellow, cyan, magenta
Setting a colour to `default`, lets the terminal use whatever default it would use for foreground/background depending on the setting.
Using
-----
Commands in profanity all start with `/`.
To get a list of possible commands, and find out how to navigate around try:
/help
|