My Shell Setup

Functionality that I use often enough to dedicate single-letter names to.

• b - "browse" - My script for invoking a browser. Currently, my primary browser is Vivaldi, but I plan to switch to Nyxt in the future.
• c - "clipboard" - My script that wraps xclip on Linux, and pbpaste/pbcopy on macOS.
• d - "delete" - Aliased to trash-put from trash-cli.
• e - "edit" - My emacsclient wrapper script.
• j - "jump" - Aliased to pazi_cd from pazi.
• l - "ls" - Aliased to lsd.
• m - "music" - My script that wraps mpc (MPD control).
• o - "open" - Aliased to pso, a simpler/easier xdg-open alternative.
• p - "play" - My script that wraps mpv.
• u - "upload" - My script that uploads the files specified as arguments to a public directory on my webserver and copies the resulting URL to the clipboard.
• v - "view" - My script that wraps nsxiv. In the future I may switch to using mpv as an image viewer instead as it is more customizable.
• y - "yay" - Named after an AUR helper I used to use, however it is now aliased to paru instead.

Some others I use a lot:

• ll - Aliased to ls -lh.
• lst - Aliased to ls --sort=time.
• mkcd - Aliased to mkdir -p $argv[1]; cd $argv[1].
• pc - Aliased to p $(c).
• id3 - Aliased to eyeD3, a Python script to view/edit audio file id3 tags.
• ytdl - Aliased to yt-dlp, which is basically youtube-dl except that it is still being maintained and developed.
• ytdlc - Aliased to ytdl $(c), which downloads the media from the URL saved in the clipboard.
• snds - My script which prints a list of programs that are using audio devices.
• lanhosts - Aliased to sudo nmap -sn '192.168.0.*', to get a list of hosts on the local network.
• taptempo - Aliased to my Python script that tells you the tempo that you're tapping a key at.
• clock - Aliased to ncmpcpp -s clock, to show a large clock.
• weather - Aliased to curl wttr.in, to display the weather forecast.

Various options and environment variables that are not specific to Fish or tmux.

If you're not familiar with Fish, note that set -x is basically the same as export in Bash/Zsh/etc.

• set -x BLOCKSIZE human-readable - So du, df, etc print human-readable units by default.
• set -x QUOTING_STYLE literal - Prevent ls from pointlessly printing quotes around filenames with spaces.
• set -x EDITOR e - Set the default editor to my emacsclient wrapper.
• set -x ALTERNATE_EDITOR zile - If Emacs is not running, fall back to zile, a simple and fast Emacs-like editor.
• set -x VISUAL $EDITOR, set -x SUDO_EDITOR $EDITOR, set -x SYSTEMD_EDITOR $EDITOR - No, seriously, just use the editor I set $EDITOR to.
• set -x DIFFPROG ediff - Use Emacs' ediff for viewing/editing diffs.
• set -x MERGEPROG ediff - Also use ediff for merging diffs.
• set -x BROWSER b - Use my browser wrapper script to open URLs.
• set -x GREP_COLORS "mt=01;33" - Make grep print the matching text in color if its output is not being piped to another program.
• set -x WLC_REPEAT_DELAY 190 - Wayland configuration. I don't have the time to wait for keyboard repeat to kick in!!!!!!!
• set -x WLC_REPEAT_RATE 50 - Wayland configuration. Make the keyboard repeat rate much faster.
• set -x WINEDLLOVERRIDES winemenubuilder.exe=d - Prevent Wine from annoyingly associating its programs with file extensions. Why it does that by default for so many standard file types is beyond me!
• fish_add_path ~/misc/stow/scripts - Add my scripts to $PATH.

• Colorize ls output:

  if test -e ~/.dircolors; and command -qs dircolors
      eval (dircolors -c ~/.dircolors)
  end
  

• Colorize various standard commands with grc:

  if test -f /etc/grc.fish
      source /etc/grc.fish
  end
  

Fish-specific configuration.

• bind \eC fish_clipboard_copy - Alt+C to copy the current command line to the clipboard. By default, this is bound to Ctrl+x in Fish, but I prefer to use Ctrl+x as my tmux prefix key.

• Bind Page Up and Alt+v to scroll up one page with tmux. Beware that this can prevent those keys from being usable in terminal programs if you haven't worked around that in your configuration. I have, though. :-)

  if contains "$TERM" 'screen' 'screen-256color'; and status is-interactive
      bind -k ppage 'tmux copy-mode -u' # page up
      bind \ev 'tmux copy-mode -u' # alt+v
  end
  

• fish_greeting - The text Fish displays on launch. I have this set to call scripts that warn me if the free space of any partitions are low, or if I haven't run a backup in a long time.

• fish_prompt - The prompt. Unlike some shells, Fish is sane enough to use a function for this instead of forcing you to shove everything into a cryptic variable. My prompt is pretty simple, and typically looks like user@host:directory$ (exit_code_if_nonzero) - for example, modula@obsclera:~/misc/images (127) if the last program exited with status 127. It is also set up so that each host's prompt has a different color, to make it easier for me to see which host I'm about to run a command on.

  function host_bgcolor -d "The background color of the prompt for the current hostname."
      # This line generates a color from the md5 of the hostname, but I have also overridden it for a few hosts.
      echo $hostname | md5sum | string sub -l 6
  end
  
  function host_fgcolor -d "The text color of the prompt for the current hostname."
      # Again, I've overridden this for a few hosts.
      # Ideally, this would auto-generate a color that contrasts with the prompt background.
      echo white
  end
  
  function fish_prompt -d "The prompt."
      set -l last_ret $status
      set -l bgcolor (host_bgcolor $hostname)
      set -l fgcolor (host_fgcolor $hostname)
      if test $last_ret -ne 0
          set_color red
          echo -n '('$last_ret') '
      end
      set_color $fgcolor -b $bgcolor
      echo -n $USER
      set_color normal -b $bgcolor
      echo -n '@'
      set_color $fgcolor -b $bgcolor
      echo -n $hostname
      set_color normal
      echo -n ':'
      set_color green
      echo -n (prompt_pwd)
      if fish_is_root_user
          set_color red
          echo -n '# '
      else
          set_color blue
          echo -n '$ '
      end
      set_color normal
  end
  

• Fisher
  • done
  • fish_tmsu
  • trish

tmux-specific configuration.