2022-03-30 10:49:07 +00:00
|
|
|
.TH man 1 "2022-03-30" "0.12.0" "Profanity XMPP client"
|
2012-08-19 19:34:05 +00:00
|
|
|
.SH NAME
|
2012-11-21 22:33:07 +00:00
|
|
|
Profanity \- a simple console based XMPP chat client.
|
2012-08-19 19:34:05 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B profanity
|
2015-10-17 23:17:45 +00:00
|
|
|
[\-vh] [\-l level] [\-a account]
|
2012-08-19 19:34:05 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.B Profanity
|
2018-10-20 08:50:31 +00:00
|
|
|
is a simple lightweight console based XMPP chat client. Its emphasis is
|
2012-11-21 22:33:07 +00:00
|
|
|
on having a simple and configurable command driven UI, see the homepage
|
2012-08-21 23:33:22 +00:00
|
|
|
at:
|
|
|
|
|
.br
|
|
|
|
|
.PP
|
2019-05-03 08:27:13 +00:00
|
|
|
<https://profanity-im.github.io>
|
2012-08-19 19:34:05 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
.BI "\-v, \-\-version"
|
2015-02-10 23:30:21 +00:00
|
|
|
Show version and build information.
|
2012-08-19 19:34:05 +00:00
|
|
|
.TP
|
|
|
|
|
.BI "\-h, \-\-help"
|
|
|
|
|
Show help on command line arguments.
|
|
|
|
|
.TP
|
2015-02-10 23:30:21 +00:00
|
|
|
.BI "\-a, \-\-account "ACCOUNT
|
|
|
|
|
Auto connect to an account on startup,
|
|
|
|
|
.I ACCOUNT
|
|
|
|
|
must be an existing account.
|
2014-04-23 21:43:05 +00:00
|
|
|
.TP
|
2019-08-02 13:28:28 +00:00
|
|
|
.BI "\-c, \-\-config"
|
|
|
|
|
Use an alternative config file.
|
|
|
|
|
.TP
|
2015-02-10 23:30:21 +00:00
|
|
|
.BI "\-l, \-\-log "LEVEL
|
2012-08-19 19:34:05 +00:00
|
|
|
Set the logging level,
|
|
|
|
|
.I LEVEL
|
|
|
|
|
may be set to DEBUG, INFO (the default), WARN or ERROR.
|
2020-05-16 08:02:19 +00:00
|
|
|
.TP
|
|
|
|
|
.BI "\-f, \-\-logfile"
|
|
|
|
|
Specify a different logfile
|
|
|
|
|
.TP
|
|
|
|
|
.BI "\-t, \-\-theme "THEME
|
|
|
|
|
Specify which theme to use.
|
|
|
|
|
.I THEME
|
|
|
|
|
must be one of the themes installed in $XDG_CONFIG_HOME/profanity/themes
|
2021-08-31 20:33:00 +00:00
|
|
|
.SH KEYBINDINGS
|
2022-03-30 17:59:21 +00:00
|
|
|
.TP
|
|
|
|
|
.BR Tab , " Shift+Tab"
|
|
|
|
|
Tab completion next, previous. Works for commands, nicks and
|
|
|
|
|
quotes (when input line starts with
|
|
|
|
|
.BR > ).
|
|
|
|
|
.TP
|
|
|
|
|
.BR ALT+1..Alt-0 " or " F1..F10
|
|
|
|
|
Choose window 1..10.
|
|
|
|
|
.TP
|
|
|
|
|
.BR ALT+q..Alt-p " (in QWERTY layout)"
|
|
|
|
|
Choose window 11..20.
|
2021-09-15 09:24:59 +00:00
|
|
|
.TP
|
|
|
|
|
.BI ALT+LEFT
|
|
|
|
|
Choose previous chat window.
|
|
|
|
|
.TP
|
|
|
|
|
.BI ALT+RIGHT
|
|
|
|
|
Choose next chat window.
|
|
|
|
|
.TP
|
|
|
|
|
.BI PAGEUP
|
|
|
|
|
Page the active window up.
|
|
|
|
|
.TP
|
|
|
|
|
.BI PAGEDOWN
|
|
|
|
|
Page the active window down.
|
|
|
|
|
.TP
|
|
|
|
|
.BI ALT+PAGEUP
|
|
|
|
|
Page the occupants or roster panel up.
|
|
|
|
|
.TP
|
|
|
|
|
.BI ALT+PAGEDOWN
|
|
|
|
|
Page the occupants or roster panel down.
|
|
|
|
|
.TP
|
2021-08-31 20:33:00 +00:00
|
|
|
.BI ALT+a
|
|
|
|
|
Jump to the next unread window.
|
|
|
|
|
.TP
|
|
|
|
|
.BI ALT+v
|
|
|
|
|
Mark current window for later reading with an attention flag.
|
|
|
|
|
.TP
|
|
|
|
|
.BI ALT+m
|
|
|
|
|
Switch between windows marked with the attention flag.
|
2022-03-30 17:59:21 +00:00
|
|
|
.TP
|
|
|
|
|
.BI ALT+c
|
|
|
|
|
Run external editor (see
|
|
|
|
|
.BR profanity-editor (1))
|
|
|
|
|
for current input line.
|
|
|
|
|
.TP
|
|
|
|
|
.BI CTRL+DOWN
|
|
|
|
|
Store current input line in history but do not execute it.
|
2012-08-19 20:14:13 +00:00
|
|
|
.SH USING PROFANITY
|
2019-05-03 08:27:13 +00:00
|
|
|
The user guide can be found at <https://profanity-im.github.io/userguide.html>.
|
2012-08-19 19:34:05 +00:00
|
|
|
.SH SEE ALSO
|
|
|
|
|
.B Profanity
|
|
|
|
|
itself has a lot of built\-in help. Check the /help command for more information.
|
2012-08-19 19:35:53 +00:00
|
|
|
Type "/help help" for information on how to use help itself.
|
2020-12-04 16:50:30 +00:00
|
|
|
Profanity ships with one man page for each built-in command. For /account there is man profanity-account.
|
2012-08-19 19:34:05 +00:00
|
|
|
.SH CONFIGURATION
|
|
|
|
|
Configuration for
|
|
|
|
|
.B Profanity
|
|
|
|
|
is stored in
|
2012-11-25 22:05:00 +00:00
|
|
|
.I $XDG_CONFIG_HOME/profanity/profrc
|
2019-05-03 08:27:13 +00:00
|
|
|
, details on commands for configuring Profanity can be found at <https://profanity-im.github.io/reference.html>.
|
2012-08-21 23:30:24 +00:00
|
|
|
.SH BUGS
|
2015-02-10 23:30:21 +00:00
|
|
|
Bugs can either be reported by raising an issue at the Github issue tracker:
|
2012-08-21 23:30:24 +00:00
|
|
|
.br
|
|
|
|
|
.PP
|
2019-05-03 08:51:28 +00:00
|
|
|
<https://github.com/profanity-im/profanity/issues>
|
2012-08-21 23:30:24 +00:00
|
|
|
.br
|
|
|
|
|
.PP
|
|
|
|
|
or to the mailing list at:
|
|
|
|
|
.br
|
|
|
|
|
.PP
|
2020-05-16 07:48:34 +00:00
|
|
|
<https://lists.notraces.net/mailman/listinfo/profanity>
|
2012-08-21 23:30:24 +00:00
|
|
|
.br
|
|
|
|
|
.SH LICENSE
|
2019-04-23 23:08:38 +00:00
|
|
|
Copyright (C) 2012 \- 2019 James Booth <boothj5web@gmail.com>.
|
2020-05-16 08:03:55 +00:00
|
|
|
Copyright (C) 2019 \- 2020 Michael Vetter <jubalh@iodoru.com>.
|
2016-07-21 10:49:52 +00:00
|
|
|
License GPLv3+: GNU GPL version 3 or later <https://www.gnu.org/licenses/gpl.html>
|
2012-08-21 23:30:24 +00:00
|
|
|
This is free software; you are free to change and redistribute it.
|
|
|
|
|
There is NO WARRANTY, to the extent permitted by law.
|
2012-08-19 19:34:05 +00:00
|
|
|
.SH AUTHORS/CREDITS
|
|
|
|
|
.B Profanity
|
2020-05-16 08:03:55 +00:00
|
|
|
was created by James Booth
|
2012-08-21 23:30:24 +00:00
|
|
|
.B <boothj5web@gmail.com>
|
2019-05-03 08:51:28 +00:00
|
|
|
with many contributions from others, see the full list at: <https://github.com/profanity-im/profanity/graphs/contributors>
|
