1
0
mirror of https://github.com/profanity-im/profanity.git synced 2024-11-03 19:37:16 -05:00
Go to file
James Booth 6644fa953e Command list size now calculated
No longer have to specify size, and keep it up to date
when adding new commands
2012-08-10 23:18:02 +01:00
src Command list size now calculated 2012-08-10 23:18:02 +01:00
tests Added autobuild tools 2012-07-01 14:47:09 +01:00
.gitignore Cleaning up memory allocated by ncurses pads 2012-07-31 23:01:15 +01:00
bootstrap.sh Moved config.h to source folder 2012-07-01 14:52:45 +01:00
configure.ac Changed version to 0.1.5 2012-07-31 23:03:29 +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
install-all.sh Added libcurl-devel to Fedora dependencies 2012-07-29 02:09:20 +01:00
Makefile.am Tidy up autotools scripts, removed CFLAGS 2012-07-30 00:46:39 +01:00
README.md Update README 2012-07-20 00:43:17 +01:00
runvalgrind.sh Reverted ncurses cleanup 2012-07-31 23:13:18 +01:00
TODO Update master 2012-07-09 02:51:04 +02:00

Profanity

Profanity is a console based jabber client inspired by Irssi,

Installation

For a full install guide from scratch, including how to install dependencies see the wiki install 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