haal

haal is a small system fetch tool written in Rust and configured in Lua

the name is the afrikaans word for 'fetch'

installation

from the Binary

Go to the Releases section on the right, click the latest release, and click the binary for your architecture to download it.

with wares

add the following to your config.yaml, replacing x86_64 with arm64 if you're on ARM.

wares:
  haal:
    name: haal
    repo: indium114/haal
    asset: "haal_Linux_x86_64"

with cargo

run the following; ensure that ~/.cargo/bin is in your $PATH

cargo install haal

configuration

the config file is stored at ~/.config/haal/init.lua, and the ascii logo is stored at ~/.config/haal/logo.txt.

to generate a starting config, run just configure from the root of this repo.

the init.lua file should contain two things:

• logo_colour: a string containing a hex code. this sets the colour of the ascii logo
• stats: a table of strings, these are the rows of the fetch output.

for example, here's a basic config that shows a green logo and some info about the operating system:

logo_colour = "#00FF00"

stats = {
  "distro: " .. os.name .. " " .. os.version,
  "hostname: " .. os.hostname,
  "kernel version: " .. os.kernel,
}

all of the available stats are used in the default config, but they will also be below for reference.

user

• user.name: your username

wm

• wm.name: the name of the running window manager

vendor

• vendor.name: the vendor of the computer/motherboard
• vendor.model: the model of the computer/motherboard

uptime

• uptime.uptime: the uptime of the system (already nicely formatted for you)

terminal

• terminal.name: the name of the running terminal

shell

• shell.name: the name of the default shell

os

• os.name: the name of the os (typically your distro's name)
• os.version: the version of the os
• os.hostname: your system's hostname
• os.kernel: the version of the kernel

mem

• mem.total: total amount of memory in your system, in gigabytes
• mem.used: amount of used memory in your system, in gigabytes

gpu

• gpu.name: the name of your graphics card

disk

• disk.total: total size of the root drive, in gigabytes
• disk.used: used space on the root drive, in gigabytes

cpu

• cpu.name: the name (and typically frequency) of your cpu
• cpu.freq: the frequency of your cpu, in gigahertz

colour

these are used for changing the colour of text.

• colour.black("text")

• colour.red("text")

• colour.green("text")

• colour.yellow("text")

• colour.blue("text")

• colour.purple("text")

• colour.cyan("text")

• colour.white("text")

• colour.boldBlack("text")

• colour.boldRed("text")

• colour.boldGreen("text")

• colour.boldYellow("text")

• colour.boldBlue("text")

• colour.boldPurple("text")

• colour.boldCyan("text")

• colour.boldWhite("text")

credits

haal was heavily inspired by fetchit, a really cool, minimal fetch tool written in c