applefetch

A macOS CLI system information tool inspired by neofetch.

Note

fastfetch is a far superior alternative. This app is more of a personal learning project.

Motivation

I wanted to create a neofetch clone for macOS that uses native C++ code and, where possible, system calls instead of relying on the shell.

It looks like this:

OS: macOS 14.6.1 (arm64)
Model: MacBookPro18,3
Uptime: 17d 23h 52m
Packages: 138 (brew)
Shell: /bin/zsh
Display: 1512x982 @ 120 Hz
CPU: Apple M1 Pro
Memory: 10.16GiB / 16.00GiB (63%)

Tested Systems

This project has been tested on the following system:

• macOS 14.6 (Sonoma)

Automated tests are also run on the latest version of macOS using GitHub Actions.

Pre-built Binaries

Pre-built binaries are available for macOS (ARM64). You can download the latest version from the Releases page.

To remove the quarantine attribute on macOS, use the following commands:

xattr -d com.apple.quarantine applefetch-macos-arm64
chmod +x applefetch-macos-arm64

Requirements

To build and run this project, you'll need:

• C++17 or higher
• CMake

Build

1. Clone the repository:

   git clone https://github.com/ryouze/applefetch.git

2. Generate the build system:

   cd applefetch
   mkdir build && cd build
   cmake ..

   Optionally, you can disable compiler warnings by setting ENABLE_COMPILE_FLAGS to OFF:

   cmake .. -DENABLE_COMPILE_FLAGS=OFF

3. Compile the project:

   cmake --build . --parallel

After a successful build, you can run the program using ./applefetch. However, installing the program is recommended so that it can be run from any directory. See the Install section below.

Tip

The build type is set to Release by default. To build in Debug mode, use cmake .. -DCMAKE_BUILD_TYPE=Debug.

Install

If you haven't already built the project, follow the steps in the Build section and make sure you are in the build directory.

To install the program, use the following command:

sudo cmake --install .

This installs the program to /usr/local/bin. You can then run it from any directory using applefetch.

Usage

To run the program, use the following command:

applefetch

On startup, the program displays system information similar to the following:

OS: macOS 14.6.1 (arm64)
Model: MacBookPro18,3
Uptime: 17d 23h 52m
Packages: 138 (brew)
Shell: /bin/zsh
Display: 1512x982 @ 120 Hz
CPU: Apple M1 Pro
Memory: 10.16GiB / 16.00GiB (63%)

If the NO_COLOR environment variable is set, the program does not use color codes in its output:

NO_COLOR=1 applefetch

Flags

[~] $ applefetch --help
Usage: applefetch [-h] [-v]

CLI system information tool for macOS, inspired by neofetch.

Optional arguments:
  -h, --help     prints help message and exits
  -v, --version  prints version and exits

Testing

Tests are included in the project but are not built by default.

To enable and build the tests manually, run the following commands from the build directory:

cmake .. -DBUILD_TESTS=ON
cmake --build . --parallel
ctest --output-on-failure

Credits

• fmt