1POWERLINE(1)                       Powerline                      POWERLINE(1)
2
3
4

NAME

6       powerline - Powerline prompt and statusline script.
7

SYNOPSIS

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

DESCRIPTION

15       EXT    Extension:  application  for which powerline command is launched
16              (usually shell or tmux). Also supports wm.  extensions:  wm.awe‐
17              some.
18
19       SIDE   Side: left and right represent left and right side respectively,
20              above emits lines that are supposed to be printed just above the
21              prompt  and aboveleft is like concatenating above with left with
22              the exception that only one Python  instance  is  used  in  this
23              case. May be omitted for wm.* extensions.
24
25       -r, --renderer-module MODULE
26              Renderer  module.  Usually  something  like  .bash or .zsh (with
27              leading dot)  which  is  powerline.renderers.{ext}{MODULE},  may
28              also  be  full module name (must contain at least one dot or end
29              with a dot in case it is top-level module) or  powerline.render‐
30              ers submodule (in case there are no dots).
31
32       -w, --width WIDTH
33              Maximum prompt with. Triggers truncation of some segments.
34
35       --last-exit-code INT
36              Last exit code.
37
38       --last-pipe-status LIST
39              Like  above, but is supposed to contain space-separated array of
40              statuses, representing exit statuses of commands in one pipe.
41
42       --jobnum INT
43              Number of jobs.
44
45       -c, --config-override KEY.KEY=VALUE
46              Configuration overrides for config.json. Is translated to a dic‐
47              tionary and merged with the dictionary obtained from actual JSON
48              configuration: KEY.KEY=VALUE is translated  to  {"KEY":  {"KEY":
49              VALUE}}  and  then  merged  recursively.  VALUE  may be any JSON
50              value, values that are not null, true, false, start with  digit,
51              {,  [  are treated like strings. If VALUE is omitted then corre‐
52              sponding key is removed.
53
54       -t, --theme-override THEME.KEY.KEY=VALUE
55              Like above, but theme-specific. THEME should point to an  exist‐
56              ing and used theme to have any effect, but it is fine to use any
57              theme here.
58
59       -R, --renderer-arg KEY=VAL
60              Like above, but provides argument for renderer. Is  supposed  to
61              be  used  only  by  shell  bindings to provide various data like
62              last-exit-code or last-pipe-status (they are  not  using  --ren‐
63              derer-arg  for  historical  reasons:  --renderer-arg  was  added
64              later).
65
66       -p, --config-path PATH
67              Path to configuration directory. If it is present then  configu‐
68              ration  files  will  only be sought in the provided path. May be
69              provided multiple times to search in a list of directories.
70
71       --socket ADDRESS
72              Socket address to use in daemon clients. Is always  UNIX  domain
73              socket  on  linux  and  file  socket on Mac OS X. Not used here,
74              present only for compatibility  with  other  powerline  clients.
75              This  argument  must  always  be  the first one and be in a form
76              --socket ADDRESS: no = or short form allowed (in other powerline
77              clients, not here).
78
79       -h, --help
80              Display help and exit.
81

AUTHOR

83       Written  by  Kim Silkebækken, Nikolay Pavlov, Kovid Goyal and contribu‐
84       tors. The glyphs in the font patcher are created by Fabrizio Schiavi.
85

REPORTING BUGS

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

SEE ALSO

90       powerline-daemon(1), powerline-config(1)
91
92
93
94
95beta                             Oct 07, 2023                     POWERLINE(1)
Impressum