1man(1) Profanity XMPP client man(1)
2
6 Profanity - a simple console based XMPP chat client.
7
9 profanity [-vh] [-l level] [-a account]
10
12 Profanity is a simple lightweight console based XMPP chat client. Its
13 emphasis is on having a simple and configurable command driven UI, see
14 the homepage at:
15 <https://profanity-im.github.io>
17
19 -v, --version
20 Show version and build information.
21 -h, --help
23 Show help on command line arguments.
24 -a, --account ACCOUNT
26 Auto connect to an account on startup, ACCOUNT must be an exist‐
27 ing account.
28 -c, --config
30 Use an alternative config file.
31 -l, --log LEVEL
33 Set the logging level, LEVEL may be set to DEBUG, INFO (the de‐
34 fault), WARN or ERROR.
35 -f, --logfile
37 Specify a different logfile
38 -t, --theme THEME
40 Specify which theme to use. THEME must be one of the themes in‐
41 stalled in $XDG_CONFIG_HOME/profanity/themes
42
44 Tab, Shift+Tab
45 Tab completion next, previous. Works for commands, nicks and
46 quotes (when input line starts with >).
47 ALT+1..Alt-0 or F1..F10
49 Choose window 1..10.
50 ALT+q..Alt-p (in QWERTY layout)
52 Choose window 11..20.
53 ALT+LEFT
55 Choose previous chat window.
56 ALT+RIGHT
58 Choose next chat window.
59 PAGEUP Page the active window up.
61 PAGEDOWN
63 Page the active window down.
64 ALT+PAGEUP
66 Page the occupants or roster panel up.
67 ALT+PAGEDOWN
69 Page the occupants or roster panel down.
70 ALT+a Jump to the next unread window.
72 ALT+v Mark current window for later reading with an attention flag.
74 ALT+m Switch between windows marked with the attention flag.
76 ALT+c Run external editor (see profanity-editor(1)) for current input
78 line.
79 CTRL+DOWN
81 Store current input line in history but do not execute it.
82 Note: Profanity is using GNU Readline library to handle input so de‐
84 fault configuration file ~/.inputrc affects operation. In addition to
85 that $XDG_CONFIG_HOME/profanity/inputrc is read after all default key‐
86 bindigs are set so one can override or add settings there. For refer‐
87 ence, see Readline documentation: info readline "Command Line Editing"
88 "Readline Init File" "Readline Init File Syntax" and the list of avail‐
89 able Profanity commands in inputwin.c. Standard Readline keybindings
90 are supported, including C-r for interactive history search and C-x C-r
91 for reloading inputrc without restart.
92
94 The user guide can be found at <https://profanity-im.github.io/user‐
95 guide.html>.
96
98 Profanity itself has a lot of built-in help. Check the /help command
99 for more information. Type "/help help" for information on how to use
100 help itself. Profanity ships with one man page for each built-in com‐
101 mand, e.g. there is profanity-account(1) for /account.
102
104 Configuration for Profanity is stored in $XDG_CONFIG_HOME/profan‐
105 ity/profrc , details on commands for configuring Profanity can be found
106 at <https://profanity-im.github.io/reference.html> or the respective
107 built-in help or man pages.
108
110 Bugs can either be reported by raising an issue at the Github issue
111 tracker:
112 <https://github.com/profanity-im/profanity/issues>
114 or to the mailing list at:
116 <https://lists.notraces.net/mailman/listinfo/profanity>
118
120 Copyright (C) 2012 - 2019 James Booth <boothj5web@gmail.com>. Copy‐
121 right (C) 2019 - 2022 Michael Vetter <jubalh@iodoru.com>. License
122 GPLv3+: GNU GPL version 3 or later <https://www.gnu.org/li‐
123 censes/gpl.html> This is free software; you are free to change and re‐
124 distribute it. There is NO WARRANTY, to the extent permitted by law.
125
127 Profanity was created by James Booth <boothj5web@gmail.com> with many
128 contributions from others, see the full list at:
129 <https://github.com/profanity-im/profanity/graphs/contributors>
1300.13.1 2022-10-12 man(1)