- Arch Linux
- Debian
- Fedora
- Endeavour OS
- Void Linux
- Ubuntu
- *Suse
- Raspbian
- Linux Mint
- MX Linux
- Gentoo
- Funtoo
- Slackware
- NixOS
- Kali Linux
- CachyOS
- FreeBSD
- NetBSD
- xbps
- dnf
- rpm
- apt
- pacman
- emerge
- yum
- zypper
- apk
- pkg
libxrandr
glibc
- Any nerd font
For NVIDIA cards:
nvidia-smi
(sometimes packaged withnvidia-utils
)
Only on linux:
lm-sensors
(sometimes packaged aslm_sensors
)pciutils
cargo install rsftch
git clone https://github.com/charklie/rsftch.git
cd rsftch
cargo install --path .
If you're on NetBSD or, any supported pkgsrc platform, a pre-compiled binary is available from the official repositories.
To install it, simply run:
pkgin install rsftch
Or, if you prefer to build it from source:
cd /usr/pkgsrc/sysutils/rsftch
make install
There is an .deb file available in the releases section, for Arch and Debian / Ubuntu users.
If you don't have cargo installed you can download the binary and move it directly to your /usr/bin
, although this is very unsafe and should be rarely ever done.
cargo install rsftch --force
Use pkgin upgrade
.
Go to releases and replace the latest with the outdated one.
The configuration is located at ~/.config/rsftch/info.json
, and it could look something like this;
{
"color": ["red", "green", "blue", "purple"],
"info": [
["os", "host", "shell", "packs", "user"],
["term", "de", "cpu", "gpu", "mem"],
["uptime", "res", "time", "disk"]
]
}
Each list within "info" is a section, and inside "color" is the first string the color of the ascii, and the other the colors for each section, make sure that the amount of colors are one more than how many lists there are, else the config will be considered invalid. All the info options are as follows:
- os / distro
- host / hostname
- shell
- kernel
- packs / packages
- user / username
- term / terminal
- de / dewm / wm
- cpu / processor
- gpu / graphics
- mem / memory
- uptime
- res / display / resolution
- time / timezone
- disk / diskusage
One which is not supported is parsed as empty, a.k.a. just blank.
Available colors:
- green
- red
- purple / magenta
- yellow
- blue
- cyan
- black
- white
A color which is not supported is parsed as white.
Capitalization does not matter.
- Temperature readouts sometimes wrong
- Icons misaligned in some terminals, some examples include
ansi
and text mode - Technically wrong syntax in the JSON configuration file, but if serde's fine with it, I am
If you've found a solution of these, please submit a PR.
Solution: (If you installed with cargo) Add ~/.cargo/bin/ to PATH, how varies from shell to shell, here are some popular ones:
Bash / Zsh:
echo "PATH=\$PATH:~/.cargo/bin/" >> (.bashrc / .zshrc path)
Fish:
set -U fish_user_paths ~/.cargo/bin/ $fish_user_paths
Nushell:
let-env PATH = ($env.PATH | prepend $"($env.HOME)/.cargo/bin")
Elvish:
set paths = [~/.cargo/bin/ $@paths]
If none of these work, or you are unsure how to do this in your shell, consider moving the binary to /usr/bin, example command:
sudo mv ~/.cargo/bin/rsftch /usr/bin
Solution: If you were a user prior to the rework, there's a chance your config might be invalid, either try an example or read the guide under "Configuration". Otherwise, if the examples don't work and you've reinstalled rsftch with the latest update, submit an issue with the "urgent" label.
File an issue.
Usage: rsftch [-h / --help / --usage] [-v / --version] [-o / --override <distro name> / empty] [-m / --margin <margin>] [--ignore-config] [--config <absolute path to config>]
-h, --help, --usage Bring up this menu.
-v, --version Print version number.
-o, --override Overrides distribution, affects ASCII and "distro" info. Running without an argument prints all possible options.
-m, --margin Add margin to the info sections, default 1. E.g. `rsftch --info distro` would output: "EndeavourOS".
--config Specify another info config file to be used.
--ignore-config Ignores configuration and uses the example one.
Configuration file is located at: ~/.config/rsftch/info.json
- Rsftch: 45.12 milliseconds (all infos enabled)
- Neofetch: 137.43 milliseconds
- Screenfetch: 767.8 milliseconds
NOTE: Timing varies heavily depending on e.g. what package manager your distro uses or how many infos are enabled in the configuration. These times are from my system. (endeavour + pacman + all infos enabled)
Currently, Rsftch only works on most GNU/Linux and BSD distributions, at the moment only NetBSD is confirmed to work fully.
All PRs are always welcome, just remember to make sure it works on both NetBSD and Linux, additional Windows and MacOS support is appreciated as that will be coming!
Thank you to:
- @siris for helping me with optimizing functions and packaging rsftch for Funtoo Linux.
- @0323pin for packaging rsftch on pkgsrc and uploading it to beucismis/awesome-fetch.
- @MasterRoby3 for fixing
apt
support in packages function.
- Add support for more info sections
- PKL configuration (?)
- Automatic ASCII generation (this will be delayed until a good figlet implementation is available)
- Option to have ASCII on side (?)
- Rewrite & clean up
packs
function - MacOS support
- Windows support
- FreeBSD support