FaceTime HD Installer for Ubuntu 24.04

This repository contains a single Bash installer for the patjak/facetimehd camera driver stack, tailored for late-2013 15-inch Retina MacBook Pro systems (MacBookPro11,2 and MacBookPro11,3) running Ubuntu Desktop 24.04.x.

It is a wrapper around the upstream projects, with Ubuntu-focused defaults and a cleaner install flow:

• installs build dependencies and DKMS tooling
• extracts and installs firmware.bin
• extracts and installs the optional sensor calibration .dat files by default
• installs the kernel module through DKMS
• blacklists bdc_pci
• installs a lightweight systemd suspend/resume hook by default
• runs basic post-install validation

What This Script Is

The main entry point is install_facetimehd_ubuntu.sh.

The script is designed to be:

• opinionated toward Ubuntu 24.04
• safe to rerun
• explicit about Secure Boot risks
• able to uninstall what it installed

It is not the upstream driver itself. At runtime it pulls from:

• patjak/facetimehd
• patjak/facetimehd-firmware
• Apple Boot Camp package files for calibration extraction

Default Behavior

Running the installer with no flags will:

1. verify the OS, kernel, model, and PCI camera presence
2. install required Ubuntu packages
3. clone the upstream repos into a temporary working directory
4. install firmware and calibration files
5. build and install the driver through DKMS
6. install the bdc_pci blacklist and suspend hook
7. load the module and run validation checks

Defaults worth knowing:

• driver ref: 0.6.13
• firmware ref: master
• calibration: enabled
• suspend hook: enabled
• validation: enabled
• persistent modules-load config: disabled unless requested

Usage

Install with defaults:

sudo ./install_facetimehd_ubuntu.sh

Show help:

./install_facetimehd_ubuntu.sh --help

Install without calibration:

sudo ./install_facetimehd_ubuntu.sh --skip-calibration

Keep the working directory for inspection:

sudo ./install_facetimehd_ubuntu.sh --keep-workdir

Uninstall the DKMS module and related config:

sudo ./install_facetimehd_ubuntu.sh --uninstall

Also remove installed firmware and calibration files during uninstall:

sudo ./install_facetimehd_ubuntu.sh --uninstall --remove-firmware

Important Notes

• Run the script as root via sudo.
• The primary supported target is Ubuntu 24.04.x.
• The primary supported hardware target is late-2013 A1398 machines detected as MacBookPro11,2 or MacBookPro11,3.
• --force-unsupported exists, but it bypasses the main safety checks.
• If Secure Boot is enabled, the DKMS build may succeed while the module still fails to load until the key enrollment side is handled.
• Logs are written to /var/log/facetimehd-installer-YYYYMMDD-HHMMSS.log.

CLI Options

The script includes a built-in --help screen. The most useful flags are:

• --skip-calibration
• --skip-suspend-hook
• --skip-validation
• --modules-load
• --driver-ref REF
• --firmware-ref REF
• --workdir DIR
• --keep-workdir
• --force-unsupported
• --yes
• --uninstall
• --remove-firmware

Project Scope

This repository is intentionally small. It is a packaging and automation layer for a single installation script, not a fork of the driver source tree.