A theme for the 70s, 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
- taskwarrior (optional)
- remind (optional)
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
- 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
- Git 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
- Last command's duration time
- Git 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_pwdstyle
keep 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 git 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
H
in NORMAL mode to change present working directory to previous working directory in history. - Press
L
in 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
.
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
m
in NORMAL mode. - Remove a bookmark for present working directory with
M
in NORMAL mode.
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.