Macchina
Fast, minimal and customizable system information frontend. Linux • macOS • Windows • NetBSD • OpenWrt • Android
The second major version of macchina includes a breaking change in macchina's configuration file that could result in an error if you don't update your configuration accordingly.
<2.0macchina.toml:
toml
palette = "<True|False>"
>=2.0macchina.toml:
```toml
palette = "
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:
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 comes equipped with built-in themes that style their readouts, bars
and separators differently. You can see the list with the --list-themes flag
and use the one you like with --theme <name>.
Bars provide a way to visualize data, through symbols rather than numbers, and
they can be enabled using the --bar flag.
libmacchina can sometimes fail to fetch certain readouts, and macchina has
a feature in place that allows you to see why they failed, this is done
through the --doctor flag.
See macchina.toml for an example configuration file.
macchina.toml in $XDG_CONFIG_HOME/macchina/You can also create custom themes in JSON format. Themes allow for more
customization and are separate from the main configuration file. See
Carbon.json
for an example theme.
$XDG_DATA_HOME/macchina/themes/. You can have as many as you
want, just avoid using the names of built-in themes.To start using your theme:
1. Run macchina --list-themes to verify that macchina has listed your theme
2. Inside macchina.toml, add theme = <name_of_theme_without_json_extension>
3. You're good to go! macchina will start using your theme.
These dependencies are not required, but they extend what macchina can show.
cargo install macchina
pkgin install macchina
brew install macchina
pkg install macchina
scoop install macchina
Use the AUR package that pulls and installs the latest release:
bash
git clone https://aur.archlinux.org/macchina.git
cd macchina
makepkg -si
Or use the AUR package that pulls and builds from upstream:
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.
| Platform | Supported | | :-------: | :-------: | | Linux | ✓ | | NetBSD | ✓ | | macOS | ✓ | | Windows | ✓ | | OpenWrt | ✓ | | Android | ✓ |
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!