man(1)

NAME
Profanity - a simple console based XMPP chat client.

SYNOPSIS
profanity [-vh] [-l level] [-a account]

DESCRIPTION
Profanity is a simple lightweight console based XMPP chat client. Its emphasis is on having a simple and configurable command driven UI, see the homepage at:

<https://profanity-im.github.io>

OPTIONS

-v, --version
    Show version and build information.

-h, --help
    Show help on command line arguments.

-a, --account ACCOUNT
    Auto connect to an account on startup, ACCOUNT must be an existing account.

-c, --config
    Use an alternative config file.

-l, --log LEVEL
    Set the logging level, LEVEL may be set to DEBUG, INFO (the default), WARN or ERROR.

-f, --logfile
    Specify a different logfile

-t, --theme THEME
    Specify which theme to use. THEME must be one of the themes installed in $XDG_CONFIG_HOME/profanity/themes

KEYBINDINGS

Tab, Shift+Tab
    Tab completion next, previous. Works for commands, nicks and quotes (when input line starts with >).

ALT+1..Alt-0 or F1..F10
    Choose window 1..10.

ALT+q..Alt-p (in QWERTY layout)
    Choose window 11..20.

ALT+LEFT
    Choose previous chat window.

ALT+RIGHT
    Choose next chat window.

PAGEUP
    Page the active window up.

PAGEDOWN
    Page the active window down.

ALT+PAGEUP
    Page the occupants or roster panel up.

ALT+PAGEDOWN
    Page the occupants or roster panel down.

ALT+a
    Jump to the next unread window.

ALT+v
    Mark current window for later reading with an attention flag.

ALT+m
    Switch between windows marked with the attention flag.

ALT+c
    Run external editor (see profanity-editor(1)) for current input line.

CTRL+DOWN
    Store current input line in history but do not execute it.

Note: Profanity is using GNU Readline library to handle input so default configuration file ~/.inputrc affects operation. In addition to that $XDG_CONFIG_HOME/profanity/inputrc is read after all default keybindigs are set so one can override or add settings there. For reference, see Readline documentation: info readline "Command Line Editing" "Readline Init File" "Readline Init File Syntax" and the list of available Profanity commands in inputwin.c. Standard Readline keybindings are supported, including C-r for interactive history search and C-x C-r for reloading inputrc without restart.

USING PROFANITY
The user guide can be found at <https://profanity-im.github.io/userguide.html>.

SEE ALSO
Profanity itself has a lot of built-in help. Check the /help command for more information. Type "/help help" for information on how to use help itself. Profanity ships with one man page for each built-in command, e.g. there is profanity-account(1) for /account.

CONFIGURATION
Configuration for Profanity is stored in $XDG_CONFIG_HOME/profanity/profrc , details on commands for configuring Profanity can be found at <https://profanity-im.github.io/reference.html> or the respective built-in help or man pages.

BUGS
Bugs can either be reported by raising an issue at the Github issue tracker:

<https://github.com/profanity-im/profanity/issues>

or to the mailing list at:

<https://lists.notraces.net/mailman/listinfo/profanity>

LICENSE
Copyright (C) 2012 - 2019 James Booth <boothj5web@gmail.com>. Copyright (C) 2019 - 2022 Michael Vetter <jubalh@iodoru.com>. License GPLv3+: GNU GPL version 3 or later <https://www.gnu.org/licenses/gpl.html> This is free software; you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

AUTHORS/CREDITS
Profanity was created by James Booth <boothj5web@gmail.com> with many contributions from others, see the full list at: <https://github.com/profanity-im/profanity/graphs/contributors>