Update performance docs

This commit is contained in:
Kovid Goyal 2026-11-09 08:14:14 +05:30
parent aba7f2c54b
commit f1edbf46c2
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C

View file

@ -77,33 +77,114 @@ Throughput
kitty has a builtin kitten to measure throughput, it works by dumping large
amounts of data of different types into the tty device and measuring how fast
the terminal parses and responds to it. The measurements below were taken with
the same font, font size and window size for all terminals, and default
settings, on the same computer. They clearly show kitty has the fastest
throughput. To run the tests yourself, run ``kitten __benchmark__`` in the
terminal emulator you want to test, where the kitten binary is part of the
kitty install.
the terminal parses and responds to it. To run the tests yourself, run
``kitten __benchmark__`` in the terminal emulator you want to test, where the
kitten binary is part of the kitty install. To compare multiple terminals, use
the :repo_file:`comparative_benchmark.py` script in the kitty source code, which
runs the benchmark in all installed terminals from the set below, on a
Linux+Wayland system.
The numbers are megabytes per second of data that the terminal
processes. Measurements were taken under Linux/X11 with an ``AMD Ryzen 7 PRO
5850U``. Entries are in order of decreasing performance. kitty is twice
as fast as the next best.
The measurements below were taken with the same font (DejaVu Sans Mono 11pt),
window size (120x40 cells) and otherwise default settings for all terminals,
on the same computer, running Linux 7.2 under Wayland with an ``AMD
Ryzen AI 7 PRO 360``, with the terminals pinned to its fast cores. The numbers
are megabytes per second of data that the terminal processes, higher is better.
Entries are in order of decreasing average performance.
================ ====== ======= ===== ====== =======
Terminal ASCII Unicode CSI Images Average
================ ====== ======= ===== ====== =======
kitty 0.33 121.8 105.0 59.8 251.6 134.55
gnometerm 3.50.1 33.4 55.0 16.1 142.8 61.83
alacritty 0.13.1 43.1 46.5 32.5 94.1 54.05
wezterm 20230712 16.4 26.0 11.1 140.5 48.5
xterm 389 47.7 18.3 0.6 56.3 30.72
konsole 23.08.04 25.2 37.7 23.6 23.4 27.48
alacritty+tmux 30.3 7.8 14.7 46.1 24.73
================ ====== ======= ===== ====== =======
=========================== ===== ======= ===== ====== ====== =======
Terminal ASCII Unicode CSI Colors Images Average
=========================== ===== ======= ===== ====== ====== =======
ghostty 1.4.0 525.8 148.9 156.9 198.0 836.3 373.2
kitty 1.0.0 385.7 140.8 116.5 188.4 805.3 327.3
foot 1.28.0 316.6 103.1 63.5 331.8 491.3 261.3
alacritty 0.17.0 162.4 117.7 78.6 240.1 419.5 203.7
ptyxis 50.1 272.4 95.0 39.1 148.6 263.0 163.6
wezterm 20260716 31.7 38.7 15.4 45.7 274.8 81.2
konsole 26.08.3 46.8 62.7 46.1 113.1 31.8 60.1
xterm 411 61.8 48.2 < 2.8 53.5 117.3 < 56.7
alacritty 0.17.0 + tmux 3.8 57.2 9.5 24.9 35.6 53.8 36.2
=========================== ===== ======= ===== ====== ====== =======
In this table, each column represents different types of data. The CSI column
is for data consisting of a mix of typical formatting escape codes and some
ASCII only text.
ASCII only text. The Colors column is for text where every character has
a different 24-bit color. Full results, including all the benchmarks, for the
four fastest terminals are below.
.. tab-set::
.. tab-item:: kitty
================= ===== ======= ======== =========
Benchmark MB/s Cells/s Time (s) Data (MB)
================= ===== ======= ======== =========
ascii 385.7 387.3 M 1.04 399
unicode 140.8 81.6 M 4.91 692
scrollback 270.0 271.1 M 1.48 399
render 370.0 371.5 M 1.08 399
unique_unicode 51.3 - 17.07 875
csi 116.5 - 4.29 500
long_escape_codes 812.4 - 4.83 3920
truecolor_text 188.4 - 5.31 1000
palette16_text 223.3 - 4.48 1000
halfblocks 261.5 - 3.83 1001
images 805.3 - 3.31 2667
================= ===== ======= ======== =========
.. tab-item:: ghostty
================= ===== ======= ======== =========
Benchmark MB/s Cells/s Time (s) Data (MB)
================= ===== ======= ======== =========
ascii 525.8 527.9 M 0.76 399
unicode 148.9 86.2 M 4.65 693
scrollback 384.0 385.5 M 1.04 399
render 406.6 408.2 M 0.98 399
unique_unicode 65.3 - 13.39 875
csi 156.9 - 3.19 500
long_escape_codes 829.0 - 4.73 3920
truecolor_text 198.0 - 5.05 1000
palette16_text 256.2 - 3.90 1000
halfblocks 199.7 - 5.01 1001
images 836.3 - 3.19 2667
================= ===== ======= ======== =========
.. tab-item:: foot
================= ===== ======= ======== =========
Benchmark MB/s Cells/s Time (s) Data (MB)
================= ===== ======= ======== =========
ascii 316.6 317.9 M 1.26 399
unicode 103.1 59.7 M 6.71 692
scrollback 295.6 296.8 M 1.35 399
render 294.1 295.3 M 1.36 399
unique_unicode 11.3 - 77.68 875
csi 63.5 - 7.87 500
long_escape_codes 283.8 - 13.81 3920
truecolor_text 331.8 - 3.01 1000
palette16_text 329.4 - 3.04 1000
halfblocks 306.1 - 3.27 1001
images 491.3 - 5.43 2667
================= ===== ======= ======== =========
.. tab-item:: alacritty
================= ===== ======= ======== =========
Benchmark MB/s Cells/s Time (s) Data (MB)
================= ===== ======= ======== =========
ascii 162.4 163.1 M 2.46 399
unicode 117.7 68.2 M 5.88 692
scrollback 82.0 82.4 M 4.87 399
render 158.5 159.1 M 2.52 399
unique_unicode 59.8 - 14.64 875
csi 78.6 - 6.36 500
long_escape_codes 146.2 - 26.82 3920
truecolor_text 240.1 - 4.16 1000
palette16_text 236.5 - 4.23 1000
halfblocks 259.2 - 3.86 1001
images 419.5 - 6.36 2667
================= ===== ======= ======== =========
.. note::
@ -112,23 +193,29 @@ ASCII only text.
typically render asynchronously, therefore the numbers from that benchmark
are not really useful for comparison, as it is just a game about how much
input to *batch* before rendering the next frame.
However, even with rendering enabled kitty is still faster than all the
rest. For brevity those numbers are not included.
.. note::
foot, iterm2 and Terminal.app are left out as they do not run under X11.
Alacritty+tmux is included just to show the effect of putting a terminal
multiplexer into the mix (halving throughput) and because alacritty isn't
remotely comparable to any of the other terminals feature wise without tmux.
iTerm2 and Terminal.app are left out as they do not run under Linux. ptyxis
uses the same VTE terminal widget as GNOME Terminal. Alacritty+tmux is
included to show the effect of putting a terminal multiplexer into the mix
and because alacritty isn't remotely comparable to any of the other
terminals feature wise without tmux.
.. note::
konsole, gnome-terminal and xterm do not support the `Synchronized update
Each benchmark was given a maximum of 180 seconds per terminal. xterm did
not complete the CSI benchmark in that time, so its number for that
benchmark is an upper bound. The Images column is only meaningful for
terminals that support the :doc:`kitty graphics protocol
<graphics-protocol>`, other terminals simply discard the image data.
.. note::
Terminals that do not support the `Synchronized update
<https://gitlab.com/gnachman/iterm2/-/wikis/synchronized-updates-spec>`__
escape code used to suppress rendering, if and when they gain support for it
their numbers are likely to improve by ``20 - 50%``, depending on how well they
implement it.
escape code used to suppress rendering, render while the benchmark is running,
which lowers their numbers.
Energy usage