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 reasons: --renderer-arg was added later).

       -p, --config-path PATH
              Path  to configuration directory. If it is present then configuration files will only be sought 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)

beta                                            January 22, 2025                                    POWERLINE(1)