Skip to main content

Powerline for Xonsh shell

Project description

Xontrib Powerline 2

xontrib-powerline fork by santagada/xontrib-powerline.



pip install xontrib-powerline2

And them load it on your .xonshrc

xontrib load powerline2


There are two variables that can be set, $PROMPT for main prompt, $PL_PROMPT for the right prompt and $PL_TOOLBAR for the bottom toolbar. They contain a list of sections that can be used separated by >. The value ! means not to use that prompt.


$PL_RPROMPT = '!'  # for no toolbar
$PL_TOOLBAR = 'who>virtualenv>branch>cwd>full_proc'
xontrib load powerline

Bulid prompt

If you want to override the settings after xontrib load, so commit changes to your prompt execute pl_build_prompt command.

Check config

To see all available sections type pl_available_sections command.


Default sections

section description
who {user}@{hostname}
virtualenv {env_name}
branch {curr_branch}
cwd $pwd using $pl_colors['cwd', 'git_root', 'git_sub_dir'] and $pl_parts
short_cwd {short_cwd}
full_proc run time of the previous command from history
timing diff from previous command's executed time
time strftime(' %h:%m ')
history len(__xonsh__.history)
rtns '!' if __xonsh__.history.rtns else none
full_rtns rtns[-1] if __xonsh__.history.rtns else none

If you want to know about {} sections, please look xonsh document.

Custom sections

We can add customize origin section by $PL_EXTRA_SEC.

# func return [format string, text color, background color]
$PL_EXTRA_SEC = {"user": lambda: [' I'm {user} ', 'BLACK', '#fd971f']}
xontrib load powerline

Section's color

We can change section color by $PL_COLORS.

$PL_COLORS is dict. Basically, the value is (text_color, background_color). |key|default value|description| |---|---|---| |who| ("BLACK", "#a6e22e") || |venv| ("BLACK", "INTENSE_GREEN") || |branch| ("#333") | background color from $PROMPT_FIELDS['branch_bg_color'] | |cwd| ("WHITE", "#444") || |git_root| ("BLACK", "#00adee") | used by cwd | |git_sub_dir| ("WHITE", "#00adee") | used by cwd | |short_cwd| ("WHITE", "#444") || |full_proc| ("WHITE", "RED", "#444") |There are two types of background depending on the situation| |timing| ("WHITE", "#444") || |time| ("BLACK", "#00adee") || |history| ("WHITE", "#333333") || |rtns| ("WHITE", "RED") || |full_rtns| ("WHITE", "RED", "#444") |There are two types of background depending on the situation|

Separate mode

We can change the way of separation mode by $PL_SEP_MODE.

mode separate char
powerline , , , 
round , , , 
down , , , 
up , , , 
flame , , , 
squares , , , 
ruiny , , , 
lego , 

For example

# set $PL_SEP_MODE or using pl_set_mode alias
pl_set_mode round

If you want to use original separeter, you can use $PL_ORG_SEP, $PL_ORG_SEP_THIN, $PL_ORG_RSEP.

$PL_ORG_SEP = '■'
$PL_ORG_RSEP = '■'
xontrib load xontrib-powerline2


Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for xontrib-powerline2, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size xontrib_powerline2-1.0.0-py3-none-any.whl (6.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page