NikonFirmwarePatch

English · 简体中文

Build a local Nikon Z8 firmware update with the features you select:

• ProRes quality: HQ / Standard / LT / Proxy, with separate settings for shooting menu banks A/B/C/D.
• C15/C30 HE / HE★ RAW capture: select RAW / RAW+JPEG / JPEG in the ordinary Image quality menu. Both historical and current frames follow it, with full-size NEF previews and direct playback. No card configuration file is needed; QUAL/f2, the shooting display and the i-menu quality tile follow the ordinary quality selection. Dual-card routing uses the role and primary slot recorded when each frame is submitted.
• Both features in one build.

Experimental firmware — install at your own risk. A successful build or test does not guarantee safe operation. Installation or use may cause lost images, corrupted cards, camera malfunction or permanent camera damage. You must assess and accept these risks before installing. To the extent permitted by applicable law, the repository, its authors and contributors provide no warranty and accept no liability for data loss, camera damage or other losses caused by building, installing or using the output. Do not use it for irreplaceable work. See LICENSE and NOTICE.md.

The publicly supported input is official Nikon Z8 C 3.11. Download it yourself from Nikon, subject to Nikon's terms. The source repository contains code, compatibility fingerprints and the existing menu screenshots. Releases also provide the reviewed precompiled patch, with its corresponding source. No original or modified complete firmware, or RAW photos, are distributed. Output firmware is generated locally. The tool does not copy files to a card or operate a camera.

Download and extract NikonFirmwarePatch-v0.2.0-toolkit.zip from the Release. Use the toolkit asset, which includes resources/precapture.bin; GitHub's automatically generated source archives and a Git clone contain source only. The toolkit release number is unrelated to the output firmware version you choose.

Requires Python 3.10+ and the pinned Python dependency. The default prebuilt mode does not need Clang. It checks the bundled machine code against the published size and SHA-256 before applying it. Missing or incorrect code stops the build; there is no automatic download, compilation fallback or force option. ProRes patches continue to be generated in Python and checked against their unchanged recipe.

Run the commands below from the extracted toolkit directory. On Windows, create the environment with py -3 -m venv .venv and activate it in PowerShell with .\.venv\Scripts\Activate.ps1, then use the same python commands. The macOS/Linux activation commands are shown below. Full firmware integration tests for this release ran on macOS; Windows/Linux complete builds have not yet been independently exercised.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

# Read-only compatibility check for the selected features
python patch.py "/path/to/Z_8_0311.bin" --features prores precapture --check

# Choose one of these builds; each output directory must be new
python patch.py "/path/to/Z_8_0311.bin" --features prores --version 04.04 --output build/prores
python patch.py "/path/to/Z_8_0311.bin" --features precapture --version 04.04 --output build/precapture
python patch.py "/path/to/Z_8_0311.bin" --features prores precapture --version 04.04 --output build/combined

# Or select the features interactively
python patch.py "/path/to/Z_8_0311.bin" --interactive --version 04.04 --output build/chosen

# Independent verification of the combined build
python verify.py "/path/to/Z_8_0311.bin" "build/combined/Z_8_0404.bin" --features prores precapture --version 04.04 --tag p0

Developers can explicitly compile from the corresponding source, including from a source-only checkout:

python patch.py "/path/to/Z_8_0311.bin" --features prores precapture --version 04.04 --code-source source --compiler clang --output build/from-source

The reviewed compiler is Apple clang 21.0.0 (clang-2100.1.1.101) with the AArch64 target. Another toolchain is accepted only if the compiled bytes and entry addresses match the reviewed recipe. --compiler requires --code-source source; it does not silently switch the default mode. Source and prebuilt modes use the same patch bytes and independent verifier. See release contents and verification.

Without --features or --interactive, the legacy ProRes-only behavior is retained. --version accepts NN.NN; the example is not a required version. Choose a number higher than both the input and the firmware installed on your camera. The tool checks only the input version, not the camera. --tag is an optional lowercase letter and digit, default p0. A changed version number does not add compatibility or guarantee that the camera will accept an update. Downgrade/recovery is not guaranteed.

The output directory contains the update package, manifest.json and SHA256SUMS.txt. v0.2.0 uses camera settings directly and neither generates nor reads Z8PRE.CFG. Old CFG files are ignored; removing one no longer disables RAW capture. The old configuration generator and configuration switches are removed. Diagnostic footers remain off in the public build. Build upgrades from a fresh official package, not an earlier patched output. Inputs and existing output directories are never overwritten.

Read the full preparation, shooting and limitations guide before installing. In particular:

• Avoid shooting with nearly full cards. Remaining-shot counts and card-space reservation still use the stock HSFC JPEG file plan, which does not budget for the added NEFs. Space sufficient for a JPEG may be insufficient for its NEF, risking failed writes, missing files or incomplete files. This case has not been validated or fixed. Keep ample free space on every destination card; do not rely on the displayed remaining count as a RAW-capacity guarantee.
• Use photo mode, FX / full-size L, C15 or C30. Choose RAW, RAW+JPEG or one of six JPEG qualities in MENU → Photo shooting menu → Image quality settings → Image quality, or through QUAL/f2 or the i menu. Choose High efficiency or High efficiency★ in RAW recording. Lossless RAW is not added by this patch.
• Both pre-release history and full-press/post-release frames follow that choice, including with pre-release capture off. History remains up to one second / 30 frames; this is not a 30-frame limit on the full burst.
• RAW and RAW+JPEG NEFs embed 8256×5504 previews. JPEG fine/normal/basic, with or without ★, are effective. The shooting-screen and i-menu quality indicators now follow the ordinary menu in C15/C30. The immediate playback RAW label can still omit L until a restart, although files record Large.
• Dual-card behavior includes backup and RAW-primary/JPEG-secondary routing. The role and primary slot are fixed for each submitted frame, including while queued writes finish. See the routing table and exclusions before use.
• Wait for writing to catch up and finish before changing cards. The “!” indicator can coincide with unavailable history; this is not unlimited sustained RAW capture. C60/C120 RAW, DX and HLG/HEIF remain outside the added function. Remaining-shot and r/buffer indicators still use the stock HSFC estimates.

The ProRes feature retains four quality choices, matching MOV identifiers and playback labels, quality-dependent recording-time estimates, and per-bank persistence. Its original patch bytes are unchanged. The shooting-screen icon does not identify the selected quality. Menu reset and bank-settings import/export remain unverified; bitrate varies with scene content.

These screenshots show the firmware UI in an emulator, not a camera recording test.

Four options	Selected LT value

The package has five modules and is 99,051,117 bytes. Both the builder and independent verifier require the exact official C 3.11 input SHA-256, then check its container and dependency fingerprints. Modified and previously patched inputs are rejected. Output verification checks selected patch bytes, the approved shared loader, version instructions and strings, module identity, recalculated integrity fields, and every byte outside the allowed edits. The builder passes the requested features, version and tag explicitly to the verifier.

A fixed whole-output hash applies only to a fixed input, feature selection, version and tag. Custom outputs are checked against the published per-feature recipes and identity rules. Their locally generated hashes identify the files for later readback; a locally generated hash alone is not proof of a correct build. When running verify.py separately, supply --features, --version and --tag to check your intended options. Omitting them checks detected features and consistent identity and reports that distinction.

The public combined 04.04.p0 package has now completed a camera session: 81 exposures produced 102 NEFs (62 HE★, 40 HE), 62 JPEGs and two ProRes clips. Every NEF decoded completely; all 21 dual-card NEF pairs have identical RAW strips and decoded pixels, and all NEFs end at the RAW strip with no diagnostic footer. HQ and Proxy clips passed all-frame structure/matrix checks and complete video/audio decoding. See the public camera-file results.

This release is based on the previously hardware-tested HN8 implementation. Its latest camera session recorded 108 C15/C30 frames, producing 158 HE★ NEF files across two cards, plus one ordinary single-shot NEF. All 159 NEFs passed complete Adobe decoding. The tests covered backup, RAW/JPEG split, and changes to card roles or the primary slot while earlier frames were still being written. I checked the quality display on the camera, supported by screen photos.

The public build uses public identifiers and omits HN8’s diagnostic footer. The validation record distinguishes the tested HN8 package, the public-port equivalence checks, actual public machine-code execution, generated-file decoding and QEMU checks. It also records the timer ROI limitation and subsequent visual confirmation. The new public camera-file results above are separate from that HN8 session; they do not cover nearly full cards or prolonged stress. Previous evidence and the issue #3 follow-up remain available.

python tests/validate.py --stock "/path/to/Z_8_0311.bin" --report build/prores-tests.json
python tests/validate_features.py --stock "/path/to/Z_8_0311.bin" --report build/feature-tests.json
# Developer equivalence tests also need the reviewed compiler
python tests/validate_distribution.py --stock "/path/to/Z_8_0311.bin" --compiler clang --report build/distribution-tests.json
python tools/check_repository.py --staged

Tests use local temporary directories, without a camera. Enable the repository hook with git config core.hooksPath .githooks.

A future Log3G10 firmware option may be explored. It is not implemented, offered or promised by this release.

Original tool code is GPL-3.0-only; Nikon firmware is not relicensed. Attribution and licensing scope are in NOTICE.md. This project is not affiliated with Nikon.

Thanks to @aoyukkk (傲宇) and 琴岛唯一指定哥布林 for helping with development, conducting camera tests, and reporting issues.

Thanks to RdWing/z8-qemu for its Z8 emulation work, WonderLantern/z9-qemu for the upstream camera model and tools, WonderLantern/z7-qemu for emulator and protocol references, and QEMU for the emulation infrastructure. These projects helped the offline development and validation work; their code and binaries are not distributed here. See NOTICE.md.

从用户自行提供的 Nikon Z8 固件构建所选功能：

• ProRes 画质选择：HQ／Standard／LT／Proxy，A/B/C/D 拍摄菜单库分别保存档位。
• C15／C30 HE／HE★ RAW 连拍与预拍：普通“画质”菜单控制 RAW／RAW+JPEG／JPEG，预拍历史帧及全按后正式帧都生效，NEF 带全尺寸预览并支持直接回放。不再需要卡上配置文件；QUAL／f2、取景画质标识与 i 菜单画质格均跟随普通画质。双卡按提交帧时的副卡槽功能和主卡槽设置写入。
• 可同时选择两项功能，构建一个更新包。

这是测试版固件，上机风险由使用者自行衡量和承担。 构建、校验或既有测试通过不保证安全。安装或使用可能导致照片丢失、存储卡损坏、相机故障乃至永久损坏。在适用法律允许的范围内，本仓库及其作者、贡献者不作任何担保，不对构建、安装或使用本项目产物造成的数据损失、相机损失或其他损失承担责任。请勿用于不可重拍的重要工作。详见 LICENSE 和 NOTICE.md。

公开支持范围仅为官方 Nikon Z8 C 3.11 固件。请自行从 Nikon 下载中心获取并遵守其条款。代码库提供源码、兼容性指纹及原有菜单截图；Release 另提供已审阅的预编译补丁及对应源码，不提供原厂或修改后的完整固件，也不提供原始照片。 完整固件在用户本地生成；脚本不会自动写卡或操作相机。

从 Release 页面下载并解压 NikonFirmwarePatch-v0.2.0-toolkit.zip。请选这个完整工具包：其中含 resources/precapture.bin；GitHub 自动生成的 Source code 压缩包和 Git 克隆只有源码。工具包版本与用户选择的固件版本号无关。

需要 Python 3.10+ 和固定的 Python 依赖。默认使用预编译机器码，不需要 Clang。 应用前核对机器码大小及公开 SHA-256；缺失或不符立即停止，不自动下载、不回退编译，也没有强制跳过选项。ProRes 仍由 Python 生成修改字节并匹配原有配方。

在解压后的工具包目录运行以下命令。Windows 可用 py -3 -m venv .venv 创建环境，在 PowerShell 中用 .\.venv\Scripts\Activate.ps1 激活，然后运行相同的 python 命令。下方展示 macOS／Linux 的激活方式。本次完整固件集成测试运行于 macOS；尚未独立实测 Windows／Linux 上的完整构建。

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

# 对所选功能只读检查
python patch.py "/path/to/Z_8_0311.bin" --features prores precapture --check

# 三选一；输出目录必须尚不存在
python patch.py "/path/to/Z_8_0311.bin" --features prores --version 04.04 --output build/prores
python patch.py "/path/to/Z_8_0311.bin" --features precapture --version 04.04 --output build/precapture
python patch.py "/path/to/Z_8_0311.bin" --features prores precapture --version 04.04 --output build/combined

# 或使用交互选择
python patch.py "/path/to/Z_8_0311.bin" --interactive --version 04.04 --output build/chosen

# 独立核验组合包
python verify.py "/path/to/Z_8_0311.bin" "build/combined/Z_8_0404.bin" --features prores precapture --version 04.04 --tag p0

开发者可显式选择源码编译，只有源码的克隆也可以这样使用：

python patch.py "/path/to/Z_8_0311.bin" --features prores precapture --version 04.04 --code-source source --compiler clang --output build/from-source

当前审阅的编译器是支持 AArch64 的 Apple clang 21.0.0 (clang-2100.1.1.101)。其他工具链只有生成完全相同的补丁字节和入口地址才会被接受。--compiler 必须配合 --code-source source，不会暗中切换默认模式。两条路径使用相同补丁和独立验证器，详见发布包与验证说明。

未指定 --features 或 --interactive 时，保留原先只添加 ProRes 的行为。--version 接受 NN.NN；示例不是规定版本。输出号必须高于输入号，安装时还须高于机身当前版本。脚本只能检查输入包，不读取机身版本。--tag 为一个小写字母加一位数字，默认 p0。改变版本号不代表支持其他固件布局，也不保证相机受理更新；不保证可以降级或恢复。

输出目录包含更新包、manifest.json 和 SHA256SUMS.txt。v0.2.0 直接使用机内设置，不再生成或读取 Z8PRE.CFG。 旧 CFG 文件会被忽略，删除它也不再能停用 RAW 拍摄；旧配置生成器及相关参数已移除。公开构建仍默认不附加诊断尾标。升级时从全新的官方包构建，不叠加到旧修改包；脚本不覆盖输入或已有输出目录。

安装前请完整阅读准备流程、拍摄步骤和限制。主要注意事项：

• 不要在卡接近写满时继续拍摄。 剩余张数和空间预留仍按原厂 HSFC 的 JPEG 文件计划估算，没有为新增 NEF 完整计入空间。能放下 JPEG 的余量可能不足以写完 NEF，存在写入失败、文件缺失或不完整的风险；本版尚未验证或修复这一情况。每张目标卡都应留足空间，不要把屏幕剩余张数当作 RAW 容量保证。
• 照片模式、FX／全尺寸 L、C15 或 C30。通过 MENU → 照片拍摄菜单 → 画质设置 → 画质、QUAL／f2 或 i 菜单选择 RAW、RAW+JPEG 或 JPEG 六档；“RAW 记录”选择高效率或高效率★。本补丁没有新增无损 RAW 支持。
• 预拍历史帧、全按当帧和后续正式帧都采用该选择，关闭预拍也生效。历史窗口仍最长一秒／30 张，不代表整次拍摄最多 30 张。
• RAW 与 RAW+JPEG 的 NEF 均内嵌 8256×5504 预览；JPEG fine／normal／basic 及各自 ★ 均生效。C15／C30 的取景与 i 菜单画质显示现已跟随普通画质。刚拍完回放时 RAW 标签缺 L 的问题仍在，文件已记录 Large，重启后显示恢复。
• 支持双卡备份及 RAW 主卡／JPEG 副卡等路由。每帧按提交时的副卡槽功能和主卡槽设置完成写入，积压期间改设置不改变已提交帧；使用前请看双卡规则与限制。
• 等写卡追上后再继续，并等写入结束再换卡。“!”可能伴随历史缓存不可用，不保证无限持续 RAW 拍摄。C60／C120 RAW、DX、HLG／HEIF 不在新增功能范围；剩余张数与 r／缓冲提示仍沿用原厂 HSFC 估算。

保留四档画质、对应 MOV 编码标识与回放档名、按档位估算录制时间，以及菜单库分别保存设置。原有 ProRes 补丁字节保持不变。拍摄画面的图标不显示具体画质；重设视频菜单、设置文件导入／导出仍未验证；实际码率随场景变化。上方两张图是模拟器界面，不代表相机录制测试。

支持的更新包为五模块、99,051,117 字节。构建器与独立验证器都强制要求官方 C 3.11 的整包 SHA-256，再检查封装、依赖和修改位置指纹；修改过的输入或旧补丁产物会被拒绝。输出检查覆盖所选补丁字节、允许的共享装载修改、版本指令与字符串、模块名、重算的校验字段，以及修改范围之外的每个字节。构建器明确传入用户指定的功能、版本和 tag，独立核对输出是否符合选择。

固定整包哈希只适用于输入、功能组合、版本和 tag 全部固定的构建。自定义产物通过公开功能配方及版本规则核验；本地产生的哈希用于后续读回确认，不能单凭“生成了哈希”证明构建正确。单独运行 verify.py 时，传入 --features、--version、--tag 可核对预期选项；省略时检查实际检测出的功能和版本一致性，报告会区分两者。

**公开组合包 04.04.p0 已完成本轮实拍文件检查：**81 个拍摄帧产生 102 个 NEF（62 个 HE★、40 个 HE）、62 个 JPEG 和两段 ProRes 录像。NEF 全部完整解码，21 对双卡 NEF 的 RAW 条带与像素一致，全部 NEF 在 RAW 条带结束处结尾，没有诊断尾标。HQ／Proxy 两段录像通过逐帧结构与量化矩阵核查，并完整解码视频及音频。详见公开版实拍文件结果。

本版以此前已上机的 HN8 为基础。HN8 那轮实机测试的 108 帧 C15／C30 拍摄在两张卡上生成 158 个 HE★ NEF 文件，另有普通单拍 1 个 NEF；159 个 NEF 全部完整 Adobe 解码通过。覆盖双卡备份、RAW／JPEG 分卡，以及积压写入期间改变副卡槽功能或主卡槽。我在相机上目视确认了画质显示，并有拍屏佐证。

公开版使用独立标识，默认关闭 HN8 的诊断尾标。验证记录分别说明 HN8 上机包、公开迁移的等价性、实际公开机器码执行、生成文件解码及 QEMU 核验，并保留计时器 ROI 的限制和后续目视确认。上述公开包实拍是独立的一轮结果，不覆盖近满卡或长时间压力拍摄。旧验证与 issue #3 后续记录继续可查。

python tests/validate.py --stock "/path/to/Z_8_0311.bin" --report build/prores-tests.json
python tests/validate_features.py --stock "/path/to/Z_8_0311.bin" --report build/feature-tests.json
# 开发者等价性测试另需已审阅编译器
python tests/validate_distribution.py --stock "/path/to/Z_8_0311.bin" --compiler clang --report build/distribution-tests.json
python tools/check_repository.py --staged

测试只使用本地临时目录，不访问相机。可用 git config core.hooksPath .githooks 启用提交检查。

后续可能研究 Log3G10 固件选项；本次不实现、不提供，也不承诺交付时间。

工具原创代码采用 GPL-3.0-only，不改变 Nikon 固件的许可。来源和许可范围见 NOTICE.md。本项目与 Nikon 无隶属关系。

感谢 @aoyukkk（傲宇）和“琴岛唯一指定哥布林”协助开发、开展实机测试并反馈问题。

感谢 RdWing/z8-qemu 的 Z8 仿真工作、WonderLantern/z9-qemu 的上游相机模型与工具、WonderLantern/z7-qemu 的模拟器与协议参考，以及 QEMU 的仿真基础设施。它们为本项目的离线开发和验证提供了帮助；本仓库不分发这些项目的源码或二进制。详见 NOTICE.md。