Macchina

Table of Contents:

• About
• Changelog
• Benchmarks
• Features
• Installation
• Platform Support

About Macchina

Macchina lets you view basic system information, like your hostname, your kernel version, memory usage, and much more. No one wants a slow fetcher, and macchina's main goal is to provide you with handy features while keeping performance a priority.

Changelog

• You can visualize memory usage and battery percentage using progress bars

Benchmarks

Macchina is pretty fast, see for yourself:

• Execution time is measured using hyperfine

| Command | Mean [ms] | Min [ms] | Max [ms] | Relative | |:---|---:|---:|---:|---:| | macchina | 22.2 ± 0.7 | 21.0 | 25.1 | 1.00 | | neofetch | 243.9 ± 2.3 | 240.0 | 246.9 | 11.01 ± 0.37 |

Summary: macchina runs 11.01 ± 0.37 times faster than neofetch

• Note that hiding elements using Macchina's --hide argument significantly improves speed

Features

Macchina displays basic system information such as: - Hostname - Operating system - Kernel version - Package count (Arch-based distributions only, will print 0 on any other distribution) - Shell path/name in which macchina was ran - Terminal instance name in which macchina was ran - Processor model name, frequency and thread count - Uptime - Memory usage - Battery percentage and status - Palette (if user runs Macchina with --palette / -p)

Macchina supports the following arguments: - --no-color -> disable colors - --color <color> -> specify the key color - --separator-color <color> -> specify the separator color - --random-color -> let macchina choose a random color for you - --palette -> display palette - --short-sh -> shorten shell output (/bin/zsh => zsh) - --hide <element> -> hide elements such as host, os, kern, etc. - --bar -> display memory usage and battery percentage as progress bars - --theme <theme_name> -> change themes - --help -> display help menu - --version -> print version - --padding <amount> -> specify the amount of padding to use

Installation

Macchina is not yet ready to be deployed on crates.io, but you can compile it from source and play around with it.

Here's how you can do that:

1. Clone the repo: git clone https://github.com/grtcdr/macchina
2. Navigate to the folder and compile from source: cd macchina && cargo build
3. target/ has been generated by cargo and Macchina's binary file can now be run: ./target/debug/macchina

Bonus: To run macchina from anywhere on your system, you have two options:

1. Place macchina/target/debug/macchina somewhere in your $PATH, like ~/.local/bin or /usr/bin.

:heavyexclamationmark: Any changes you make to the source code will apply to the macchina binary file but you'll need to place the newly built binary file on your $PATH again to run it from anywhere on your system with your new changes.

1. Create a new symlink for Macchina:

:heavyexclamationmark: This symlink will point to the binary file, so everytime you modify the source code and rebuild, running $ macchina from anywhere on your system will run the newly built binary file.

Will Macchina Work on Your Macchina?

| Platform | Support | | :-: | :-: | | Linux | :heavycheckmark: | | BSD | :question: | | MacOS | | | Windows | |

Cells containing :question: have not yet been tested.