1
0
mirror of https://github.com/profanity-im/profanity.git synced 2024-12-04 14:46:46 -05:00
Go to file
2012-07-07 23:57:52 +01:00
.gitignore Started work on bash style history 2012-04-30 01:09:42 +01:00
command.c Added notify preference 2012-06-28 23:45:37 +01:00
command.h Added command autocomplete 2012-06-04 23:59:09 +01:00
common.c Added common module for glib compatibility 2012-05-19 21:56:23 +01:00
common.h Backward compatibility for libnotify pre 0.7.0 2012-06-29 00:47:14 +01:00
contact_list.c Only update a contact if data changed 2012-05-24 00:33:23 +01:00
contact_list.h Added result to add and remove from autocomplete 2012-05-23 23:46:54 +01:00
contact.c Only update a contact if data changed 2012-05-24 00:33:23 +01:00
contact.h Only update a contact if data changed 2012-05-24 00:33:23 +01:00
COPYING Added GPL 2012-02-20 20:07:38 +00:00
DESIGN Merge branch 'presence' 2012-05-26 16:20:03 +01:00
history.c Refactored history 2012-05-02 02:14:29 +01:00
history.h Bash style history 2012-05-01 00:24:31 +01:00
input_win.c Removed whitespace 2012-07-07 23:57:52 +01:00
jabber.c escaping XML tags and fixed a small memory leak 2012-07-03 18:47:16 +01:00
jabber.h Allow message with status updates 2012-05-28 23:40:11 +01:00
log.c Added GPL 2012-02-20 20:07:38 +00:00
log.h DIsabling tls on server 2012-02-26 03:15:42 +00:00
main.c Removed commented code from main 2012-04-24 00:50:43 +01:00
Makefile Added desktop notification 2012-06-28 23:29:46 +01:00
preferences.c Added notify preference 2012-06-28 23:45:37 +01:00
preferences.h Added notify preference 2012-06-28 23:45:37 +01:00
prof_autocomplete.c Only update a contact if data changed 2012-05-24 00:33:23 +01:00
prof_autocomplete.h Only update a contact if data changed 2012-05-24 00:33:23 +01:00
prof_history.c Added license to new files 2012-05-02 00:15:56 +01:00
prof_history.h Added license to new files 2012-05-02 00:15:56 +01:00
profanity.c Added basic colour preferences loading 2012-06-18 23:06:17 +01:00
profanity.h Usage of const 2012-03-09 01:06:55 +00:00
README.md Update master 2012-07-05 00:00:03 +02:00
status_bar.c Removed dependency on preferences from status bar 2012-06-28 23:18:52 +01:00
test_contact_list.c Changed contact list to use generic autocomplete 2012-05-13 23:06:01 +01:00
test_prof_autocomplete.c Added more autcomplete tests, test updating items 2012-05-24 00:38:54 +01:00
test_prof_history.c Fixed segfault in prof_history 2012-05-01 22:09:33 +01:00
test_util.c Removed trim method from util 2012-04-26 23:27:40 +01:00
testsuite.c Autocomplte uses default functions 2012-05-18 01:33:40 +01:00
testsuite.h Autocomplte uses default functions 2012-05-18 01:33:40 +01:00
title_bar.c Added remaining colours 2012-06-18 23:49:59 +01:00
TODO Removed item from TODO and added issue instead 2012-05-10 23:57:31 +01:00
ui.h Commands for presence updates 2012-05-27 20:36:31 +01:00
util.c Added command autocomplete 2012-06-04 23:59:09 +01:00
util.h Added command autocomplete 2012-06-04 23:59:09 +01:00
windows.c Changed notify urgency 2012-06-28 23:51:49 +01:00

Profanity

Profanity is a console based jabber client inspired by Irssi,

Installation

Dependencies: ncurses, libstrophe, glib, expat, xml2 and openssl.

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:

make

To build and install in the current directory.

Running

./profanity

Some older jabber servers advertise SSL/TLS support but don't respond to the handshake, if you have trouble connecting, run with the -notls option:

./profanity -notls

Preferences

User preferences are stored in

~/.profanity

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