From f1edbf46c26e3ee0f1be5b918fda76e04869806c Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Mon, 9 Nov 2026 08:14:14 +0530 Subject: [PATCH] Update performance docs --- docs/performance.rst | 151 ++++++++++++++++++++++++++++++++++--------- 1 file changed, 119 insertions(+), 32 deletions(-) diff --git a/docs/performance.rst b/docs/performance.rst index 63ac0824f..1f9c4c96a 100644 --- a/docs/performance.rst +++ b/docs/performance.rst @@ -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 + `, other terminals simply discard the image data. + +.. note:: + + Terminals that do not support the `Synchronized update `__ - 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