MACCHINA(1)

📦 version 6.4.0, in arch rolling, nixos 26.05, nixpkgs unstable

💖 MACCHINA(1) — the manual page, but make it a group chat 💖

okay so. bestie. welcome to the macchina manual page (that's the General Commands Manual one, section 1, main character energy only ✨). this is a system information frontend with an (unhealthy) emphasis on performance. yes, "unhealthy" is their word, not mine, and honestly? iconic. 🫶

✨ NAME ✨

macchina — a system information frontend, with an (unhealthy) emphasis on performance. that's it. that's the whole vibe. 💅

🎀 SYNOPSIS 🎀

macchina [FLAGS]

literally just the command plus flags. no cap, that's the whole syntax. 🦋

🌸 FLAGS 🌸

here's the part you actually came for. every single one, no skipping, i promise. 💖

  • -d, --doctor — runs a lil checkup on your system to see if anything's failing. like a wellness check but for your machine. 🩺
  • -e, --export-config — prints a template configuration file straight to stdout. starter pack for your config, basically. ✨
  • -c, --config=FILE — points at a custom path for your configuration file.

this one's a lifesaver when macchina just refuses to parse the config file from the default path, i.e. $XDG_CONFIG_HOME/macchina/macchina.toml. lowkey the default path is where it's supposed to live, so if it's not working, this is your moment. 🙈

  • -l, --list-themes — lists every available theme.

themes are TOML files, and they must be placed in $XDG_CONFIG_HOME/macchina/themes. whatever this flag prints to the console can be used with the --theme flag. so like, list first, then flex. 🎀

  • -t, --theme=THEME — picks the name of the theme to use, i.e. its basename and without the ".toml" extension.

pro tip from the original text: you should verify whether macchina was actually able to find your theme with --list-themes. don't just assume it ate. 👑

  • -i, --interface=IF_NAME — specifies the network interface for the LocalIP readout, e.g. "wlan0", "eth0". tell it which network girlie to look at, iykyk. 🌈
  • -s, --current-shell — toggles between the current shell (i.e. the parent of the terminal emulator) or the default one. flip it, see what happens. 🐚
  • -C, --logical-cores — toggles between logical and physical cores for the Processor readout. cores but make it a philosophical debate. 💀
  • -K, --long-kernel — lengthens kernel output. more words. more info. slay. 🔥
  • -S, --long-shell — lengthens shell output. same energy, different readout. 💜
  • -U, --long-uptime — lengthens uptime output. your uptime gets the extended cut. ⭐
  • -m, --memory-percentage — show memory usage in percentage. numbers but in percent form. 🍓
  • -D, --disks — specify the disks for which the usage percentage will be shown. pick your faves. 💾
  • -p, --disk-space-percentage — show disk space usage in percentage. ✨
  • -h, --help — prints help information. the classic. the icon. 🫶
  • -v, --version — prints version information. 🏷️
  • -o, --show — displays only the specified readouts.
⚠️ heads up bestie: the order you list these in will be the order that they are displayed in. order matters, fr fr.

possible values are (case-sensitive, so don't get cute with the capitalization):

  • 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. give credit where credit is due, periodt. 🎨

🦋 SEE ALSO 🦋

  • macchina(7) — yes, there's a section 7 too. go read it, bestie. 💖

👑 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. go star it, it's literally free. ⭐

aaaand that's the page!! 🧚 this version is from 2024-09-29 (the MACCHINA(1) date stamp, so you know it's fresh-ish), and that's your cute lil sign-off — go check your system info, bestie, you're gonna eat 💅💖

📦 where this page comes from