---
name: "macchina"
section: "1"
platform: "linux"
package: "macchina"
version: "6.4.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/macchina"
---

# macchina(1)

A system information frontend, with an (unhealthy) emphasis on performance.

## NAME

macchina - A system information frontend, with an (unhealthy) emphasis on performance.

## SYNOPSIS

**macchina** \[FLAGS\]

## FLAGS

**-d, --doctor**

Checks the system for failures.

**-e, --export-config**

Prints a template configuration file to stdout.

**-c, --config**=*FILE*

Specify a custom path to a configuration file.

This is helpful in cases where macchina fails to parse the configuration file from the default path, i.e. **$XDG\_CONFIG\_HOME/macchina/macchina.toml**.

**-l, --list-themes**

Lists all available themes.

Themes are **TOML** files which must be placed in **$XDG\_CONFIG\_HOME/macchina/themes**.  Whatever this flag returns to the console can be used with the **--theme** flag.

**-t, --theme**=*THEME*

Specify the name of the theme to use, i.e. its basename and without the ".toml" extension.

You should verify whether macchina was able to find your theme with **--list-themes**.

**-i, --interface**=*IF\_NAME*

Specify the network interface for the LocalIP readout, e.g. "wlan0", "eth0".

**-s, --current-shell**

Toggles between the current shell, i.e. the parent of the terminal emulator, or the default one.

**-C, --logical-cores**

Toggles between logical and physical cores for the Processor readout.

**-K, --long-kernel**

Lengthens kernel output.

**-S, --long-shell**

Lengthens shell output.

**-U, --long-uptime**

Lengthens uptime output.

**-m, --memory-percentage**

Show memory usage in percentage

**-D, --disks**

Specify the disks for which the usage percentage will be shown

**-p, --disk-space-percentage**

Show disk space usage in percentage

**-h, --help**

Prints help information.

**-v, --version**

Prints version information.

**-o, --show**

Display only the specified readouts.

Please note that the order these are listed in will be the order that they are displayed in.

Possible values are (case-sensitive):

- •

  Host

- •

  Machine

- •

  Kernel

- •

  Distribution

- •

  OperatingSystem

- •

  DesktopEnvironment

- •

  WindowManager

- •

  Packages

- •

  Shell

- •

  Terminal

- •

  LocalIP

- •

  Backlight

- •

  Resolution

- •

  Uptime

- •

  Processor

- •

  ProcessorLoad

- •

  Memory

- •

  Battery

- •

  GPU

- •

  DiskSpace

**--ascii-artists**

Lists the original artists of the ASCII art used by macchina.

## SEE ALSO

[macchina(7)](/macchina/7.md)

## AUTHORS

Written and maintained by the Macchina-CLI team:

- •

  Taha Aziz Ben Ali \<ba.tahaaziz@gmail.com\>

- •

  Uttarayan Mondal \<email@uttarayan.me\>

- •

  Marvin Haschker \<marvin@haschker.me\>

## RESOURCES

This project is hosted at **https://github.com/Macchina-CLI/macchina**.