Zigfetch

• Description
• Requirements
• Installation
• Usage
  • Configuration
• Roadtrip
• Contributing

Description

Zigfetch is a minimal neofetch/fastfetch like system information tool

Requirements

• >= zig v0.15.2

Linux only

• libpci

Installation

Build from source

# Clone the repo
$ git clone https://github.com/utox39/zigfetch.git

# cd to the path
$ cd path/to/zigfetch

# Build zigfetch
$ zig build -Doptimize=ReleaseSafe

# Then move it somewhere in your $PATH. Here is an example:
$ mv ./zig-out/zigfetch ~/bin/

Via Homebrew

$ brew install utox39/tap/zigfetch

Other package managers

• nixpkg: Thanks to @heisfer

Usage

$ zigfetch

Configuration

IMPORTANT Currently, Zig does not have a built-in library for JSON validation via JSON schema, so it is very important to follow the pattern shown in the default configuration file (config.json) to avoid errors

• Create the config folder

$ mkdir -p ~/.config/zigfetch

• Create the config file

$ cd ~/.config/zigfetch
$ touch config.json

• Or copy the default config (preferred way)

$ cp /path/to/zigfetch/config.json ~/.config/zigfetch/config.json

Modules

Available modules:

• Os
• Kernel
• Uptime
• Packages
• Shell
• Cpu
• Gpu
• Ram
• Swap
• Disk
• Net
• WM (Window Manager)
• Terminal
• Locale
• Custom

  "modules": [
    {
      "type": "os",
      "key": "OS",
      "key_color": "#5E81AC"
    },
    ...
  ]

Custom module

  "modules": [
    {
      "type": "custom",
      "key": "-----------",
      "key_color": "#5E81AC"
    },
    ...
  ]

Custom ASCII art

To use an ASCII art of your choice:

"ascii_abs_path": "absolute_path/to/your/ascii_art.txt"

Don't use the ~ character.

Username and Hostname color

To change the Username and Hostname color (HEX colors only):

"username_hostname_color": "#5E81AC"

Roadtrip

• Add ASCII art for each operating system and Linux distro
• Add GPU info for Linux
• Add packages info for Linux
• Add user customization
• Add support for Windows

Contributing

Please see CONTIBUTING. Thanks!