fish configuration files

Features

• Install fish and link fish configuration files (directories conf.d and functions)

• Install fisher and selected plugins (see fish_plugins)

• Install selected Nerd Fonts

• Replace ls with lsd

System requirements

Different distributions and releases ship with different fish versions.

The biggest source of problems is the compatibility between fish and tide (see Fish version compatibility)

To guarantee compatibility with the least possible maintenance effort, the latest fish version required, and the fisher plugins have been fixed to the specific versions known to work with the current fish version.

Therefore, only the following combinations are supported:

Platform/version	fish version	Package source
Debian 11	3.6.0	openSUSE Build Service
Debian 12	3.6.0	Official Debian repository
Fedora 37	3.6.0	Official Fedora repository
Ubuntu 22.04	3.6.0	fish PPA
macOS 10.15 Catalina	3.6.0	MacPorts

Installation

1. Install the following prerrequisites:

   • bash

   • Git

     If you’re not running the script as root, you’ll also need one of these: sudo doas or OpenDoas ** pleaser

2. Clone the repository:

   • Using HTTPS:

     git clone --recurse-submodules https://github.com/jonancm/dotfiles_fish.git

   • Using SSH:

     git clone --recurse-submodules git@github.com:jonancm/dotfiles_fish.git

3. Run the installation script:

   bash install.sh

Testing

Prerrequisites

• Podman or Docker

Note	When using Podman with SELinux (e.g. on Fedora), you must add :z when you mount a volume. The commands in the following section reflect this.

Starting the container

Platform/version	Podman	Docker
Debian 11	podman run -it -v $PWD:/ws:z -w /ws --rm debian:11	docker run -it -v $PWD:/ws -w /ws --rm debian:11
Debian 12	podman run -it -v $PWD:/ws:z -w /ws --rm debian:12	docker run -it -v $PWD:/ws -w /ws --rm debian:12
Fedora 37	podman run -it -v $PWD:/ws:z -w /ws --rm fedora:37	docker run -it -v $PWD:/ws -w /ws --rm fedora:37
Ubuntu 22.04	podman run -it -v $PWD:/ws:z -w /ws --rm ubuntu:22.04	docker run -it -v $PWD:/ws -w /ws --rm ubuntu:22.04
macOS 10.15 Catalina	no image available	no image available