noctty README

项目的 README,来自 github.com/amanthanvi/noctty。合并为一个 markdown 文件:README.md。

Noctty

A native Windows terminal built on Ghostty's terminal core.
Tabs, splits, and session restore · Win32 and OpenGL · No telemetry

Download · Website · Getting started · Windows guide · Status · Contributing

Formerly winghostty. Renamed in August 2026 after a trademark request from the Ghostty team.

Noctty with two tabs and a vertical split, Dracula theme


Noctty is a Windows terminal that pairs the terminal core from Ghostty with a native Win32 app written for this fork.

Noctty is young and has one maintainer. It installs alongside your current terminal and does not replace it, so you can try both side by side. It runs on Windows only; macOS and Linux are not planned. See docs/status.md for what works and what is still experimental, and the capability matrix for a feature-by-feature comparison with upstream Ghostty.

Install

Requirements: Windows 10 version 1809 (build 17763) or later, or Windows 11, on x64 or ARM64. The default renderer needs a GPU driver that supports OpenGL 4.3 or later.

The latest release is noctty 1.3.137, published 2026-11-09.

With WinGet

winget install --id AmanThanvi.noctty -e

With Scoop

scoop bucket add noctty https://github.com/amanthanvi/scoop-noctty
scoop install noctty/noctty

With Chocolatey

choco install noctty

chocolatey.org reviews each version before listing it, so it can trail the other channels after a release.

Direct download

The installer adds a Start menu entry, an "Open noctty here" item to Explorer's right-click menu, and an uninstaller. The portable ZIP runs from any folder without installing.

Your PC Installer Portable
x64 (Intel and AMD) noctty-1.3.137-windows-x64-setup.exe noctty-1.3.137-windows-x64-portable.zip
ARM64 (Windows on Arm PCs) noctty-1.3.137-windows-arm64-setup.exe noctty-1.3.137-windows-arm64-portable.zip

[!NOTE] Releases are signed with a self-signed certificate, so Windows SmartScreen shows "Windows protected your PC" when you first run one. Check the download first, then click More info, then Run anyway. Hash the file and compare the result with its line in SHA256SUMS-windows-x64.txt or SHA256SUMS-windows-arm64.txt from the same release:

Get-FileHash .\noctty-1.3.137-windows-x64-setup.exe -Algorithm SHA256

A matching checksum shows the file arrived intact, not who published it. docs/verify-release.md covers the stronger provenance and signature checks.

Each release also includes signed manifests of the portable ZIP contents (noctty-1.3.137-windows-x64-portable.manifest.ps1 and noctty-1.3.137-windows-arm64-portable.manifest.ps1) and SHA256SUMS.txt, an alias of the x64 checksum file kept for older auto-update clients. Newer releases also publish a symbols zip per architecture, noctty-<version>-windows-<arch>-symbols.zip, for reading crash dumps; docs/windows.md says which releases have it.

Scoop puts noctty on your PATH. WinGet and Chocolatey run the installer, and neither the installer nor the portable ZIP adds it. To run the noctty commands in this README, add the install folder to PATH or run .\noctty.com from that folder.

For portable mode and uninstalling, see docs/getting-started.md. Switching terminals? There are guides for moving from Windows Terminal and from Git Bash/mintty.

Getting started

On first launch, Noctty writes a config template to %LOCALAPPDATA%\noctty\config.ghostty. Every default is built into the app, so the template sets no options: add only what you want to change. You can also press Ctrl+, to open the Settings window.

font-family = JetBrains Mono
font-size = 12
theme = Dracula

Save the file, then press Ctrl+Shift+, to reload. Run noctty +list-themes to browse the bundled themes.

A few keys to start with:

Action Keys
Copy / paste Ctrl+Shift+C / Ctrl+Shift+V
New tab Ctrl+Shift+T
Split right Ctrl+Shift+\
Split down Ctrl+Shift+E
Move between panes Alt+arrow keys
Command palette Ctrl+Shift+P
Search Ctrl+Shift+F
Settings Ctrl+,
Reload config Ctrl+Shift+,

The full list, and how to rebind keys, is in docs/getting-started.md. To drive Noctty from scripts and the command line, see docs/automation.md.

Privacy and updates

The privacy policy describes what Noctty stores on your PC, the connections it makes, and how to remove your data. More detail on updates is in docs/windows.md.

Troubleshooting

See docs/windows.md for more.

Build from source

You need:

git clone https://github.com/amanthanvi/noctty.git
cd noctty
zig build -Demit-exe=true

The app is built to zig-out\bin\noctty.exe, beside Microsoft's pinned ConPTY pair, which the first build downloads. Building has no Windows version requirement of its own, but running the result needs Windows 10 1809 or later. HACKING.md covers the dev shell, offline builds and tests, and PACKAGING.md covers building the installer and portable ZIP.

Relationship to Ghostty

Noctty is a fork of Ghostty. It takes in upstream changes in planned merge windows, normally after each Ghostty release; see the upstream merge policy, and docs/status.md for the Ghostty version it is currently based on. It shares Ghostty's terminal core, fonts, renderer, input handling, config, shell integration, and libghostty-vt. The Win32 app, the updater, and the Windows packaging were written for this fork, and the macOS and GTK apps have been removed. When Windows conventions and upstream behavior disagree, Noctty follows Windows.

Noctty is an independent project and is not affiliated with Ghostty.

Contributing

Bug reports and focused pull requests are welcome. Please read CONTRIBUTING.md and AI_POLICY.md first.

Pull requests are reviewed automatically by Greptile.

Greptile: The War on Bugs

License

MIT, the same as Ghostty. Copyright © 2024 Mitchell Hashimoto, Ghostty contributors. Changes made in this fork are released under the same license. See LICENSE.

noctty (amanthanvi/noctty)

正在搜索数据库…

564 ·GitHub
这是什么?Noctty 是一款面向 Windows 的原生终端应用,它将 Ghostty 的终端核心与专门的 Win32 界面结合在一起;此前它名为 winghostty。
这是基于现有终端的分支,还是从零开始开发的?它是 Ghostty 的一个分支:终端核心、字体、渲染器、输入处理、配置和 Shell 集成与 Ghostty 共用,但 Win32 应用、更新程序和 Windows 打包是为这个分支专门编写的。
我的电脑需要什么才能运行它?需要 Windows 10 17763 及以上版本或 x64、ARM64 架构的 Windows 11,另外默认渲染器需要支持 OpenGL 4.3 的显卡驱动(否则会回退到 Direct3D 11 渲染器)。
在我全面改用它之前,有什么需要注意的地方吗?这是一个较年轻的项目,目前只有一位维护者,暂不计划支持 macOS 和 Linux;会话恢复可以恢复窗口、标签页和工作目录,但无法恢复之前正在运行的程序。
它会向外发送任何数据吗?不会收集任何遥测数据;唯一的对外流量是对 GitHub Releases 的更新检查,崩溃转储文件只保存在你的电脑上。
如果我的显卡不支持 OpenGL 4.3,会发生什么?Noctty 会自动切换到测试版的 Direct3D 11 渲染器(先使用硬件 D3D11,再回退到微软的 WARP 软件渲染),并显示一条横幅提示;自定义着色器、背景图片和 Kitty 图像仍然需要 OpenGL。
它能在编码代理需要我关注时通知我吗?可以,代理和工具可以通过 OSC 7501 代码报告状态,将标签页标记为运行中、受阻、已完成或失败;当后台标签页需要你处理时,Noctty 会发出通知。
为什么它从 winghostty 更名为 noctty?该项目于 2026 年 8 月更名为 noctty,此前名为 winghostty。
我现有的 Ghostty 主题和配置能直接使用吗?可以,大多数 Ghostty 配置选项和主题无需修改即可使用,因为 Noctty 与 Ghostty 共用配置系统和终端核心。
大小
298.6 MB
星标
564
时长
7个月
提交 · 90 天