Skip to content

Latest commit

 

History

History
125 lines (84 loc) · 4.51 KB

README.md

File metadata and controls

125 lines (84 loc) · 4.51 KB

macchina

Fast, minimal and customizable system information frontend.

Linux • macOS • Windows • NetBSD • FreeBSD • OpenWrt • Android

Matrix Version Downloads CI Preview

About

macchina lets you view system information, like your kernel version, uptime, memory usage, processor load and much more. macchina is basic by default and extensible by design.

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.

Benchmarks

Check out the benchmarks wiki page.

Features

Themes

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.

Why are they separate?

  • Modularity — themes are an engine of their own, and their sole purpose is to provide an interface that allows for the modification of macchina's visual components. It makes sense to separate them from the main configuration file.

  • Portability — sure, the configuration file is shareable, but what if you wanted to share the look of your macchina and not its behavior? What if you wanted to switch between dozens of themes that you very carefully designed? The way we handle customization answers this need.

Learn how to make your own.

Doctor

In the event of fetching failures, which can occur for various reasons, the --doctor flag that can tell you why that might be happening.

Configuration

See the configuration wiki page.

Customization

Have a look at the customization wiki page.

Installation

Packaging status

Check out the installation wiki page.

Prebuilt binaries are also provided with every release, feel free to use them.

Contributors

Crates.io

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!

The following are some awesome people that have helped make macchina a really cool fetcher:

  • Support for NetBSD would not have been possible without the help and testing of NetBSD/pkgsrc package maintainer pin
  • Support for macOS and Windows would not have been possible without the help, testing and major contributions of 123marvin123
  • Support for OpenWrt and Android was made possible through the many contributions of uttarayan21

Looking to help? Read this first.

ASCII Art

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.

  • FreeBSD ASCII art (small variant) was taken from Dylan Araps' pfetch
  • macOS ASCII art (big variant) was taken from Dylan Araps' Neofetch
  • macOS ASCII art (small variant) was made by Joan Stark (jgs)
  • Linux ASCII art (big variant) was made by Joan Stark (jgs)
  • Linux ASCII art (small variant) was taken from Christopher Johnson's ASCII art collection (unknown artist)