A theme for nerds, makes fish even more powerful. It's equipped with a hell of a lot of nice functions and key bindings to speed up your workflow.
The philosophy behind budspencer theme:
- Delimit the prompt lines clearly to the output.
- Produce output only if it contains relevant information.
- Show useful notifications within the prompt.
- Equip the prompt with toggle commands in order to change its style interactively.
- Store sessions in order to make frequently used commands quickly accessible.
- Make navigation within the directory tree as easy as possible using bookmarks and a directory history without duplicates.
- Make histories quickly accessible with menus.
- Don't stress your eyes. Use different colors in dark and bright environments.
You need an up-to-date fish shell version from github or a nightly build.
Non standard tools:
- xsel
- wmctrl
- git
- svn
- taskwarrior (optional)
- remind (optional)
The theme uses advanced sed and expr features. The OS X tools have
restricted functionality.
Try expr from coreutils package if you see expr: syntax error in
budspencer prompt.
Install advanced sed and expr versions:
$ brew install coreutils gnu-sed
Add this to your ~/.config/fish/config.fish:
if test (uname -s) = "Darwin"
set -gx PATH /usr/local/opt/coreutils/libexec/gnubin $PATH
set -gx PATH /usr/local/opt/gnu-sed/libexec/gnubin $PATH
end
The theme behaves similar to vim's airline/powerline plugins. Thus, it needs a powerline font. It's also crucial to have vi mode enabled. Thus, execute
set -U fish_key_bindings fish_vi_key_bindings
before enabling the theme.
Redefine $budspencer_colors with the set command in order to change the
colors of the prompt.
Example:
set budspencer_colors 000000 333333 666666 ffffff ffff00 ff6600 ff0000 ff0033 3300ff 0000ff 00ffff
00ff00
will result in a prompt like this:
Two color schemes for bright and dark environments are predefined. You can
enable them with day and night, respectively.
Commands that shouldn't appear in the command history are defined by a universal
list $budspencer_nocmdhist. Default:
set -U budspencer_nocmdhist c d ll ls m s
Disable:
set -U budspencer_nogreeting
Reenable:
set -e budspencer_nogreeting
To show your current node version, do following in your Fish configs
set -g budspencer_alt_environment "node -v"
If you have configured your terminal application to use the visual bell, your window manager will tell you when a job running in your shell has finished. You don't need to check manually whether it's done.
If you have still activated the acoustic bell, you probably hate that feature. Switch it off in that case:
set -U budspencer_nobell
- Vi mode is indicated by color of outer segments, cursor color also changes
if terminal supports it:
- blue: NORMAL mode
- yellow: INSERT mode
- magenta: VISUAL mode
- Prompt line number
- Repository information
- Status symbols
- ✻: keep track of this shell session, can be toggled with
#to show the number of the session within the sessions list - ⌘: present working directory is in bookmark list, can be toggled with
#to show the number of the bookmark - V: vi is parent process
- R: ranger is parent process
- ⚙: there are background jobs, can be toggled with
#to show the amount of background jobs - : no write permissions in present working directory
- ⚔: there are tasks scheduled for this week, can be toggled with
#to show the amount of weekly tasks - ⚑: there are appointments for today, can be toggled with
#to show the amount of appointments - ✔: last command succeeded, can be toggled with
#to show the status value - ✘: last command failed, can be toggled with
#to show the status value - ⚡: superuser indicator
- ✻: keep track of this shell session, can be toggled with
- Present working directory
- Active Python virtual environment. Requires Virtual Fish
- Last command's duration time
- Repo status symbols:
- ↑: git repository is ahead origin
- ↓: git repository is behind origin
- +: changes have been added to git index
- –: files have been deleted in work tree
- ✱: files have been modified in work tree
- →: files have been renamed in git index
- ═: there are unmerged commits
- ●: there are untracked (new) files
- ✭: there are stashed commits
The following shortcuts need vi-mode:
- Style of "present working directory"-segment can be toggled in NORMAL and in
VISUAL mode with space bar
- styles implemented:
short(shows username, short hostname and truncated path; recommended in most cases)long(shows username, full hostname and full path; useful for copy-paste in ssh connections)none(shows nothing except small delimiter; useful for small terminals)- If prompt is toggled with
#, the IP address is shown instead of the hostname.
- configurable by universal list
$budspencer_pwdstyle(if not set, defaults toshort long none); note that changes to$budspencer_pwdstylekeep persistant as it's a universal variable.
- styles implemented:
- Style of symbols can be toggled in NORMAL and in VISUAL mode with
#- styles implemented:
symbols(shows status symbols)numbers(shows numbers instead of symbols in left prompt as well as amount of changes in right repo prompt)
- styles implemented:
Note, the format is username@hostname:pathname. Thus, you can cut
the whole string with your mouse and paste it into ssh commands.
The function d drops down a menu showing the history as enumerated list. Unlike
fish's builtin dirh, d does not show any duplicates. Enter a number to jump
to a directory within the list.
The following shortcuts need vi-mode:
- Press
Hin NORMAL mode to change present working directory to previous working directory in history. - Press
Lin NORMAL mode to change present working directory to next working directory in history.
The function c drops down a menu showing the command history as enumerated list similarly to
the d function. Selections are also pasted into the X clipboard. It's possible
to load a command of a former prompt by giving the prompt line number as
argument.
A bookmark can be created with mark. It can be removed with unmark.
unmark can take an argument to remove a specific bookmark in the bookmark list.
Simply add the number of the bookmark you would like to remove as the argument.
Bookmarks are universal and thus persistant.
A new shell automatically changes working directory on startup to newest bookmark.
m is a function that drops down a menu showing the bookmarks as enumerated list
equivalently to d.
The following shortcuts need vi mode:
- Create a bookmark for present working directory with
min NORMAL mode. - Remove a bookmark for present working directory with
Min NORMAL mode.
By default the shell will change to the directory of the latest bookmark on a new session. This can be disabled by adding the following line:
set -U budspencer_no_cd_bookmark
The function edit-commandline let you edit the commandline with your editor.
It makes the commandline as powerful as your editor. If $EDITOR is not set,
vi is used.
The following shortcut needs vi mode:
- Type
.in NORMAL mode to edit commandline in editor.
Shell session can be stored with s <session name>. If a session with session name already exists, the session with this name will be attached. If a session with
session name is already active within another terminal, this terminal will be
focussed.
A list of available sessions can be shown with s.
A session can be erased with s -e <session name>.
Type s -d to detach current session.
Just type wt <title>.
- vi REPLACE mode, as soon as REPLACE mode is implemented within fish
Give me feedback if you ...
- ... have ideas how I could improve budspencer.
- ... have problems with budspencer.
- ... have questions concerning budspencer.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent