A Linux-only hardware inventory tool that produces JSON reports and ACPI dumps for use with OpCore Simplify and similar OpenCore-focused workflows. Derived from Hardware Sniffer by Hoang Hong Quan; this repository is maintained independently for machines running Linux.
About •
Upstream •
Features •
How To Use •
Credits •
Maintainer •
License
For a longer explanation of the Hackintosh / OpCore context and how this fork relates to the original project, see docs/background-and-lineage.md.
Table of Contents
People who install macOS on non-Apple hardware (“Hackintosh”) often use OpCore Simplify to turn a structured hardware report into an OpenCore-oriented configuration. The original Hardware Sniffer project was built around Windows (WMI) for that report.
This repository keeps the same goal—export Report.json and ACPI tables in a shape suitable for OpCore-oriented tooling—but implements collection only on Linux (sysfs, lspci, lsusb, etc.). That lets you generate a report from a Linux install or live environment without booting Windows. OpCore-oriented path sanitization (for example ACPI/PCI formats) is preserved where applicable in the Linux pipeline.
| Project | Description |
|---|---|
| OpCore Simplify | Automates OpenCore configuration from hardware data. |
| Hardware Sniffer (upstream) | Original hardware reporter (Windows-focused); this fork’s lineage. |
- OpCore-oriented output: Writes
Report.jsonunder your chosen output directory and can dump ACPI tables (.aml) for workflows that expect those artifacts. - Comprehensive hardware collection (Linux): Motherboard, CPU, GPU, monitors, network, audio, USB controllers, input, storage controllers, biometrics, Bluetooth, SD controllers, and system devices—via sysfs and related interfaces;
lspciandlsusbwhere needed (e.g.pciutils,usbutilson Fedora:sudo dnf install pciutils usbutils). - Detection helpers: Chipset hints from PCI data, CPU codename from family/model/stepping heuristics, GPU codename from PCI IDs, input connection types (e.g. i2c, USB).
- Python 3, plus
lspciandlsusb. On Fedora:
sudo dnf install python3 python3-pip pciutils usbutils - Python deps: from the repo root,
pip install -r requirements.txt(seerequirements-linux.txt).
- Non-interactive (hardware collection →
Report.json→ ACPI copy; may prompt forsudo):
python3 Hardware-Sniffer-CLI.py -e -o SysReport - Interactive menu:
python3 HardwareSniffer.py
ACPI tables are copied from /sys/firmware/acpi/tables into <output>/ACPI/ using sudo where required.
Scripts/— Runtime Python modules and datasets.requirements.txt— Includesrequirements-linux.txt.
- Original Hardware Sniffer & ecosystem: Hoang Hong Quan — Hardware-Sniffer, OpCore-Simplify.
- Bundled / adapted data & code: PCI ID Repository, USB ID Repository, subprocess helper pattern via CorpNewt (
run.py), and other attributions inherited from upstream.
This Linux-focused fork is maintained separately; see Maintainer.
Contributions (issues, pull requests) are welcome in this repository for the Linux fork.
Owner / maintainer (this repository): Jameel Ahmad (jnzlab)
- GitHub: https://github.com/jnzlab
- LinkedIn: https://www.linkedin.com/in/jnzlab/
For questions about this fork (Linux reporting, issues, contributions), use this repository’s GitHub issues and the contacts above. For the original Hardware Sniffer or OpCore Simplify upstream behavior, refer to the upstream repositories.
Distributed under the BSD 3-Clause License — see LICENSE. This project derives from upstream Hardware Sniffer; respect upstream and third-party licenses when redistributing.
Installing macOS on non-Apple hardware may conflict with Apple’s software license. This tool only helps collect hardware information on Linux; you are responsible for how you use that data and for complying with applicable laws and licenses.