fishfetch

A lightweight system information tool written entirely in Fish shell

You know how neofetch is cool but sometimes feels a bit heavy? Well, this is basically that, but for Fish shell lovers. No Python, no external dependencies (except Fish itself, obviously), just pure shell scripting goodness.

What's this?

fishfetch is a simple fetch tool that shows your system info with some nice ASCII art. It's fast, minimal, and works out of the box on most Linux distros.

Features

• Pure Fish shell - No dependencies beyond Fish itself
• Fast startup - It's just a shell script, so it's basically instant
• Multiple distro logos - Arch, Fedora, Ubuntu, Debian, and a generic Tux
• Auto-detection - Figures out your distro automatically
• Colorful output - Because plain text is boring
• Terminal-aware - Adapts to your terminal width

What it shows

• Your username and hostname
• OS/distro name
• Kernel version
• System uptime
• Current shell
• CPU model
• RAM usage
• Disk usage

Installation

The easy way

git clone https://github.com/elliottophellia/fishfetch.git
cd fishfetch
sudo make install

The manual way

Just copy fishfetch to somewhere in your $PATH:

cp fishfetch ~/.local/bin/
chmod +x ~/.local/bin/fishfetch

Or if you're feeling fancy:

sudo cp fishfetch /usr/bin/
sudo chmod 755 /usr/bin/fishfetch

Usage

Just run it:

fishfetch

Want to use a different logo?

fishfetch --ascii arch      # Force Arch logo
fishfetch --ascii fedora    # Force Fedora logo
fishfetch --ascii ubuntu    # Force Ubuntu logo
fishfetch --ascii debian    # Force Debian logo

Available options:

-h, --help          Show help message
-v, --version       Show version
-a, --ascii DISTRO  Use specific distro logo

Add it to your shell startup

Want to see it every time you open a terminal? Add this to your ~/.config/fish/config.fish:

fishfetch

Or if you want to be less intrusive, only show it on new terminal windows:

if status is-interactive
    fishfetch
end

Supported distros

The script auto-detects these distros and shows their respective logos:

• Arch Linux (& EndeavourOS)
• Fedora (& Nobara)
• Ubuntu (& Pop!_OS, Linux Mint)
• Debian (& Raspbian)
• Generic Linux (fallback for everything else)

Why Fish shell?

Because Fish is awesome? Honestly, I just wanted to write something in pure Fish to see how far I could push it. Turns out, pretty far. Plus, Fish's syntax is actually quite pleasant to work with once you get used to it.

Performance

It's a shell script that reads a few files from /proc and /etc. It's about as fast as you'd expect - basically instant on any modern system.

Uninstall

If you used make install:

cd fishfetch
sudo make uninstall

Or just remove it manually:

sudo rm /usr/bin/fishfetch

Contributing

Found a bug? Want to add support for your favorite distro's logo? PRs are welcome! This is a pretty simple script, so it should be easy to hack on.

Just keep in mind:

• Keep it pure Fish (no external tools unless absolutely necessary)
• Keep it simple (this isn't meant to be neofetch 2.0)
• Test on your distro before submitting

License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). For more information, please refer to the LICENSE file included in this repository.

FAQ

Q: Why not just use abcdfetch?
A: You totally can! This is just a lightweight alternative if you want something simpler or if you're a Fish shell enthusiast.

Q: Does this work on macOS/BSD/Windows?
A: Probably not. It's pretty Linux-specific since it reads from /proc and /etc/os-release. Feel free to add support though!

Q: Can I customize the colors/info shown?
A: Right now, no. But the script is pretty straightforward if you want to edit it yourself. Maybe I'll add a config file someday.

Q: Why is it called fishfetch?
A: Because it's written in Fish shell and it fetches system info. I'm great at naming things, I know.