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.

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>.

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  -  2020
       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>