NAME

       powerline - Powerline prompt and statusline script.

SYNOPSIS

          powerline EXT [SIDE] [-rMODULE] [-wWIDTH] [--last-exit-code=INT]
                    [--last-pipe-status=LIST] [--jobnum=INT]
                    [-cKEY.KEY=VALUE]… [-tTHEME.KEY.KEY=VALUE]… [-RKEY=VAL]…
                    [-pPATH]… [--socket=ADDRESS]

DESCRIPTION

       EXT    Extension:  application  for  which  powerline  command  is launched (usually shell or tmux). Also
              supports wm. extensions: wm.awesome.

       SIDE   Side: left and right represent left and right  side  respectively,  above  emits  lines  that  are
              supposed  to  be printed just above the prompt and aboveleft is like concatenating above with left
              with the exception that only one Python instance is used in this case. May  be  omitted  for  wm.*
              extensions.

       -r, --renderer-module MODULE
              Renderer   module.   Usually   something   like   .bash  or  .zsh  (with  leading  dot)  which  is
              powerline.renderers.{ext}{MODULE}, may also be full module name (must contain at least one dot  or
              end with a dot in case it is top-level module) or powerline.renderers submodule (in case there are
              no dots).

       -w, --width WIDTH
              Maximum prompt with. Triggers truncation of some segments.

       --last-exit-code INT
              Last exit code.

       --last-pipe-status LIST
              Like above, but is supposed to  contain  space-separated  array  of  statuses,  representing  exit
              statuses of commands in one pipe.

       --jobnum INT
              Number of jobs.

       -c, --config-override KEY.KEY=VALUE
              Configuration  overrides  for  config.json.  Is  translated  to  a  dictionary and merged with the
              dictionary obtained from actual JSON configuration: KEY.KEY=VALUE is translated to {"KEY": {"KEY":
              VALUE}}  and then merged recursively. VALUE may be any JSON value, values that are not null, true,
              false, start with digit, {, [ are treated like strings. If VALUE is omitted then corresponding key
              is removed.

       -t, --theme-override THEME.KEY.KEY=VALUE
              Like  above,  but  theme-specific.  THEME  should  point to an existing and used theme to have any
              effect, but it is fine to use any theme here.

       -R, --renderer-arg KEY=VAL
              Like above, but provides argument for renderer. Is supposed to be used only by shell  bindings  to
              provide  various  data  like last-exit-code or last-pipe-status (they are not using --renderer-arg
              for historical resons: --renderer-arg was added later).

       -p, --config-path PATH
              Path to configuration directory. If it is present then configuration files will only be seeked  in
              the provided path. May be provided multiple times to search in a list of directories.

       --socket ADDRESS
              Socket  address to use in daemon clients. Is always UNIX domain socket on linux and file socket on
              Mac OS X. Not used here, present  only  for  compatibility  with  other  powerline  clients.  This
              argument  must  always  be  the  first  one  and be in a form --socket ADDRESS: no = or short form
              allowed (in other powerline clients, not here).

       -h, --help
              Display help and exit.

AUTHOR

       Written by Kim Silkebækken, Nikolay Pavlov, Kovid Goyal and contributors. The glyphs in the font  patcher
       are created by Fabrizio Schiavi.

REPORTING BUGS

       Report powerline bugs to https://github.com/powerline/powerline/issues.

SEE ALSO

       powerline-daemon(1), powerline-config(1)