61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# Powerline Multiline Theme
|
|
|
|
Colorfull multiline theme, the first line shows information about your shell session (divided into two parts, left and right), the second one is where the shell commands are introduced.
|
|
|
|
**IMPORTANT:** This theme has a requirement, [a font with the Powerline symbols](https://github.com/powerline/fonts) need tu be used in your terminal emulator, otherwise, the prompt won't be displayed correctly.
|
|
|
|
## Information provided
|
|
|
|
* Current path
|
|
* Current username and hostname
|
|
* An indicator when connected by SSH
|
|
* An indicator when sudo has the credentials cached (see the sudo manpage for more info about this)
|
|
* An indicator when the current shell is inside the Vim editor
|
|
* Battery charging status (depends on the battery plugin)
|
|
* Repository status
|
|
* The current Python enviroment (Virtualenv, venv, and Conda are supported) in use
|
|
* The current Ruby enviroment (RVM) in use
|
|
* Last command exit code (only shown when the exit code is greater than 0)
|
|
|
|
## Configuration
|
|
|
|
This theme is pretty configurable, all the configuration is done by setting environment variables.
|
|
|
|
### User information
|
|
|
|
By default, the username and hostname are shown at the right side, but you can change this behavior setting the value of the following variable:
|
|
|
|
POWERLINE_PROMPT_USER_INFO_MODE
|
|
|
|
for now, the only supported value is `sudo`, that hides the username and hostname, and shows an indicator when the sudo has the credentials cached. Any other value has no effect.
|
|
|
|
### Clock format
|
|
|
|
By default, the current time is shown at the right side, you can change the format with the variable:
|
|
|
|
POWERLINE_PROMPT_CLOCK_FORMAT="%H:%M:%S"
|
|
|
|
the date is printed by the `date` command, so refer to its man page to change the format.
|
|
|
|
### Segment order
|
|
|
|
Both prompt sides can be "reordered", all the "segments" (every piece of information) can take any place, the current available segments are:
|
|
|
|
* battery
|
|
* clock
|
|
* cwd
|
|
* in_vim
|
|
* python_venv
|
|
* rvm
|
|
* scm
|
|
* user_info
|
|
|
|
Two variables can be defined to set the order of the prompt segments:
|
|
|
|
POWERLINE_LEFT_PROMPT="scm python_venv rvm cwd"
|
|
POWERLINE_RIGHT_PROMPT="in_vim clock battery user_info"
|
|
|
|
the example values are the defaults, but if you want to remove something else from the prompt, simply remove the "string" that represents the segment from the corresponding variable.
|
|
|
|
|