ratfetch

KO | EN

gitlite — search

#bash #llm #generative-ai #postgresql #video #hacktoberfest #computer-vision #markdown #machine-learning #csharp

(★ 16)

A system fetch that does not stop at one frame :D

File Explorer

ZIP Download

- - ci.yml
  - pages.yml
  - release.yml
- - index.toml
  - LICENSE
- config.template.toml
- index.html
- - color.rs
  - enums.rs
  - keys.rs
  - mod.rs
  - model.rs
  - theme.rs
- - mod.rs
- - battery.rs
  - cpu.rs
  - desktop.rs
  - disk.rs
  - gpu.rs
  - host.rs
  - mem.rs
  - mod.rs
  - net.rs
  - os.rs
  - packages.rs
  - procs.rs
  - temp.rs
  - time.rs
- - chrome.rs
  - graphs.rs
  - header.rs
  - meters.rs
  - mod.rs
  - tables.rs
- app.rs
- cli.rs
- lib.rs
- main.rs
- util.rs
.gitattributes
.gitignore
build.rs
Cargo.lock
Cargo.toml
install.sh
LICENSE
README.md
rustfmt.toml

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

# Project Badges

ci Visit

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A system fetch that does not stop at one frame.

`fastfetch` prints your machine once and exits. `ratfetch` keeps the logo and
the info table, then puts them at the top of a live TUI: meters, graphs, a
process table, filesystems and interfaces, all refreshing while you watch.

## What it does

- **Live, not a snapshot.** Everything re-reads on a configurable interval.
- **526 logos**, the full set vendored from fastfetch, with their original
  colour palettes. Auto-detected from `/etc/os-release`, or pick your own.
- **Four tabs** — overview, processes, filesystems, interfaces.
- **13 built-in themes**, plus per-role colour overrides. The default is
  `mono`, so the interface borrows your terminal's colours and the logo is the
  only thing on screen with a palette of its own.
- **A config system that tells you when you get it wrong**, with the file, the
  line, and a "did you mean" for every closed vocabulary in the schema.
- **No `sysinfo` crate.** `/proc` and `/sys` are read directly, so the numbers
  come from where the kernel actually puts them.

Linux only — the collectors are built on `/proc` and `/sys`.

## Install

```sh
curl -fsSL https://tuna4ll.github.io/ratfetch/install.sh | sh
```

That picks the right prebuilt binary for your architecture and libc, verifies
its checksum against the release's `SHA256SUMS`, and installs it to
`~/.local/bin` (or `/usr/local/bin` when run as root). `RATFETCH_VERSION`,
`RATFETCH_INSTALL_DIR` and `RATFETCH_NO_MODIFY_PATH` override the defaults.
The script is [`install.sh`](install.sh) in this repo — read it before piping
it to a shell, as you should with any installer.

Prebuilt for `x86_64` and `aarch64`, gnu and musl.

### Manual setup

Any other architecture, or if you would rather build it yourself. Needs Rust
1.88 or newer.

```sh
cargo install --git https://github.com/tuna4ll/ratfetch
```

From a checkout, which is also how you build it to hack on:

```sh
git clone https://github.com/tuna4ll/ratfetch
cd ratfetch
cargo install --path .
```

Both put the binary in `~/.cargo/bin`. To keep it out of the cargo tree
entirely, build and place it yourself:

```sh
cargo build --release
install -m 755 target/release/ratfetch ~/.local/bin/
```

## Use

```sh
ratfetch                      # the live TUI
ratfetch --once               # one frame, like a classic fetch tool
                              # (graphs are dropped: one sample is not a series)
ratfetch --logo nixos         # override the detected logo
ratfetch --theme gruvbox-dark
ratfetch --interval 250       # four samples a second
ratfetch --list-logos | fzf   # browse what is bundled
```

### Keys

| key | action |
|-----|--------|
| `q` `esc` `ctrl+c` | quit |
| `?` `f1` | help |
| `tab` `shift+tab` | change tab |
| `j` `k` / arrows | scroll |
| `s` | cycle the process sort column |
| `c` | per-core CPU meters |
| `space` | freeze / resume |
| `r` | reload the config |

All of them are rebindable.

## Configuration

```sh
ratfetch --generate-config     # writes a fully commented ~/.config/ratfetch/config.toml
ratfetch --check-config        # validates without starting the UI
ratfetch --print-config        # the effective config, after merging
```

Files are merged in order, and each one may be partial:

```
/etc/ratfetch/config.toml  →  ~/.config/ratfetch/config.toml  →  --set key=value
```

`--config PATH` replaces the first two. `--no-config` skips them all.

The config is watched while running, so saving the file re-applies it. If the
new version does not parse, ratfetch says so in the footer and keeps running on
the old one.

### A taste of it

```toml
[general]
interval_ms = 500

[logo]
source = "arch"
color_mode = "rainbow"

[theme]
name = "tokyonight"

[theme.colors]
accent = "#7aa2f7"

[layout]
panels = ["meters", "graphs", "processes"]

[info]
items = ["title", "separator", "os", "kernel", "uptime", "cpu", "memory", "colors"]

[meters]
style = "blocks"
per_core = true

[keys]
quit = ["q"]
freeze = ["p"]
```

Anything you leave out keeps its default. Anything you misspell is an error
with a location:

```
$ ratfetch --check-config
ratfetch: in /home/tuna4l/.config/ratfetch/config.toml:
TOML parse error at line 12, column 1
   |
12 | inteval_ms = 500
   | ^^^^^^^^^^
unknown field `inteval_ms`, expected one of `interval_ms`, `history`, ...
```

```
$ ratfetch --set info.items='["kernal"]' --check-config
ratfetch: config is not valid: unknown InfoItem `kernal` (did you mean `kernel`?)
```

Every option is documented inline in the generated config; that file is the
reference.

## Layout

The overview is a header plus a stack of panels:

- `layout.panels` — `meters`, `graphs`, `processes`, `disks`, `network`, `colors`
- `layout.panel_heights` — a fixed height each, or `0` to share what is left
  (`meters` sizes itself to its bars)
- `logo.position` — `left`, `right`, `top`, `none`

Below `layout.narrow_width` columns the logo moves above the info table on its
own, so ratfetch stays readable in a split pane.

## Credits

The ASCII art is vendored from [fastfetch](https://github.com/fastfetch-cli/fastfetch)
under the MIT License — see `assets/ascii/LICENSE`. The TUI is built with
[ratatui](https://ratatui.rs), which the name is a nod to.

## License

ratfetch

Owner Repos

File Explorer

# Use via CDN

# Project Badges

Was this content helpful?

Recent Feedback

ratfetch

Owner Repos

File Explorer

# Use via CDN

# Project Badges

Was this content helpful?

Recent Feedback

Download README