Skip to content
/ hackmac Public

Some ruby tools for working with a Hackintosh, which also might be (partially) useful an a regular Mac.

License

Notifications You must be signed in to change notification settings

flori/hackmac

Repository files navigation

HackMac 🚀

Description 📝

HackMac is a set of Ruby tools specifically designed for managing and customizing Hackintosh configurations. While primarily intended for users with Hackintosh setups, it may also be useful for ordinary Mac users who want to leverage its features for monitoring system performance using gfxmon.

Documentation

Complete API documentation is available at: GitHub.io

Tools 🛠️

efi - EFI Partition Management 📁

Manage OpenCore EFI partitions including:

  • Upgrading OpenCore and kernel extensions (kexts) 🔧
  • Committing changes to git repositories 💾
  • Mounting/unmounting EFI volumes 📌
  • Cloning EFI partitions between devices 🔄

usb - Bootable USB Creator 🖥️

Create bootable USB drives for macOS installation with:

  • Format USB device with GPT partition scheme 📊
  • Create bootable installer using Apple's createinstallmedia
  • Initialize git repository on EFI partition 📦

gfxmon - GPU Performance Monitor 🎮

Display real-time performance statistics for your GPU in the terminal including:

  • Temperature, clock rates, fan rotations 🌡️
  • Memory usage and power consumption ⚡
  • Color-coded visualizations with ANSI terminal graphics 🎨

gfxmon Screenshot

Installation 📦

Using RubyGems 💎

gem install hackmac

Using Bundler 📦

Add to your Gemfile:

gem 'hackmac'

Configuration ⚙️

First run efi without arguments to display available commands and initialize the default configuration file at:

~/.config/hackmac/hackmac.yml

To use a custom configuration file, set the environment variable:

export HACKMAC_CONFIG=~/config/hackmac/other.yml

Usage Examples 🎯

EFI Management 📁

# Mount EFI partition
efi mount

# Clone EFI partitions
efi clone /dev/disk0s1 /dev/disk1s1

# Upgrade OpenCore
efi oc_upgrade

# Show kext versions
efi kexts

GPU Monitoring 🎮

# Real-time monitoring with 2-second updates
gfxmon -n 2

# Monitor specific metric
gfxmon -m "Temperature(C)"

# Output as JSON for scripting
gfxmon -j

USB Creation 🖥️

# Create bootable USB
usb /dev/disk2

Download 🌐

The homepage of this library is located at: https://github.com/flori/hackmac

Author 👨‍💻

Florian Frank

License 📄

This software is licensed under the MIT license. ✅

About

Some ruby tools for working with a Hackintosh, which also might be (partially) useful an a regular Mac.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages