Skip to content
77nyanPublic

About

A fast, lightweight system info tool written in Rust. Fastfetch-style output with all Fastfetch logos, configured with a simple, beginner-friendly Lua file.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

NyFetch

A fast system info tool for Linux, written in Rust and configured in Lua.
Fastfetch's look and logos, with a config file anyone can edit.

Release License: MIT Made with Rust Platform: Linux

⚡ ~3 ms per run  ·  🪶 ~3 MB of RAM  ·  🎨 540+ logos  ·  🧩 Lua config

1.0 Install  ·  2.0 Usage  ·  3.0 Configure  ·  4.0 Roadmap  ·  5.0 Credits


1.0 Install

sudo pacman -S --needed git
git clone https://github.com/77nyan/nyfetch.git
cd nyfetch
sudo ./install.sh

Important

Start the installer with sudo ./install.sh only. Running it with sh install.sh is refused on purpose.

Pick an option with ↑ ↓ (or 1–4) and Enter:

Option What it does
1 Install Builds NyFetch, installs it to /usr/local/bin and creates your config.
2 Update Pulls the newest version from GitHub, rebuilds, keeps your config.
3 Uninstall Removes NyFetch. Asks before touching your config.
4 Quit Closes the installer.

Then run nyfetch in any terminal.

Dependencies and other distributions
Package Used for
rust builds NyFetch (the installer installs it on Arch)
gcc compiles the bundled Lua interpreter (the installer installs it on Arch)
git downloads the source and updates it

Nothing is needed to run NyFetch, the binary is fully static. On other distributions install Rust (rustup.rs) and gcc or clang yourself, then use the same four commands. To build by hand: cargo build --release.

If the installer says "permission denied", run chmod +x install.sh once.

↑ back to top

2.0 Usage

Command Does
nyfetch show your system
nyfetch --small use the small logo
nyfetch -l arch use another logo (random, none or a text file work too)
nyfetch --list-logos list all logos
nyfetch --gen-config print the default config
nyfetch -c file.lua use another config file
nyfetch --bench time every line

↑ back to top

3.0 Configure

Edit ~/.config/nyfetch/config.lua. It has simple settings and a list of lines at the top, and a step-by-step tutorial at the bottom, written for people who have never coded.

local logo = "arch"          -- pick a logo
local small_logo = true      -- smaller logo

local lines = {
  "title",
  "os",
  "kernel",
  -- "uptime",                                -- hidden: put -- in front
  { type = "memory", key = "RAM" },           -- renamed
  { type = "text", text = "Hello {user}!" },  -- your own text
  "colors",
}
All available lines

title separator os host kernel uptime packages shell display de wm theme icons font cursor terminal terminalfont cpu gpu memory swap disk localip battery locale board bios processes break colors

Your own: text, custom and command. Every line accepts key, format, keyColor, valueColor, hide and when. The config is real Lua, so lines can also be functions.

↑ back to top

4.0 Roadmap

Still missing compared with Fastfetch: media player, sound, Wi-Fi, Bluetooth, brightness, gamepad, public IP, weather, GPU APIs, CPU usage, image logos and Fastfetch's JSON config. NyFetch was mostly developed and tested in a Linux VM, so some desktop-specific lines may differ on your hardware. Bug reports are welcome in Issues.

↑ back to top

5.0 Credits

NyFetch is MIT licensed. The logos and the layout idea come from Fastfetch (MIT, see LICENSE-FASTFETCH). Distribution logos are trademarks of their respective owners.

↑ back to top

About

A fast, lightweight system info tool written in Rust. Fastfetch-style output with all Fastfetch logos, configured with a simple, beginner-friendly Lua file.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages