Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[Bug] 2.1.0 终端文字重叠 / Terminal text overlaps; rollback to 2.0.2 resolves it

Open
  • Is something wrong?
#246 4 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 2 days

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
12/100
Issue type
Bug
Clarity
Needs clarification
Activity status
Active
Tech stack
macos
Domain
computer-graphics, operating-systems

Research direction

The payload names no source file or test; it mentions only the nvrm610.conf setting and the NVMTL_NO_SURFACE_PAGEOFF flag, and the reporter says the root cause is unconfirmed. Start by reading the 2.0.2 to 2.1.0 changes to the driver's surface and page-offset handling, then reproduce on a single display at 60Hz, which the reporter has not tested. Done means a reproducible, confirmed cause or a maintainer-agreed fix, which needs Metal and macOS driver expertise and hardware access.

Written by the indexing model from the issue text.

Description

bug
Send logs report ID

NM-PQR7FX3X

Where does it go wrong?

An app or game

What happens

中文

我的实际观察（用户原话）：
“这个版本的终端显示好像有问题，是那种文字重叠的效果。”
“只在终端。”
“似乎是 github 新版本更新之后出现的情况哦。”

终端滚动或输出新行时，旧文字残留并与新文字重叠。完整回退 NVIDIA 2.0.2 并重启之后，我确认：“解决了。”

版本对照：2.1.0 出现；完整恢复 2.0.2 后消失。两个版本的四个 kext 加载 UUID、真实 Metal 计算与渲染回读均核验通过。

环境数据（助手核验、代填）：ASUS GU603ZM；i7-12700H；RTX 3060 Laptop / GA106 / 10DE:2520，6 GiB VRAM、BAR1 8 GiB；macOS 15.8.1 (24H32)；OpenCore 1.0.9；SMBIOS MacBookPro16,2；独显直连。复现时内屏 2560×1600@165Hz，外屏 27G5 2560×1440@144Hz。尚未进行单屏或 60Hz 对照；具体代码根因未确认。

English (assistant translation)

The reporter observed overlapping text only in Apple Terminal, apparently after updating the driver. When Terminal scrolls or prints new lines, old glyphs remain and overlap the new text.

After a complete rollback to NVIDIA 2.0.2 and a reboot, the reporter confirmed that the problem was resolved.

Version comparison: reproducible on 2.1.0; gone after fully restoring 2.0.2. For both versions, the loaded UUIDs of all four kexts matched the installed files, and actual Metal compute and rendered-pixel readback tests passed.

Environment (verified and entered by the assistant): ASUS GU603ZM; i7-12700H; RTX 3060 Laptop / GA106 / 10DE:2520, 6 GiB VRAM, 8 GiB BAR1; macOS 15.8.1 (24H32); OpenCore 1.0.9; SMBIOS MacBookPro16,2; discrete-GPU mode. At reproduction: internal 2560×1600@165Hz and external 27G5 2560×1440@144Hz. No single-display or 60Hz comparison has been performed for this issue. The specific code-level cause is not confirmed.

Written by you
  • I wrote this report myself. AI-written issues are closed without review (see CONTRIBUTING.md).
App or game (if it is one)

Apple Terminal / macOS 自带“终端” 2.14 (455.1)

Did you change anything yourself?

中文

保留了现有自定义 EFI、ACPI 和 CPU 修正。2.1.0 升级与 2.0.2 回退均未更改 EFI 或 boot-args。两个版本均保留 nvrm610.conf 中已有的 NVMTL_NO_NVENC=1 和 NVMTL_NO_NVENC_HEVC=1。

在单独新启动的 Terminal 进程中测试 NVMTL_NO_SURFACE_PAGEOFF=1，驱动日志确认该参数生效，但文字重叠仍出现；没有写入全局配置。另测试不透明背景、Menlo 14 和标准字体间距，也没有解决。

在本次驱动版本对照之前，曾单独尝试移除两个 AMFI 启动参数，因无法启动而完整回退。此次对照的两个版本均保留 amfi_get_out_of_my_way=0x1 和 amfi=0x80。

我使用了 AI 助手进行诊断和回退。上面的中文症状引语来自我本人；技术数据、设置摘要和英文翻译由助手填写。已通过官方网页上传经审查、脱敏的硬件、驱动状态、相关启动设置和两版本 Metal 测试输出摘录，报告 ID：NM-PQR7FX3X。这不是原生 1401 Send logs 的完整收集；未上传原始日志、原始截图或完整 EFI。

English

Existing custom EFI/ACPI/CPU fixes were preserved. Neither the 2.1.0 upgrade nor the 2.0.2 rollback changed EFI or boot-args. Existing nvrm610.conf additions NVMTL_NO_NVENC=1 and NVMTL_NO_NVENC_HEVC=1 were retained in both versions.

An isolated new Terminal process with NVMTL_NO_SURFACE_PAGEOFF=1 still showed the issue; the driver log confirmed that flag took effect. This was not written to the global config. Opaque background, Menlo 14 and standard font spacing also did not fix it.

A separate attempt to remove the two AMFI boot arguments failed to boot and was fully reverted before this driver-version comparison. Both compared versions retain amfi_get_out_of_my_way=0x1 and amfi=0x80.

I used an AI assistant for diagnostics and rollback. The Chinese symptom quotations above are my own words; the technical data, settings summary and English translation were entered by the assistant. Reviewed, redacted extracts of hardware, driver state, relevant boot settings and Metal test output for both versions were uploaded via the official website: NM-PQR7FX3X. This is not a complete native 1401 Send logs collection. No raw logs, original screenshots or full EFI were uploaded.

Dominant language
Rust
Stars
2.5k
Forks
233
Avg merge
1h 37m
Merged PRs (30d)
1

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from nullmoth/nvidia-macos-driver

All issues in nullmoth/nvidia-macos-driver

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.