Home

Awesome

<div align="center"> <h1>Rsftch</h1> Fast • Easy to configure • Aesthetically pleasing

Thank you for 30k downloads on crates.io!

</div>

Screenshots

image image

Update

I've sadly decided to stop working on rsftch, and switching my attention to my other system information fetch written in V (vitty). Of course, any pull requests will be accepted and issues fixed, but I myself won't be adding any new features.

ASCII supported distributions

Unsupported distros won't have a custom title, instead "Rsftch"

Supported package managers

Dependencies

For NVIDIA cards:

For Linux:

Installation

Cargo (recommended)

cargo install rsftch

Source

git clone https://github.com/charklie/rsftch.git --depth=1
cd rsftch
cargo install --path .

NetBSD

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

DEB file

There is an .deb file available in the releases section, for Arch and Debian / Ubuntu users.

Binary

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.

To update

Cargo

cargo install rsftch --force

NetBSD

Use pkgin upgrade.

Others

Go to releases and replace the latest with the outdated one.

Configuration

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:

One which is not supported is parsed as empty, a.k.a. just blank.

Available colors:

A color which is not supported is parsed as white.

Capitalization does not matter.

Known issues

On WSL

If you've found a solution of these, please submit a PR.

Common issues

Running rsftch in terminal doesn't work (command not found)

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: fish_add_path ~/.cargo/bin/

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

JSON Configuration error

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.

Other issues

File an issue.

Usage

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

Time comparison

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)

Compatability

Currently, Rsftch only works on most GNU/Linux and BSD distributions, at the moment only NetBSD is confirmed to work fully.

Contributions

All PRs are always welcome, just remember to make sure it works on both NetBSD and Linux.

Special Thanks

Thank you to: