1POWERLINE(1) Powerline POWERLINE(1)
2
6 powerline - Powerline prompt and statusline script.
7
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
15 EXT Extension: application for which powerline command is launched
16 (usually shell or tmux). Also supports wm. extensions: wm.awe‐
17 some.
18 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 -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 -w, --width WIDTH
33 Maximum prompt with. Triggers truncation of some segments.
34 --last-exit-code INT
36 Last exit code.
37 --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 --jobnum INT
43 Number of jobs.
44 -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 -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 -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 -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 --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 -h, --help
80 Display help and exit.
81
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
87 Report powerline bugs to https://github.com/powerline/powerline/issues.
88
90 powerline-daemon(1), powerline-config(1)
91beta Mar 03, 2021 POWERLINE(1)