Elgato 4K60 Pro MK.2 (1cfa:000e) and Elgato 4K Pro (1cfa:0012) Linux Driver

High-performance, multi-client Linux driver for the Elgato 4K60 Pro MK.2 and Elgato 4K Pro PCI-e capture cards. Engineered for stability on modern kernels (6.12 through 7.0+).

For older kernels, use the original stoth68000/sc0710 repository (MK.2 only).

Supported cards

Both cards share the same 12ab:0710 Magewell chipset but use different board profiles in the driver.

Kernel compatibility

Tested on kernel 6.12 through 7.0+. Newer kernels may work but are not guaranteed until tested.

Installation

Automatic installation (recommended)

Unified installer — auto-detects atomic vs standard distros. Supported on Arch, Debian/Ubuntu, Fedora, and Fedora Atomic (Bazzite, Silverblue, Bluefin, Aurora).

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/Nakildias/sc0710/main/scripts/install-sc0710.sh)"

Standard distros get DKMS (optional) or a manual module build, sc0710-cli, and boot-time module loading via modules-load.d.

Atomic distros get: - Driver source at /var/lib/sc0710/ (persists across rpm-ostree updates) - sc0710-build.service — rebuilds and loads the module on each boot - sc0710-cli with atomic-specific commands (--rebuild, etc.)

4K Pro on any distro additionally gets: - Automatic download/extraction of SC0710.FWI.HEX from the Elgato Windows driver - sc0710-firmware.service — prepares firmware files and symlinks before driver load - sc0710-firmware-verify.service — verifies ECP5 programming after the module loads, with automatic retries

4K Pro ECP5 firmware (cold boot)

The 4K Pro has a Lattice ECP5 FPGA whose configuration is volatile — it is lost on full power-off / cold boot. Windows programs it on every boot; this driver does the same.

Symptoms when ECP5 is not programmed: - HDMI input shows as locked/detected - Video is black - dmesg has no ECP5 FPGA programmed message

After automatic install, boot services handle programming. If video is still black:

sudo sc0710-cli --restart
# or
sudo bash /var/lib/sc0710/sc0710-firmware.sh --verify          # atomic
sudo bash /usr/local/libexec/sc0710-firmware.sh --verify     # standard

Existing atomic installs can pick up the latest firmware stack with:

sudo sc0710-cli --update

Arch Linux (AUR)

yay -S sc0710-dkms-git

The AUR package installs only the DKMS kernel module. It does not include: - sc0710-cli - ECP5 firmware extraction or programming scripts - sc0710-firmware / sc0710-firmware-verify services

MK.2 users on Arch can use the AUR package and load with sudo modprobe sc0710.

4K Pro users on Arch should use the automatic installer instead, or manually place SC0710.FWI.HEX in /lib/firmware/sc0710/ and handle cold-boot programming yourself.

NixOS (flakes)

Add github:Nakildias/sc0710 as a flake input and import sc0710.nixosModules.default:

{
  inputs = {
    # ...
    sc0710.url = "github:Nakildias/sc0710";
  };

  outputs = { self, nixpkgs, sc0710 }: {
    nixosConfigurations.<your-hostname> = nixpkgs.lib.nixosSystem {
      modules = [
        # ...
        sc0710.nixosModules.default
      ];
    };
  };
}

Host configuration:

hardware.sc0710.enable = true;          # kernel module + sc0710-cli
hardware.sc0710.enableFirmware = true;  # basic firmware oneshot service
# hardware.sc0710.kernel = pkgs.linuxPackages_6_19.kernel;  # optional override

Note: The NixOS module builds the driver and installs sc0710-cli, but its firmware service is a single oneshot unit — it does not include the full ECP5 verify/retry stack that the bash installer provides for atomic distros. 4K Pro users on NixOS may need manual intervention after cold boot until the Nix module is brought up to parity.

Manual compilation

For development or unsupported distros.

1. Install dependencies
2. Arch: sudo pacman -S base-devel linux-headers git
3. Debian/Ubuntu: sudo apt install build-essential linux-headers-$(uname -r) git

4. Fedora/RHEL: sudo dnf install kernel-modules-$(uname -r) kernel-devel kernel-headers gcc make git

5. Build and load bash git clone https://github.com/Nakildias/sc0710 cd sc0710 make sudo insmod build/sc0710.ko

6. 4K Pro only — insmod alone is not enough on cold boot. You also need:

7. SC0710.FWI.HEX in /lib/firmware/sc0710/ (extract with scripts/extract-firmware.sh)
8. Reload the module after cold boot so the driver can program the ECP5, or use the automatic installer

Driver management (sc0710-cli)

Installed by the automatic installer and the NixOS module. Provides real-time control on both atomic and standard distros.

After sc0710-cli --remove, verify everything is gone:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Nakildias/sc0710/main/scripts/check-sc0710-removal.sh)"

Verify complete removal

Same command as above — checks module, DKMS, CLI, systemd units, config files, logs, and 4K Pro firmware. No clone or sudo required. Exits 0 when fully clean.

Features

• Multi-client support — multiple apps (e.g. OBS + Discord) can open the device simultaneously
• DKMS integration — automatic rebuilds on kernel updates (standard distros)
• Atomic / immutable support — boot-time rebuild via sc0710-build.service (Bazzite, Silverblue, etc.)
• 4K Pro ECP5 auto-programming — firmware extraction, cold-boot programming, verify service, and CLI retries
• Status images — storage-efficient No Signal / No Device screens
• Connection sensing — distinguishes unplugged cables from signal loss (not 100% reliable)
• Video formats — 4K60, 1440p144, 1080p240 (EDID changes require Windows)
• Mode-switch stability — DMA resync, restart validation, and watchdog recovery during resolution/refresh changes
• Safety scaling — auto-scaler and dynamic-resolution paths reduce crash-prone transitions
• Timing controls — runtime modes (merge, procedural-only, static-only) via CLI
• Debug dumps — sc0710-cli --dump collects distro, kernel, lspci, driver version, and service state for issue reports

Troubleshooting

For GitHub issues, attach output from sc0710-cli --dump.

Known limitations / roadmap

• 4K60 DMA tearing — horizontal tears or frame shifts at 4K60 (~995 MB/s) under heavy load; under active investigation
• HDR tonemapping (on hold) — requires opaque I2C commands to the onboard ARM MCU
• 10-bit pixel format (on hold) — P010/P016 register map unknown
• EDID switching (on hold) — EEPROM write protocol unknown; set EDID in Windows first

Help wanted

Maintainer Nakildias only has an Elgato 4k60 Pro MK.2 available for hands-on testing. That limits how much can be validated on other hardware.

Contributions and testing help are especially welcome for:

• Elgato 4K Pro — ECP5 cold-boot behavior, atomic/Bazzite installs, and general capture stability
• Unsupported cards — other 12ab:0710 subsystem IDs (e.g. HD60 Pro) that are not yet fully supported
• Open issues — bugs that need reproduction on hardware the maintainer does not own (4K60 tearing, edge-case distros, etc.)

If you can test, debug, or submit patches for any of the above, please open an issue or a pull request. Include sc0710-cli --dump output when reporting problems.

Credits

• Based on original reverse engineering by Steven Toth (@stoth68000) and subsequent work by @Subtixx.
• Thanks to Onhil (@Onhil) for work on the Elgato 4K Pro.