Package: wnpp
Severity: wishlist
Owner: Edmund Lodewijks <[email protected]>
X-Debbugs-Cc: [email protected]

* Package name    : libghostty-vt
  Version         : 1.0.1
  Upstream Contact: Mitchell Hashimoto and Ghostty contributors
* URL             : https://github.com/ghostty-org/ghostty (library docs:
                     https://lib.ghostty.org/vt/)
* License         : MIT
  Programming Lang: C (built with Zig; no C/C++ toolchain needed to build it)
  Description     : virtual terminal emulation library from Ghostty

 libghostty-vt is a standalone C library, split out of the Ghostty
 terminal emulator, that implements terminal emulation: parsing the
 stream of bytes a program writes to a pseudo-terminal (escape
 sequences, control codes, etc.) and maintaining the resulting
 terminal state (screen grid, scrollback, cursor, modes). It exposes
 a C ABI (<ghostty/vt.h>) that is independent of Ghostty's GUI, so it
 can be embedded by any terminal, multiplexer, or TUI tool that needs
 a battle-tested VT parser rather than writing its own.
 .
 The library is distributed on its own release cycle, separately
 from the Ghostty application, with vt-X.Y.Z tags and signed source
 tarballs (release.files.ghostty.org/libghostty-vt/). 1.0.0 (tagged
 2026-11-06) was the first release with a stable C ABI; 1.0.1 followed
 on 2026-11-11. The shared library's SONAME tracks only the major
 version (libghostty-vt.so.1), and upstream's own
 PACKAGING-LIBGHOSTTY.md explicitly discusses splitting it into
 runtime/dev packages and suggests the Debian-style runtime package
 name libghostty-vt1.
 .
 Upstream builds it exclusively with Zig (0.17.x for this release);
 there is no CMake or autotools build path, only a Zig build that
 downstream users can also reach via pkg-config/CMake fetch wrappers
 after installation. Zig itself is not yet packaged in Debian, but
 work is on the way in this regard (to which I contribute).
 .
 Other distributions already carry it as a separate package: Arch's
 AUR, Fedora/Terra, and FreeBSD Ports. The AUR package documents that
 the standalone build installs files (/usr/include/ghostty/vt.h,
 /usr/lib/libghostty-vt.so, etc.) that collide with Ghostty's own
 bundled build of the same library, and so declares Conflicts against
 the ghostty package. Debian already has an open ITP for ghostty
 itself (#1091469, owned by nick black); whichever of these two
 packages lands first will need the other's maintainer to either
 patch the ghostty build to not install its bundled libghostty-vt to
 system paths, or to have ghostty depend on libghostty-vt-dev instead
 of building its own copy. I'll coordinate with #1091469 on this
 before uploading.
 .
 I intend to package libghostty-vt via the zig-team, as a new source
 package producing libghostty-vt1 (runtime) and libghostty-vt-dev
 (headers, .pc/.cmake files, static library).

Reply via email to