https://github.com/riobard/bash-powerline

Powerline-style Bash prompt in pure Bash script. See also https://github.com/riobard/zsh-powerline
https://github.com/riobard/bash-powerline

bash powerline shell

Last synced: about 1 month ago
JSON representation

Powerline-style Bash prompt in pure Bash script. See also https://github.com/riobard/zsh-powerline

• Host: GitHub
• URL: https://github.com/riobard/bash-powerline
• Owner: riobard
• License: unlicense
• Created: 2013-07-18T00:13:14.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2023-07-06T04:20:33.000Z (over 1 year ago)
• Last Synced: 2024-10-15T14:25:25.107Z (about 2 months ago)
• Topics: bash, powerline, shell
• Language: Shell
• Homepage:
• Size: 367 KB
• Stars: 894
• Watchers: 22
• Forks: 169
• Open Issues: 16
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-bash - bash-powerline - Powerline-style Bash prompt in pure Bash script (Prompts and Color Themes / Reusable Things)
• terminals-are-sexy - bash-powerline - Powerline-style Bash prompt in pure Bash script. (Shells / Bash)
• fucking-terminals-are-sexy - bash-powerline - Powerline-style Bash prompt in pure Bash script. (Shells / Bash)
• awesome-hacking-lists - riobard/bash-powerline - Powerline-style Bash prompt in pure Bash script. See also https://github.com/riobard/zsh-powerline (Shell)

README

        
# bash-powerline

Powerline for Bash in pure Bash script.

![bash-powerline](https://raw.github.com/riobard/bash-powerline/master/screenshots/solarized-light.png)

## Features

* Git: show branch name, tag name, or unique short hash.

* Git: show "*" symbol with uncommited modifications.

* Git: show "↑" symbol and number of commits ahead of remote.

* Git: show "↓" symbol and number of commits behind remote.

* Platform-dependent prompt symbols.

* Color-coded prompt symbol according to previous command execution status.

* Use Bash builtin when possible to reduce delay. Delay sucks!

* No need for patched fonts.

## Installation

Download the Bash script

    curl https://raw.githubusercontent.com/riobard/bash-powerline/master/bash-powerline.sh > ~/.bash-powerline.sh

And source it in your `.bashrc`

    source ~/.bash-powerline.sh

For best result, use [Solarized

colorscheme](https://github.com/altercation/solarized) for your terminal

emulator. Or hack your own colorscheme by modifying the script. It's really

easy.

## Why?

This script is inspired by

[powerline-shell](https://github.com/milkbikis/powerline-shell), which is

implemented in Python. Python scripts are much easier to write and maintain than

Bash scripts, but invoking Python interpreter introduces noticable delay to

draw. I hate delays, so I ported just the part I need to pure Bash script.

The other reason is that I don't like the idea of patching fonts. The

font patching mechanism from the original Powerline does not work with the

bitmap font (Apple Monaco without anti-aliasing) I use on non-retina screens.

I'd rather stick with existing unicode symbols.

## See also

* [zsh-powerline](https://github.com/riobard/zsh-powerline): Same thing but for

    Zsh.

* [powerline](https://github.com/Lokaltog/powerline): Unified Powerline

  written in Python. This is the future of all Powerline derivatives.

* [vim-powerline](https://github.com/Lokaltog/vim-powerline): Powerline in Vim

  writtien in pure Vimscript. Deprecated.

* [tmux-powerline](https://github.com/erikw/tmux-powerline): Powerline for Tmux

  written in Bash script. Deprecated.

* [powerline-shell](https://github.com/milkbikis/powerline-shell): Powerline for

  Bash/Zsh/Fish implemented in Python. Might be merged into the unified

  Powerline.

* [emacs powerline](https://github.com/milkypostman/powerline): Powerline for

  Emacs