macchina lets you view system information, like your kernel version, uptime, memory usage, processor load and much more.
If you're interested in the library macchina uses to fetch system information, have a look at libmacchina; fetching-related issues should be filed on that repository.
macchina is lightning fast, see for yourself:
Execution time is measured using hyperfine
This benchmark was performed using an Intel® Core™ i5-3350P CPU @ 3.10GHz
| Command | Mean [ms] | Min [ms] | Max [ms] |
| :--------- | --------: | -------: | -------: |
| macchina
| 4.8 ± 0.4 | 4.5 | 8.1 |
| Command | Mean [ms] | Min [ms] | Max [ms] |
| :--------- | --------: | -------: | -------: |
| macchina
| 5.0 ± 0.2 | 4.7 | 5.9 |
This benchmark was performed inside a virtual machine using an Intel® Core™ i5-8265U CPU @ 1.60GHz
| Command | Mean [ms] | Min [ms] | Max [ms] |
| :--------- | ---------: | -------: | -------: |
| macchina
| 17.7 ± 1.6 | 16.8 | 27.2 |
| Command | Mean [ms] | Min [ms] | Max [ms] |
| :--------- | --------: | -------: | -------: |
| macchina
| 9.0 ± 0.4 | 8.2 | 11.7 |
macchina has a theming system which you can use to customize pretty much any visual aspect of the program. Themes live outside the configuration file, so you can create a bunch of them and switch between them at any time.
Learn how to make your own — there is documentation in case something is not quite so clear.
libmacchina can sometimes fail to fetch certain readouts, and macchina has
a feature in place that describes why they failed. You don't have to guess
what went wrong, --doctor
has your back!
The configuration file defines the behavior of macchina, it does not allow for much customization. See macchina.toml for an example configuration file.
In order for macchina to be able to read the configuration file, you need to
place macchina.toml
in:
$XDG_CONFIG_HOME/macchina
on Linux and the BSDs.$HOME/Library/Application Support/macchina
on macOS.{FOLDERID_RoamingAppData}/macchina
on Windows.Themes define the look, layout and styling of macchina. See Hydrogen.toml for an example theme.
In order for macchina to be able to find your themes, you need to place them in:
$XDG_CONFIG_HOME/macchina/themes
on Linux and the BSDs.$HOME/Library/Application Support/macchina/themes
on macOS.{FOLDERID_RoamingAppData}/macchina/themes
on Windows.To start using your theme:
macchina --list-themes
to verify that macchina has listed your theme.theme
option in
macchina.toml
The following are required dependencies if you're building from source or installing through cargo
:
The following are optional dependencies, they only extend what macchina can fetch:
Linux:
NetBSD:
cargo install macchina
pkgin install macchina
zypper in macchina
brew install macchina
pkg install macchina
scoop install macchina
bash
git clone https://aur.archlinux.org/macchina.git
cd macchina
makepkg -si
bash
git clone https://aur.archlinux.org/macchina-git.git
cd macchina
makepkg -si
<channel>
is nixpkgs
or nixos
:bash
nix-env -iA <channel>.macchina
The installation wiki page lists some other ways you can install the program or the steps to compile from source.
You might prefer running the prebuilt binary that corresponds with your operating system.
macchina, like many other open-source projects, would not be where it is right now without the help of its contributors, thank you all so much!
Some of the ASCII art displayed in macchina is not our own.
If you (the artist) are not okay with us using your ASCII art, please contact me.