dshb

macOS system monitor

beltex
472
34
Swift

dshb

A macOS system monitor in Swift, inspired by
top &
htop. Displays live readings of system CPU &
memory usage, machine temperature sensors, fan speeds, battery information and
other miscellaneous system statistics. The ncurses based TUI (text-based user
interface) uses color coating to imply status and is fully resizable. Stats are
updated at one second intervals while still maintaining low overhead (the
observer effect
is inescapable in this case sadly).

alt text

Why?

  • Exploration of Swift. In particular, systems programming and interfacing with
    low-level C APIs

Homebrew 🍺

$ brew install dshb

Requirements

Clone

Make sure to use the recursive option on clone to auto init all submodules.

git clone --recursive https://github.com/beltex/dshb

Incase you have already cloned the repository, run the following inside the
project directory.

git submodule update --init

Install

This will build dshb from source and place the binary and manual page in your
path.

make install

Stack

  • ncurses
    • For drawing to the terminal (tested with version 5.4 - default on macOS)
  • SystemKit
    • For almost all statistics
  • SMCKit
    • For temperature & fan statistics
  • CommandLine
    • For the CLI
  • ronn
    • For generating the manual page

All Git submodules are built part of the project as simply source files, not
frameworks (which are essentially dynamic libraries). This is because currently,
the Swift runtime dynamic libraries must be packaged with the application in
question. In the case of dshb, a single binary is generated which has the
runtime statically linked. Thus, frameworks, which expect to find the libraries
inside the application bundle (.app), cannot “see” them.

For more see:

References

License

This project is under the MIT License.

P.S.

Working on this always brought a smile to my face. I hope it brings a smile to
yours too.
Enjoy 😃