Codebergdnkl

foot

master
ply6 git calls1.4 s75 KiB3 cachedprotocol v2
3871 lines139 KiBRaw

Changelog

Unreleased

Added

Changed

  • Cells with a non-default background colors, but otherwise empty, are now preserved (not removed) when resizing a terminal window (#2462).

Deprecated

Removed

Fixed

  • Use-after-free during shutdown when footclient and the client application exit simultaneously in a short window (#2432).
  • Crash when a buggy compositor sends an ime_enter() event with a NULL surface (#2467).
  • Possible memory leak when processing keymap data (#2482).
  • Word-wise selection sometimes not working properly due to incorrect selection direction (#2483).
  • Crash in xdg_output_handle_done() if called when a terminal is in the process of shutting down (#2487).
  • Not responding to an OSC-52 query if clipboard source has no data (#2493).

Security

Contributors

1.28.0

Added

  • Command line option --class, an alias for --app-id. Intended to be used by scripts and similar that wants to launch terminal instances in a terminal agnostic way (#2368).
  • Support for terminal visibility reports, using the Wayland xdg_toplevel suspended state.
  • Support for wl_fixes::ack_global_remove().

Changed

  • Do not allow codepoints to be merged into grapheme clusters directly after a cursor move (#2383).
  • Dracula theme updated to latest official, and light theme alucard added.
  • Sixels: pan/pad clamped to 5 (#2371).
  • Default URL regex changed to:
    • allow single quotes (') inside the URL (but not at the end, unless balanced).
    • require at least one character inside balanced [], (), '' or "". (#2417).
  • Foot now sets window urgency when a notification is activated, and foot hasn't received an XDG activation token.
  • -D,--working-directory now supports file:// URIs.

Removed

  • [colors] and [colors2] config sections, and the corresponding color-theme-switch-1 and color-theme-switch-2 key bindings.

    These were deprecated in 1.26.0, and were replaced by [colors-dark], [colors-light], color-theme-switch-dark and color-theme-switch-light.

Fixed

  • Out-of-bounds read when parsing URIs with malformed %-encoded content (#2353).
  • DECCRA not clamping or verifying the destination rectangle (#2352).
  • Empty selection clearing the clipboard (#2327).
  • Require xkbcommon >= 1.6.0. This has been the case for a while, due to our use of XKB_KEYSYM_MAX. Now it is formalized in meson.build (#2379).
  • Block selection area incorrectly updated when selecting back across the starting column.
  • Passing a very large value as CHT/CBT argument hangs the terminal (#2360).
  • Sixel: crash when using a shared palette and gamma-correct blending has been enabled, or foot is using 10-bit surface (#2370).
  • Kitty text-size protocol: fix crash when text is zero-length (#2364).
  • Escape quotes in file names being DnD:ed on the command line (#2363).
  • Crash in --server mode, when a tracked notification is closed after the associated terminal instance has been closed (#2397).
  • Incorrect word boundary detection when selection words with a multi-column character in the last column (#2411).
  • reallocarray() is no longer required, so as to support platforms where libc doesn't include it (e.g. Termux + Android API < 29).
  • Crash in select-quote when the right-side quote appeared right after a newline, in column 0 (#2405).
  • Resizing a terminal window may break current selection.
  • Crash when closing a window that touch input focus.
  • Application mouse grabbing not working when there is no keymap available.
  • Crash when a buggy compositor sends a keyboard_enter() event with a NULL surface (#2438).
  • Crash when clicking without moving the mouse after resizing the window, and the clicked area is now outside the cell grid (#2435).
  • Modifiers in mouse-bindings colliding with the modifiers in selection-override-modifiers not always detected.
  • selection-override-modifiers=none preventing applications from grabbing the mouse.

Contributors

  • 0WD0
  • airkoala
  • aloires
  • Campbell Barton
  • CismonX
  • Craig Barnes
  • Emily Vlasics
  • fhqh
  • K4
  • koru
  • lumerue
  • Marinus Klasen
  • sentriz
  • Tim Culverhouse

1.27.0

Added

  • url.style=none|single|double|curly|dotted|dashed option added, allowing you to configure how URL underlines are drawn. The default is dotted (#2302).

Changed

  • URL underlines are now dotted by default, instead of plain underlines. This can be changed with the new url.style option.
  • If the cursor foreground and background colors are identical, use the current cell's foreground and background colors (inverted), instead of the default foreground and background colors (#2323).

Fixed

  • Other output (key presses, query replies etc) being mixed with paste data, both interactive pastes and OSC-52 (#2307).
  • Scrollback search not working correctly when the terminal application has enabled the kitty keyboard protocol with release event reporting (#2316).
  • Keypad escapes in the legacy keyboard protocol ignoring the shift modifier (#2324).
  • Crash when querying the kitty notification protocol (OSC-99, with p=?) (#2335).

1.26.1

Fixed

  • Wrong documented default value for initial-color-theme in foot.ini(5) (#2292).
  • Occasional crashes when closing a window and tweak.pre-apply-damage=yes (the default) (#2288).

Contributors

  • Roshless
  • vlkrs

1.26.0

Added

  • toplevel-tag option (and --toplevel-tag command line options to foot and footclient), allowing you to set a custom toplevel tag. The compositor must implement the new xdg-toplevel-tag-v1 Wayland protocol (#2212).
  • [colors-dark] section to foot.ini. Replaces [colors].
  • [colors-light] section to foot.ini. Replaces [colors2].
  • XTGETTCAP: added query-os-name, returning the OS foot is compiled for (e.g. 'Linux') (#2209).
  • pad option now supports 4-directional padding format: LEFTxTOPxRIGHTxBOTTOM (e.g., 20x10x20x10).
  • --config=PATH option is now automatically passed to new terminals spawned via spawn-terminal action (#2259).
  • Preliminary (untested) support for background blur via the new ext-background-effect-v1 protocol. Enable by setting colors-{dark,light}.blur=yes. Foot needs to have been built against wayland-protocols >= 1.45, and the compositor must implement the ext-background-effect-v1 protocol, and the blur effect.

Changed

  • When enabling "focus mode" (private mode 1004), foot now sends a focus event immediately, to inform the application what the current state is (#2202).
  • Scrollback search is now case sensitive when the search string contains at least one upper case character.
  • Mouse tracking in SGR pixel mode no longer emits negative column/row pixel values (#2226).
  • Foot now always uses ARGB SHM surfaces. In earlier versions, XRGB surfaces were used for opaque surfaces. Unfortunately, several compositors had issues when foot switched between ARGB and XRGB surfaces (for example when switching color theme, or toggling fullscreen).

Deprecated

  • [colors] section in foot.ini. Use [colors-dark] instead.
  • [colors2] section in foot.ini. Use [colors-light] instead.

Removed

  • cursor.color config option (deprecated in 1.23.0). Use colors-{dark,light}.cursor instead.

Fixed

  • Search mode: composing keys not ignored.
  • Crash when triple-clicking a soft-wrapped line and there is a quote character in the last column.
  • Crash when reverse-scrolling (terminfo capability rin) such that the current viewport ends up outside the scrollback (#2232).
  • Regression: visual glitches in rare circumstances.
  • Key release events for shortcuts being sent to the client application (kitty keyboard protocol only) (#2257).
  • Crash when application emits sixel RA with a height of 0, a width > 0, and then starts writing sixel data (#2267).
  • Crash if shutting down terminal instance while a "pre-apply damage" thread is running (#2263).

Contributors

  • Andrei
  • Barinderpreet Singh
  • c4llv07e
  • Johannes Altmanninger
  • nariby
  • pi66
  • Ronan Pigott
  • Stéphane Klein
  • valoq
  • Whyme Lyu
  • Yaakov Selkowitz

1.25.0

Added

  • Performance increased and input latency decreased on compositors that do not release SHM buffers immediately (#2188).
  • colors{,2}.dim-blend-towards=black|white option, allowing you to select towards which color to blend when dimming text. Defaults to black in [colors], and white in [colors2] (#2187).

Changed

  • SHM buffer sizes are now rounded up to nearest page size, and their stride is always an even multiple of 256 bytes (by default, configurable by setting tweak.min-stride-alignment). This allows compositor to directly import foot's SHM buffers to the GPU, with e.g. integrated graphics (#2182).
  • Jump label colors in the modus-operandi theme, for improved readability.

Fixed

  • URL labels misplaces when URL contains double-width characters (#2179).
  • One space too much consumed when copying (or pipe:ing) contents with tabs (#2194)
  • Ensure we render a new frame when changing fullscreen state. Before, this was automatically done if the window was also resized. But, it is possible for a compositor to change an application's fullscreen state without resizing the window.

Contributors

  • Charalampos Mitrodimas
  • Matthias Heyman

1.24.0

Added

  • The uppercase-regex-insert option controls whether an uppercase hint character will insert the selected text into the prompt in regex-copy or show-urls-copy mode. It defaults to true. (#2159).

Changed

  • The label letters are no longer sorted before being assigned to URLs (#2140).
  • Sending SIGUSR1/SIGUSR2 to a foot --server process now causes newly spawned client instances to use the selected theme, instead of the original one.
  • SIGUSR1/SIGUSR2 can now be sent to footclient processes, to change the theme of that particular instance (#2156).

Fixed

  • Invalid configuration values overriding valid ones in surprising ways.
  • Bug where the libutempter utmp backend did not record logouts correctly.

Contributors

  • Ryan Roden-Corrent
  • Tobias Mock

1.23.1

Changed

  • URL labels are now assigned in reverse order, from bottom to top. This ensures the last URL (which is often the one you are interested in) is always assigned the same key (#2140).
  • Sending SIGUSR1 no longer toggles between [colors] and [colors2], but explicitly changes to [colors]. SIGUSR2 changes to [colors2] (#2144).

Fixed

  • 10-bit surfaces sometimes used instead of 16-bit.
  • OSC-104/110/111/112/117/119 (reset colors) not taking the currently active theme into account.

1.23.0

Added

  • colors2 config section. This section duplicates the colors section, and lets you define an alternative color theme.
  • key-bindings.color-theme-switch-1, key-bindings.color-theme-switch-2 and key-bindings.color-theme-toggle key bindings. These can be used to switch between the primary and alternative color themes. They are not bound by default.
  • Sending SIGUSR1 to the foot process now triggers a theme switch (in server mode, all instances toggles their themes).
  • Support for private mode 2031 - Dark and Light Mode Detection (#2025)
  • Added initial-color-theme=1|2 config option. 1 uses colors from the [colors] section, 2 uses [colors2].
  • Combined dark/light theme files for (dark variant is the default, set initial-color-theme=2 to use the light variant by default):
    • gruvbox
    • nvim
    • paper-color
    • selenized
    • solarized
  • regex-copy/show-urls-copy will copy and paste the selected text if the hint is completed with an uppercase character (#1975).
  • 16-bit to tweak.surface-bit-depth. Makes foot use 16-bit image buffers. They provide the necessary color precision required by gamma-correct-blending=yes.
  • New cursor shapes, from cursor-shape-v1 version 2.
  • center-when-fullscreen and center-when-maximized-and-fullscreen to the pad option. This allows you to configure when the grid is centered in more detail (#2111).

Changed

  • cursor.color moved to colors.cursor.
  • OSC-11 without an alpha value will now restore the configured (i.e. from foot.ini) alpha, rather than keeping whatever the current alpha value is, unchanged.
  • gamma-correct-blending=yes now defaults to 16-bit image buffers, instead of 10-bit.
  • Allow setting either selection background, or selection foreground, only (#1846).
  • Drop required version of libxkbcommon from 1.8.0 back to 1.0.0 (#2103).
  • OSC-52: an empty payload now clears the clipboard.
  • DA (Device Attributes): include 52 in the reply, to indicate OSC-52 support (when at least copy has been enabled in security.osc52).

Deprecated

  • cursor.color config option; use colors.cursor instead.

Removed

  • Subsurface unmap quirk for Sway. This was a workaround added in 1.12.1, for Sway issue #6960.

Fixed

  • REP: wrong width of repeated multi-codepoint graphemes.
  • Incorrect surface commit after a configure event, under certain conditions (#2105).

Contributors

  • Chen Mulong
  • Kirill Primak
  • Ryan Roden-Corrent
  • tokyo4j

1.22.3

Added

  • auto to the tweak.surface-bit-depth option.

Changed

  • gamma-correct-blending now defaults to no instead of yes.
  • tweak.surface-bit-depth default value changed to auto; uses 10-bit surfaces when gamma-correct-blending=yes, and 8-bit surfaces otherwise.

Fixed

  • Inaccurate colors when gamma-correct-blending=yes (#2082).

1.22.2

Changed

  • gamma-correct-blending=yes now uses a pure gamma 2.2 transfer function, instead of the piece-wise sRGB transfer function, to match what compositors do.

Fixed

  • Wrong colors when gamma-correct-blending=yes (the default when there is compositor support). Note that some colors will still be off by a very small amount, due to loss of precision when converting to a linear color space. (#2035).

1.22.1

Fixed

  • colors.alpha-mode=matching not working as intended.
  • Grapheme shaping was allowed to be "enabled" at runtime, even though disabled at compile time. This caused mis-rendering of certain codepoints (#2039).
  • Keyboard modifiers not being reset on keyboard leave events (#2034).
  • Fallback font (and possibly wrong color) being used when a character was followed by a zero-width grapheme breaking codepoint (for example, LEFT-TO-RIGHT MARK) (#2049).
  • Regression: alpha applied to inversed text/selections (#2073).

Contributors

  • Jan Palus
  • valoq

1.22.0

Added

  • Support for toplevel edge constraints. When the compositor indicates the toplevel has edge constraints, foot will not allow the window to be resized (via CSDs) in the constrained directions.
  • Virtual modifiers (e.g. Alt instead of Mod1, Super instead of Mod4 etc) in key bindings are now recognized as being virtual, and are automatically mapped to the corresponding real modifier. This means you can use e.g. Alt+b instead of Mod1+b.
  • alpha-mode option to foot.ini. Defaults to default. This config changes how alpha is handled on background colours not set by the terminal.(e.g. vim) (#2026)

Changed

  • UTF-8 error recovery now discards fewer bytes.
  • Auto-calculated dimmed and brightened colors (e.g. when custom dim colors has not configured) is now done by linear RGB interpolation, rather than converting to HSL and adjusting the luminance (#2006).
  • Virtual modifiers in keyboard events from the compositor are now supported. This works around various issues seen when running foot under mutter (GNOME) (#2009):
    • Some key combinations generating the wrong escape sequence in the kitty keyboard protocol.
    • some of foot's default shortcuts not working (mainly those using Mod1) out of the box.
  • Default URL regex changed to a much more strict variant (#2016). You can manually set the old one, if you prefer it over the new regex.
  • A tiled window can now be resized in the corners (via CSDs), unless the compositor has indicated the toplevel has edge constraints.

Fixed

  • Regression: assertion in url-mode.c when activating a second URL via show-urls-persistent (#2000).
  • Build failure (srgb.h not found) when doing a parallel build.
  • Regression: reflowing (changing the window size) removing empty lines (#2011).
  • url/regex-copy not handling double-width characters correctly (#2027).

Contributors

  • Alex Xu (Hello71)
  • datsudo
  • Dominique Martinet
  • Fazzi
  • llyyr
  • Łukasz Wojniłowicz
  • Sam McCall

1.21.0

Added

  • Support for the new Wayland protocol xdg-system-bell-v1 protocol (added in wayland-protocols 1.38), via the new config option bell.system=no|yes (defaults to yes).
  • Support for custom regex matching (#1386, #1872)
  • Support for kitty's text-sizing protocol (w, width, only), OSC-66.
  • cursor.style can now be set to hollow (#1965).
  • search-bindings.delete-to-start and search-bindings.delete-to-end key bindings, defaulting to Control+u and Control+k respectively (#1972).
  • Gamma-correct font rendering. Requires compositor support (wp_color_management_v1, and specifically, the ext_linear transfer function). Enabled by default when compositor support is available. Can be explicitly enabled or disabled with gamma-correct-blending=no|yes.

Changed

  • Do not try to set a zero width, or height, if the compositor sends a configure event with only one dimension being zero (#1925).
  • Auto-detection of URLs (i.e. not OSC-8 based URLs) are now regex based.
  • Rename Tokyo Night Day theme to Tokyo Night Light and update colors.
  • fcft >= 3.3.1 is now required.
    • tweak.scaling-filter now supports more scaling-filters
    • scaled bitmap fonts (when enabled in FontConfig) no longer have a scaling-filter applied
  • Linefeed:ing control characters (e.g. \n) no longer clears a row's internal linebreak flag. This fixes an issue where e.g. multi-line prompt input in fish is treated as separate lines, rather than one logical, when selecting and copying it (#1487).
  • wayland-protocols >= 1.41 is now required.

Removed

  • url.uri-characters and url.protocols. Both options have been replaced by url.regex.
  • notify option (has been deprecated since 1.18.0).
  • notify-focus-inhibit option (has been deprecated since 1.18.0).

Fixed

  • Kitty keyboard protocol: alternate key reporting failing to report the alternate codepoint in some corner cases (#1918).
  • foot and footclient hanging, or terminating with SIGABRT, when starting inside a directory whose total length is more than 1024 characters.
  • Regression: reflowing (resizing the window) a line that ends with a double-width glyph that was pushed to the next line due to there being only one cell left on current line, did not remove the virtual space inserted at the end of the current line.
  • Wrong key bindings executed when using alternative keyboard layouts (#1929).
  • Foot not closing file descriptors for unrecognized or no_keymap keymaps.
  • Combining characters (including emojis consisting of multiple codepoints) not being handled correctly when insert mode is enabled (#1947).
  • Reflow of the cursor (active + saved) when at the end of the line with a pending wrap (LCF set) (#1954).
  • Zero-width characters that also are grapheme breaks (e.g. U+200B, ZERO WIDTH SPACE) being ignored (discarded and never stored in the grid) (#1960). (reverted)
  • --server=<FD> not working on FreeBSD (#1956).
  • Crash when resetting the terminal and an application had previously set a custom app ID (#1963)
  • Grapheme clustering state not reset on cursor movements.
  • Kitty keyboard protocol: no release events emitted for composed keys.
  • IME: the initial cursor position was reported as 0,0,0,0 (#1994).

Contributors

  • Adrian fxj9a
  • Alexander Orzechowski
  • Attila Fidan
  • camel-cdr
  • Craig Barnes
  • Guillaume Outters
  • Johannes Altmanninger
  • Ludovico Gerardi
  • sewn
  • Thomas Bonnefille

1.20.2

Changed

  • The CSI 21 t (report window title) and OSC 176 ? (report app-id) escape sequences are now ignored (#1894).

Fixed

  • 'flash' overlay (triggered by either tput flash, or enabling bell.visual and then sending BEL to the terminal) stuck when colors.flash-alpha=1.0.
  • Crash when compositor sends a keyboard enter event before the foot window has been mapped (#1910).
  • Build failures (utf8proc.h not found) on at least FreeBSD, but most likely other BSDs, as well as some Linuxes (#1903).

Contributors

  • Alexander Orzechowski

1.20.1

Changed

  • Runtime changes to the app-id (OSC-176) now limits the app-id string to 2048 characters (#1897).
  • colors.flash-alpha can no longer be set to 1.0 (i.e. fully opaque). This fixes an issue where the window would be stuck in the flash state.

Fixed

  • Regression: trying to print a Unicode "Legacy Computing symbol", in the range U+1FB00 - U+1FB9B would crash foot (#1901).

1.20.0

Added

  • Unicode data files updated to Unicode 16. Foot uses these to determine which VS-15 and VS-16 sequences are valid, and which are not.
  • Box drawing characters U+1CD00...U+1CDE5 (the "octants" from the "Symbols for Legacy Computing Supplement" codepoint range, added in Unicode 16.0).
  • security.osc52 option, allowing you to partially or fully disable host clipboard access via the OSC-52 escape sequence (#1867).

Changed

  • OSC-9: sequences beginning with <number>; are now ignored. These sequences are ConEmu/Windows Terminal sequences, and not intended to be notifications.
  • Use utf8proc_charwidth() instead of wcwidth()+wcswidth() when calculating character width, when foot has been built with utf8proc support (#1865).
  • Run-time changes to the window title, and the app ID now require the new value to consist of printable characters only.
  • Kitty keyboard protocol: Enter, Tab and Backspace no longer report release events unless "Report all keys as escape codes" is enabled (#1892).

Fixed

  • Crash when receiving an OSC-9 or OSC-777 with an empty notification body (#1866).
  • Crash when tripple-clicking on region containing NUL characters.

Contributors

  • cy
  • Denis Zharikov
  • heather7283
  • Jack Wilsdon
  • Mark Stosberg

1.19.0

Added

  • resize-keep-grid option, controlling whether the window is resized (and the grid reflowed) or not when e.g. zooming in/out (#1807).
  • strikeout-thickness option.
  • Implemented the new xdg-toplevel-icon-v1 protocol.
  • Implemented CSI 21 t: report window title.
  • colors.sixelNN option, controlling the default sixel color palette.

Changed

  • cursor.unfocused-style is now effective even when cursor.style is not block.
  • Activating a notification triggered with OSC-777, or BEL, now focuses the foot window, if XDG activation tokens are supported by the compositor, the notification daemon, and the notification helper used by foot (i.e. desktop-notifications.command). This has been supported for OSC-99 since 1.18.0, and now we also support it for BEL and OSC-777 (#1822).
  • Sixel background color (when P2=0|2) is now set to the sixel color palette entry #0, instead of using the current ANSI background color. This is what a real VT340 does.
  • The .desktop files no longer use the reverse DNS naming scheme, and their names now match the default app-ids used by foot (foot and footclient) (#1607).
  • file:// prefix are now stripped from OSC-8 URIs when activated/opened, if the hostname matches the hostname of the computer foot is running on (#1840).

Fixed

  • Some invalid UTF-8 strings passing the validity check when setting the window title, triggering a Wayland protocol error which then caused foot to shutdown.
  • "Too large" values for scrollback.lines causing an integer overflow, resulting in either visual glitches, crashes, or both (#1828).
  • Crash when trying to set an invalid cursor shape with OSC-22, when foot uses server-side cursor shapes.
  • Occasional visual glitches when selecting text, when foot is running under a compositor that forces foot to double buffer (e.g. KDE/KWin) (#1715).
  • Sixels flickering when foot is running under a compositor that forces foot to double buffer (e.g. KDE, or Smithay based compositors) (#1851).

Contributors

  • Andrew J. Hesford
  • Craig Barnes
  • Oleh Hushchenkov
  • tokyo4j

1.18.1

Added

  • OSC-99: support for the s parameter. Supported keywords are silent, system and names from the freedesktop sound naming specification.
  • ${muted} and ${sound-name} added to the desktop-notifications.command template.

Changed

  • CSD buttons now activate on mouse button release, rather than press (#1787).

Fixed

  • Regression: OSC-111 not handling alpha changes correctly, causing visual glitches (#1801).

Contributors

  • Craig Barnes
  • Shogo Yamazaki

1.18.0

Added

  • cursor.blink-rate option, allowing you to configure the rate the cursor blinks with (when cursor.blink=yes) (#1707);
  • Support for wp_single_pixel_buffer_v1; certain overlay surfaces will now utilize the new single-pixel buffer protocol. This mainly reduces the memory usage, but should also be slightly faster.
  • Support for high-res mouse wheel scroll events (#1738).
  • Styled and colored underlines (#828).
  • Support for SGR 21 (double underline).
  • Support for XTPUSHCOLORS, XTPOPCOLORS and XTREPORTCOLORS, i.e. color palette stack (#856).
  • Log output now respects the NO_COLOR environment variable (#1771).
  • Support for in-band window resize notifications, private mode 2048.
  • Support for OSC-99 "Kitty desktop notifications".
  • desktop-notifications.command option, replaces notify.
  • desktop-notifications.inhibit-when-focused option, replaces notify-focus-inhibit.
  • ${category}, ${urgency}, ${expire-time}, ${replace-id}, ${icon} and ${action-argument} added to the desktop-notifications.command template.
  • desktop-notifications.command-action-argument option, defining how ${action-argument} (in desktop-notifications.command) should be expanded.
  • desktop-notifications.close option, defining what to execute when an application wants to close an existing notification (via an OSC-99 escape sequence).

Changed

  • All XTGETTCAP capabilities are now in the tigetstr() format:

    • parameterized string capabilities were previously "source encoded", meaning e.g. \E where not "decoded" into \x1b.
    • Control characters were also "source encoded", meaning they were returned as e.g. "^G" instead of \x07 (#1701).

    In other words, if, after this change, XTGETTCAP returns a string that is different compared to tigetstr(), then it is likely a bug in foot's implementation of XTGETTCAP.

  • If the cursor foreground and background colors are identical (for example, when cursor uses inverted colors and the cell's foreground and background are the same), the cursor will instead be rendered using the default foreground and background colors, inverted (#1761).

  • Mouse wheel events now generate BTN_WHEEL_BACK and BTN_WHEEL_FORWARD "button presses", instead of BTN_BACK and BTN_FORWARD. The default bindings have been updated, and scrollback-up-mouse, scrollback-down-mouse, font-increase and font-decrease now use the new button names.

    This change allow users to separate physical mouse buttons that also generates BTN_BACK and BTN_FORWARD, from wheel scrolling (#1763).

  • Replaced the old catppuccin theme with updated flavored themes pulled from catppuccin/foot

  • Mouse selections can now be started inside the margins (#1702).

Deprecated

  • notify option; replaced by desktop-notifications.command.
  • notify-focus-inhibit option; replaced by desktop-notifications.inhibit-when-focused.

Fixed

  • Crash when zooming in or out, with dpi-aware=yes, and the monitor's DPI is 0 (this is true for, for example, nested Wayland sessions, or in virtualized environments).
  • No error response for empty XTGETTCAP request (#1694).
  • Unicode-mode in one foot client affecting other clients, in foot server mode (#1717).
  • IME interfering in URL-mode (#1718).
  • OSC-52 reply interleaved with other data sent to the client (#1734).
  • XKB compose state being reset when foot receives a new keymap (#1744).
  • Regression: alpha changes through OSC-11 sequences not taking effect until window is resized.
  • VS15 being ignored (#1742).
  • VS16 being ignored for a subset of the valid VS16 sequences (#1742).
  • Crash in debug builds, when using OSC-12 to set the cursor color and foot config has not set any custom cursor colors (i.e. without OSC-12, inverted fg/bg would be used).
  • Wrong color used when drawing the unfocused, hollow cursor.
  • Encoding of BTN_BACK and BTN_FORWARD, when sending a mouse input escape sequence to the terminal application.

Contributors

  • abs3nt
  • Artturin
  • Craig Barnes
  • Jan Beich
  • Mariusz Bialonczyk
  • Nicolas Kolling Ribas

1.17.2

Changed

  • Notifications with invalid UTF-8 strings are now ignored.

Fixed

  • Crash when changing aspect ratio of a sixel, in the middle of the sixel data (this is unsupported in foot, but should of course not result in a crash).
  • Crash when printing double-width (or longer) characters to, or near, the last column, when auto-wrap (private mode 7) has been disabled.
  • Dynamically sized sixel being trimmed to nothing.
  • Flickering with dpi-aware=yes and window is unmapped/remapped (some compositors do this when window is minimized), in a multi-monitor setup with different monitor DPIs.

1.17.1

Added

  • cursor.unfocused-style=unchanged|hollow|none to foot.ini. The default is hollow (#1582).
  • New key binding: quit (#1475).

Fixed

  • Log-level not respected by syslog.
  • Regression: terminal shutting down when the PTY is closed by the client application, which may be earlier than when the client application exits (#1666).
  • When closing the window, send SIGHUP to the client application, before sending SIGTERM. The signal sequence is now SIGHUP, wait, SIGTERM, wait SIGKILL.
  • Crash when receiving a DECRQSS request with more than 2 bytes in the q parameter.

Contributors

  • Holger Weiß
  • izmyname
  • Marcin Puc
  • tunjan

1.17.0

Added

  • Support for opening an existing PTY, e.g. a VM console. (#1564)
  • Unicode input mode now accepts input from the numpad as well, numlock is ignored.
  • A new resize-by-cells option, enabled by default, allows the size of floating windows to be constrained to multiples of the cell size.
  • Support for custom (i.e. other than ctrl/shift/alt/super) modifiers in key bindings (#1348).
  • pipe-command-output key binding.
  • Support for OSC-176, "Set App-ID" (https://gist.github.com/delthas/d451e2cc1573bb2364839849c7117239).
  • Support for DECRQM queries with ANSI/ECMA-48 modes (CSI Ps $ p).
  • Rectangular edit functions: DECCARA, DECRARA, DECCRA, DECFRA and DECERA (#1633).
  • Rect capability to terminfo.
  • fe and fd (focus in/out enable/disable) capabilities to terminfo.
  • nel capability to terminfo.

Changed

  • config: ARGB color values now default to opaque, rather than transparent, when the alpha component has been left out (#1526).
  • The foot process now changes CWD to / after spawning the shell process. This ensures the terminal itself does not "lock" a directory; for example, preventing a mount point from being unmounted (#1528).
  • Kitty keyboard protocol: updated behavior of modifiers bits during modifier key events, to match the (new #6913) behavior in kitty >= 0.32.0 (#1561).
  • When changing font sizes or display scales in floating windows, the window will be resized as needed to preserve the same grid size.
  • smm now disables private mode 1036 ("send ESC when Meta modifies a key"), and enables private mode 1034 ("8-bit Meta mode"). rmm does the opposite (#1584).
  • Grid is now always centered in the window, when either fullscreened or maximized.
  • Ctrl+wheel up/down bound to font-increase and font-decrease respectively (in addition to the already existing default key bindings ctrl-+ and ctrl+-).
  • Use XRGB pixel format (instead of ARGB) when there is no transparency.
  • Prefer CSS xcursor names, and fallback to legacy X11 names.
  • Kitty keyboard protocol: use the XKB mode when retrieving locked modifiers, instead of the GTK mode. This fixes an issue where some key combinations (e.g. Shift+space) produces different results depending on the state of e.g. the NumLock key.
  • Kitty keyboard protocol: filter out all locked modifiers (as reported by XKB), rather than hardcoding it to CapsLock only, when determining whether a key combination produces text or not.
  • CSI-t queries now report pixel values unscaled, instead of scaled (#1643).
  • Sixel: text cursor is now placed on the last text row touched by the sixel, instead of the text row touched by the upper pixel of the last sixel (#chafa-192).
  • Sixel: trailing, fully transparent rows are now trimmed (#chafa-192).
  • 1004 (enable focus in/out events) removed from the XM terminfo capability. To enable focus in/out, use the fe and fd capabilities instead.
  • Tightened the regular expression in the rv terminfo capability.
  • Tightened the regular expression in the xr terminfo capability.
  • DECRQM queries for private mode 67 (DECBKM) now reply with mode value 4 ("permanently reset") instead of 0 ("not recognized").

Fixed

  • config: improved validation of color values.
  • config: double close of file descriptor, resulting in a chain of errors ultimately leading to a startup failure (#1531).
  • Crash when using a desktop scaling factor > 1, on compositors that implements neither the fractional-scale-v1, nor the cursor-shape-v1 Wayland protocols (#1573).
  • Crash in --server mode when one or more environment variables are set in [environment].
  • Environment variables normally set by foot lost with footclient -E,--client-environment (#1568).
  • XDG toplevel protocol violation, by trying to set a title that contains an invalid UTF-8 sequence (#1552).
  • Crash when erasing the scrollback, when scrollback history is exactly 0 rows. This happens when [scrollback].line = 0, and the window size (number of rows) is a power of two (i.e. 2, 4, 8, 16 etc) (#1610).
  • VS16 (variation selector 16 - emoji representation) should only affect emojis.
  • Pressing a modifier key while the kitty keyboard protocol is enabled no longer resets the viewport, or clears the selection.
  • Crash when failing to load an xcursor image (#1624).
  • Crash when resizing a dynamically sized sixel (no raster attributes), with a non-1:1 aspect ratio.
  • The default sixel color table is now initialized to the colors used by the VT340, instead of not being initialized at all (thus requiring the sixel escape sequence to explicitly set all colors it used).

Contributors

  • Alyssa Ross
  • Andrew J. Hesford
  • Artturin
  • Craig Barnes
  • delthas
  • eugenrh
  • Fazzi
  • Gregory Anders
  • Jan Palus
  • Leonardo Hernández Hernández
  • LmbMaxim
  • Matheus Afonso Martins Moreira
  • Sivecano
  • Tim Culverhouse
  • xnuk

1.16.2

Fixed

  • Last row and/or column of opaque sixels (not having a size that is a multiple of the cell size) being the wrong color (#1520).

1.16.1

Fixed

  • Foot not starting on linux kernels before 6.3 (#1514).
  • Cells underneath erased sixels not being repainted (#1515).

1.16.0

Added

  • Support for building with wayland-protocols as a subproject.
  • Mouse wheel scrolls can now be used in mouse-bindings (#1077).
  • New mouse bindings: scrollback-up-mouse and scrollback-down-mouse, bound to BTN_BACK and BTN_FORWARD respectively.
  • New key binding: select-quote. This key binding selects text between quote characters, and falls back to selecting the entire row (#1364).
  • Support for DECSET/DECRST/DECRQM 2027 (Grapheme cluster processing).
  • New search mode key bindings (along with their defaults) (#419):
    • extend-char (shift+right)
    • extend-line-down (shift+down)
    • extend-backward-char (shift+left)
    • extend-backward-to-word-boundary (ctrl+shift+left)
    • extend-backward-to-next-whitespace (none)
    • extend-line-up (shift+up)
    • scrollback-up-page (shift+page-up)
    • scrollback-up-half-page (none)
    • scrollback-up-line (none)
    • scrollback-down-page (shift+page-down)
    • scrollback-down-half-page (none)
    • scrollback-down-line (none)
  • Support for visual bell which flashes the terminal window. (#1337).

Changed

  • Minimum required version of wayland-protocols is now 1.32 (#1391).
  • foot-server.service systemd now checks for ConditionEnvironment=WAYLAND_DISPLAY for consistency with the socket unit (#1448)
  • Default key binding for select-row is now BTN_LEFT+4. However, in many cases, triple clicking will still be enough to select the entire row; see the new key binding select-quote (mapped to BTN_LEFT+3 by default) (#1364).
  • file:// prefix from URI's are no longer stripped when opened/activated (#1474).
  • XTGETTCAP with capabilities that are not properly hex encoded will be ignored, instead of echo:ed back to the TTY in an error response.
  • Command line configuration overrides are now applied even if the configuration file does not exist or can't be parsed. (#1495).
  • Wayland surface damage is now more fine-grained. This should result in lower latencies in many use cases, especially on high DPI monitors.

Removed

  • utempter config option (was deprecated in 1.15.0).

Fixed

  • Race condition for systemd units start in GNOME and KDE (#1436).
  • One frame being rendered at the wrong scale after being hidden by another opaque, maximized window (#1464).
  • Double-width characters, and grapheme clusters breaking URL auto-detection (#1465).
  • Crash when XDG_ACTIVATION_TOKEN is set, but compositor does not support XDG activation (#1493).
  • Crash when compositor calls fractional_scale::preferred_scale() when there are no monitors (for example, after a monitor has been turned off and then back on again) (#1498).
  • Transparency in margins (padding) not being disabled in fullscreen mode (#1503).
  • Crash when a scrollback search match is in the last column.
  • Scrollback search: grapheme clusters not matching correctly.
  • Wrong baseline offset for some fonts (#1511).

Contributors

  • 6t8k
  • Alyssa Ross
  • CismonX
  • Max Gautier
  • raggedmyth
  • Raimund Sacherer
  • Sertonix

1.15.3

Fixed

  • -f,--font command line option not affecting csd.font (if unset).
  • Vertical alignment in URL jump labels, and the scrollback position indicator. The fix in 1.15.2 was incorrect, and was reverted in the last minute. But we forgot to remove the entry from the changelog (#1430).

1.15.2

Added

  • [tweak].bold-text-in-bright-amount option (#1434).
  • -Dterminfo-base-name meson option, allowing you to name the terminfo files to something other than -Ddefault-terminfo. Use case: have foot default to using the terminfo from ncurses (foot, foot-direct), while still packaging foot's terminfo files, but under a different name (e.g. foot-extra, foot-extra-direct).

Fixed

  • Crash when copying text that contains invalid UTF-8 (#1423).
  • Wrong font size after suspending the monitor (#1431).
  • Vertical alignment in URL jump labels, and the scrollback position indicator (#1430).
  • Regression: line- and box drawing characters not covering the full height of the line, when a custom line-height is being used (#1430).
  • Crash when compositor does not implement the viewporter interface (#1444).
  • CSD rendering with fractional scaling (#1441).
  • Regression: crash with certain combinations of --window-size-chars=NxM and desktop scaling factors (#1446).

1.15.1

Changed

  • When window is mapped, use metadata (DPI, scaling factor, subpixel configuration) from the monitor we were most recently mapped on, instead of the one least recently.
  • Starlight theme (the default theme) updated to V4
  • Background transparency (alpha) is now disabled in fullscreened windows (#1416).
  • Foot server systemd units now use the standard graphical-session.target (#1281).
  • If $XDG_RUNTIME_DIR/foot-$WAYLAND_DISPLAY.sock does not exist, footclient now tries $XDG_RUNTIME_DIR/foot.sock, then /tmp/foot.sock, even if $WAYLAND_DISPLAY and/or $XDG_RUNTIME_DIR are defined (#1281).
  • Font baseline calculation: try to center the text within the line, instead of anchoring it at the top (#1302).

Fixed

  • Use appropriate rounding when applying fractional scales.
  • Xcursor not being scaled correctly on fractional-scale-v1 capable compositors.
  • dpi-aware=yes being broken on fractional-scale-v1 capable compositors (and when a fractional scaling factor is being used) (#1404).
  • Initial font size being wrong on fractional-scale-v1 capable compositors, with multiple monitors with different scaling factors connected (#1404).
  • Crash when pointer capability is removed from a seat, on compositors without cursor-shape-v1 support (#1411).
  • Crash on exit, if the mouse is hovering over the foot window (does not happen on all compositors)
  • Visual glitches when CSD titlebar is transparent.

Contributors

  • Ayush Agarwal
  • CismonX
  • Max Gautier
  • Ronan Pigott
  • xdavidwu

1.15.0

Added

  • VT: implemented XTQMODKEYS query (CSI ? Pp m).
  • Meson option utmp-backend=none|libutempter|ulog|auto. The default is auto, which will select libutempter on Linux, ulog on FreeBSD, and none for all others.
  • Sixel aspect ratio.
  • Support for the new fractional-scale-v1 Wayland protocol. This brings true fractional scaling to Wayland in general, and with this release, to foot.
  • Support for the new cursor-shape-v1 Wayland protocol, i.e. server side cursor shapes (#1379).
  • Support for touchscreen input (#517).
  • csd.double-click-to-maximize option to foot.ini. Defaults to yes (#1293).

Changed

  • Default color theme is now starlight (#1321).
  • Minimum required meson version is now 0.59 (#1371).
  • Control+Shift+u is now bound to unicode-input instead of show-urls-launch, to follow the convention established in GTK and Qt (#1183).
  • show-urls-launch now bound to Control+Shift+o (#1183).
  • Kitty keyboard protocol: F3 is now encoded as CSI 13~ instead of CSI R. The kitty keyboard protocol originally allowed F3 to be encoded as CSI R, but this was removed from the specification since CSI R conflicts with the "Cursor Position Report".
  • [main].utempter renamed to [main].utmp-helper. The old option name is still recognized, but will log a deprecation warning.
  • Meson option default-utempter-path renamed to utmp-default-helper-path.
  • Opaque sixels now retain the background opacity (when current background color is the default background color) (#1360).
  • Text cursor's vertical position after emitting a sixel, when sixel scrolling is enabled (the default) has been updated to match XTerm's, and the VT382's behavior: the cursor is positioned on the last sixel row, rather than after it. This allows printing sixels on the last row without scrolling up, but also means applications may have to explicitly emit a newline to ensure the sixel is visible. For example, cat:ing a sixel in the shell will typically result in the last row not being visible, unless a newline is explicitly added.
  • Default sixel aspect ratio is now 2:1 instead of 1:1.
  • Sixel images are no longer cropped to the last non-transparent row.
  • Sixel images are now re-scaled when the font size is changed (#1383).
  • dpi-aware now defaults to no, and the auto value has been removed.
  • When using custom cursor colors (cursor.color is set in foot.ini), the cursor is no longer inverted when the cell is selected, or when the cell has the reverse (SGR 7) attribute set (#1347).

Deprecated

  • [main].utempter option.

Removed

  • auto value for the dpi-aware option.

Fixed

  • Incorrect icon in dock and window switcher on Gnome (#1317)
  • Crash when scrolling after resizing the window with non-zero scrolling regions.
  • XTMODKEYS state not being reset on a terminal reset.
  • In Gnome dock foot always groups under "foot client". Change instances of footclient and foot to appear as "foot client" and "foot" respectively. (#1355).
  • Glitchy rendering when alpha (transparency) is changed between opaque and non-opaque at runtime (using OSC-11).
  • Regression: crash when resizing the window when resize-delay-ms > 0 (#1377).
  • Crash when scrolling up while running something that generates a lot of output (for example, yes) (#1380).
  • Default key binding for URL mode conflicting with Unicode input on some DEs; show-urls-launched is now mapped to Control+Shift+o by default, instead of Control+Shift+u (#1183).

Contributors

  • Antoine Beaupré
  • CismonX
  • Craig Barnes
  • Dan Bungert
  • jdevdevdev
  • Kyle Gunger
  • locture
  • Phillip Susi
  • sewn
  • ShugarSkull
  • Vivian Szczepanski
  • Vladimir Bauer
  • wout
  • CosmicToast

1.14.0

Added

  • Support for adjusting the thickness of regular underlines (#1136).
  • Support (optional) for utmp logging with libutempter.
  • kxIN and kxOUT (focus in/out events) to terminfo.
  • name capability to XTGETTCAP.
  • String values in foot.ini may now be quoted. This can be used to set a value to the empty string, for example.
  • Environment variables can now be unset, by setting [environment].<variable>="" (quotes are required) (#1225).
  • font-size-adjustment=N[px] option, letting you configure how much to increment/decrement the font size when zooming in or out (#1188).
  • Bracketed paste terminfo entries (BD, BE, PE and PS, added to ncurses in 2022-12-24). Vim makes use of these.
  • "Report version" terminfo entries (XR/xr).
  • "Report DA2" terminfo entries (RV/rv).
  • XF terminfo capability (focus in/out events available).
  • $TERM_PROGRAM and $TERM_PROGRAM_VERSION environment variables unset in the slave process.

Changed

  • Default color theme from a variant of the Zenburn theme, to a variant of the Solarized dark theme.
  • Default pad from 2x2 to 0x0 (i.e. no padding at all).
  • Current working directory (as set by OSC-7) is now passed to the program executed by the pipe-* key bindings (#1166).
  • DECRPM replies (to DECRQM queries) now report a value of 4 ("permanently reset") instead of 2 ("reset") for DEC private modes that are known but unsupported.
  • Set PWD environment variable in the slave process (#1179).
  • DPI is now forced to 96 when found to be unreasonably high.
  • Set default log level to warning (#1215).
  • Default grapheme-width-method from wcswidth to double-width.
  • When determining initial font size, do FontConfig config substitution if the user-provided font pattern has no {pixel}size option (#1287).
  • DECRST of DECCOLM and DECSCLM removed from terminfo.

Fixed

  • Crash in foot --server on key press, after another footclient has terminated very early (for example, by trying to launch a non-existing shell/client).
  • Glitchy rendering when scrolling in the scrollback, on compositors that does not allow Wayland buffer reuse (e.g. KDE/plasma) (#1173)
  • Scrollback search matches not being highlighted correctly, on compositors that does not allow Wayland buffer reuse (e.g. KDE/plasma).
  • Nanosecs "overflow" when calculating timeout value for resize-delay-ms option.
  • Missing backslash in ST terminator in escape sequences in the built-in terminfo (accessed via XTGETTCAP).
  • Crash when interactively resizing the window with a very large scrollback.
  • Crash when a sixel image exceeds the current sixel max height.
  • Crash after reverse-scrolling (CSI Ps T) in the 'normal' (non-alternate) screen (#1190).
  • Background transparency being applied to the text "behind" the cursor. Only applies to block cursor using inversed fg/bg colors. (#1205).
  • Crash when monitor's physical size is "too small" (#1209).
  • Line-height adjustment when incrementing/decrementing the font size with a user-set line-height (#1218).
  • Scaling factor not being correctly applied when converting pt-or-px config values (e.g. letter offsets, line height etc).
  • Selection being stuck visually when IL and DL.
  • URL underlines sometimes still being visible after exiting URL mode.
  • Text-bindings, and pipe-* bindings, with multiple key mappings causing a crash (double-free) on exit (#1259).
  • Double-width glyphs glitching when surrounded by glyphs overflowing into the double-width glyph (#1256).
  • Wayland protocol violation when ack:ing a configure event for an unmapped surface (#1249).
  • xdg_toplevel::set_min_size() not being called.
  • Key bindings with consumed modifiers masking other key bindings (#1280).
  • Multi-character compose sequences with the kitty keyboard protocol (#1288).
  • Crash when application output scrolls very fast, e.g. yes (#1305).
  • Crash when application scrolls many lines (> ~2³¹).
  • DECCOLM erasing the screen (#1265).

Contributors

  • Alexey Sakovets
  • Andrea Pappacoda
  • Antoine Beaupré
  • argosatcore
  • Craig Barnes
  • EuCaue
  • Grigory Kirillov
  • Harri Nieminen
  • Hugo Osvaldo Barrera
  • jaroeichler
  • Joakim Nohlgård
  • Nick Hastings
  • Soren A D
  • Torsten Trautwein
  • Vladimír Magyar
  • woojiq
  • Yorick Peterse

1.13.1

Changed

  • Window is now dimmed while in Unicode input mode.

Fixed

  • Compiling against wayland-protocols < 1.25
  • Crash on buggy compositors (GNOME) that sometimes send pointer-enter events with a NULL surface. Foot now ignores these events, and the subsequent motion and leave events.
  • Regression: "random" selected empty cells being highlighted as selected when they should not.
  • Crash when either resizing the terminal window, or scrolling in the scrollback history (#1074)
  • OSC-8 URLs with matching IDs, but mismatching URIs being incorrectly connected.

1.13.0

Added

  • XDG activation support when opening URLs (#1058).
  • -Dsystemd-units-dir=<path> meson command line option.
  • Support for custom environment variables in foot.ini (#1070).
  • Support for jumping to previous/next prompt (requires shell integration). By default bound to ctrl+shift+z and ctrl+shift+x respectively (#30).
  • colors.search-box-no-match and colors.search-box-match options to foot.ini (#1112).
  • Very basic Unicode input mode via the new key-bindings.unicode-input and search-bindings.unicode-input key bindings. Note that there is no visual feedback, as the preferred way of entering Unicode characters is with an IME (#1116).
  • Support for xdg_toplevel.wm_capabilities, to adapt the client-side decoration buttons to the compositor capabilities (#1061).

Changed

  • Use $HOME instead of getpwuid() to retrieve the user's home directory when searching for foot.ini.
  • HT, VT and FF are no longer stripped when pasting in non-bracketed mode (#1084).
  • NUL is now stripped when pasting in non-bracketed mode (#1084).
  • alt+escape now emits \E\E instead of a CSI 27 sequence (#1105).

Fixed

  • Graphical corruption when viewport is at the top of the scrollback, and the output is scrolling.
  • Improved text reflow of logical lines with trailing empty cells (#1055)
  • IME focus is now tracked independently from keyboard focus.
  • Workaround for buggy compositors (e.g. some versions of GNOME) allowing drag-and-drops even though foot has reported it does not support the offered mime-types (#1092).
  • Keyboard enter/leave events being ignored if there is no keymap (#1097).
  • Crash when application emitted an invalid CSI 38;5;<idx>m, CSI 38:5:<idx>m, CSI 48;5;<idx>m or CSI 48:5:<idx>m sequence (#1111).
  • Certain dead-key combinations resulting in different escape sequences compared to kitty, when the kitty keyboard protocol is used (#1120).
  • Search matches ending with a double-width character not being highlighted correctly.
  • Selection not being cancelled correctly when scrolled out.
  • Extending a multi-page selection behaving inconsistently.
  • Poor performance when making very large selections (#1114).
  • Bogus error message when using systemd socket activation for server mode (#1107)
  • Empty line at the bottom after a window resize (#1108).

Contributors

  • Craig Barnes
  • Lorenz
  • Max Gautier
  • Simon Ser
  • Stefan Prosiegel

1.12.1

Added

  • Workaround for Sway bug #6960: scrollback search and the OSC-555 ("flash") escape sequence leaves dimmed (search) and yellow (flash) artifacts (#1046).
  • Control+Shift+v and XF86Paste have been added to the default set of key bindings that paste from the clipboard into the scrollback search buffer. This is in addition to the pre-existing Control+v and Control+y bindings.

Changed

  • Scrollback search's extend-to-word-boundary no longer stops at space-to-word boundaries, making selection extension feel more natural.

Fixed

  • build: missing symbols when linking the pgo helper binary.
  • UI not refreshing when pasting something into the scrollback search box, that does not result in a grid update (for example, when the search criteria did not result in any matches) (#1040).
  • foot freezing in scrollback search mode, using 100% CPU (#1036, #1047).
  • Crash when extending a selection to the next word boundary in scrollback search mode (#1036).
  • Scrollback search mode not always highlighting all matches correctly.
  • Sixel options not being reset on hard resets (\Ec)

1.12.0

Added

  • OSC-22 - set xcursor pointer.
  • Add "xterm" as fallback cursor where "text" is not available.
  • [key-bindings].scrollback-home|end options.
  • Socket activation for foot --server and accompanying systemd unit files
  • Support for re-mapping input, i.e. mapping input to custom escape sequences (#325).
  • Support for DECNKM, which allows setting/saving/restoring/querying the keypad mode.
  • Sixel support can be disabled by setting [tweak].sixel=no (#950).
  • footclient: -E,--client-environment command line option. When used, the child process in the new terminal instance inherits the environment from the footclient process instead of the server's (#1004).
  • [csd].hide-when-maximized=yes|no option (#1019).
  • Scrollback search mode now highlights all matches.
  • [key-binding].show-urls-persistent action. This key binding action is similar to show-urls-launch, but does not automatically exit URL mode after activating an URL (#964).
  • Support for CSI > 4 n, disable modifyOtherKeys. Note that since foot only supports level 1 and 2 (and not level 0), this sequence does not disable modifyOtherKeys completely, but simply reverts it back to level 1 (the default).
  • -Dtests=false|true meson command line option. When disabled, test binaries will neither be built, nor will ninja test attempt to execute them. Enabled by default (#919).

Changed

  • Minimum required meson version is now 0.58.
  • Mouse selections are now finalized when the window is resized (#922).
  • OSC-4 and OSC-11 replies now uses four digits instead of 2 (#971).
  • \r is no longer translated to \n when pasting clipboard data (#980).
  • Use circles for rendering light arc box-drawing characters (#988).
  • Example configuration is now installed to ${sysconfdir}/xdg/foot/foot.ini, typically resolving to /etc/xdg/foot/foot.ini (#1001).

Removed

  • DECSET mode 27127 (which was first added in release 1.6.0). The kitty keyboard protocol (added in release 1.10.3) can be used to similar effect.

Fixed

  • Build: missing wayland_client dependency in test-config (#918).
  • "(null)" being logged as font-name (for some fonts) when warning about a non-monospaced primary font.
  • Rare crash when the window is resized while a mouse selection is ongoing (#922).
  • Large selections crossing the scrollback wrap-around (#924).
  • Crash in pipe-scrollback (#926).
  • Exit code being 0 when a foot server with no open windows terminate due to e.g. a Wayland connection failure (#943).
  • Key binding collisions not detected for bindings specified as option overrides on the command line.
  • Crash when seat has no keyboard (#963).
  • Key presses with e.g. AltGr triggering key combinations with the base symbol (#983).
  • Underline cursor sometimes being positioned too low, either making it look thinner than what it should be, or being completely invisible (#1005).
  • Fallback to /etc/xdg if XDG_CONFIG_DIRS is unset (#1008).
  • Improved compatibility with XTerm when modifyOtherKeys=2 (#1009).
  • Window geometry when CSDs are enabled and CSD border width set to a non-zero value. This fixes window snapping in e.g. GNOME.
  • Window size "jumping" when starting an interactive resize when CSDs are enabled, and CSD border width set to a non-zero value.
  • Key binding overrides on the command line having no effect with footclient instances (#931).
  • Search prev/next not updating the selection correctly when the previous and new match overlaps.
  • Various minor fixes to scrollback search, and how it finds the next/prev match.

Contributors

  • Ashish SHUKLA
  • Craig Barnes
  • Enes Hecan
  • Johannes Altmanninger
  • L3MON4D3
  • Leonardo Neumann
  • Mariusz Bialonczyk
  • Max Gautier
  • Merlin Büge
  • jvoisin
  • merkix

1.11.0

Added

  • [mouse-bindings].selection-override-modifiers option, specifying which modifiers to hold to override mouse grabs by client applications and force selection instead.
  • irc:// and ircs:// to the default set of protocols recognized when auto-detecting URLs.
  • SGR-Pixels (1016) mouse extended coordinates is now supported (#762).
  • XTGETTCAP - builtin terminfo. See README.md::XTGETTCAP for details (#846).
  • DECRQSS - Request Selection or Setting (#798). Implemented settings are:
    • DECSTBM - Set Top and Bottom Margins
    • SGR - Set Graphic Rendition
    • DECSCUSR - Set Cursor Style
  • Support for searching for the last searched-for string in scrollback search (search for next/prev match with an empty search string).

Changed

  • PaperColorDark and PaperColorLight themes renamed to paper-color-dark and paper-color-light, for consistency with other theme names.
  • [scrollback].multiplier is now applied in "alternate scroll" mode, where scroll events are translated to fake arrow key presses on the alt screen (#859).
  • The width of the block cursor's outline in an unfocused window is now scaled by the output scaling factor ("desktop scaling"). Previously, it was always 1px.
  • Foot will now try to change the locale to either "C.UTF-8" or "en_US.UTF-8" if started with a non-UTF8 locale. If this fails, foot will start, but only to display a window with an error (user's shell is not executed).
  • gettimeofday() has been replaced with clock_gettime(), due to it being marked as obsolete by POSIX.
  • alt+tab now emits ESC \t instead of CSI 27;3;9~ (#900).
  • File pasted, or dropped, on the alt screen is no longer quoted (#379).
  • Line-based selections now include a trailing newline when copied (#869).
  • Foot now clears the signal mask and resets all signal handlers to their default handlers at startup (#854).
  • Copy and Paste keycodes are supported by default for the clipboard. These are useful for keyboards with custom firmware like QMK to enable global copy/paste shortcuts that work inside and outside the terminal (https://codeberg.org/dnkl/foot/pulls/894).

Removed

Fixed

  • Font size adjustment ("zooming") when font is configured with a pixelsize, and dpi-aware=no (#842).
  • Key presses triggering keyboard layout switches also emitting CSI codes in the Kitty keyboard protocol.
  • Assertion in shm.c:buffer_release() (#844).
  • Crash when setting a key- or mouse binding to the empty string (#851).
  • Crash when maximizing the window and [csd].size=1 (#857).
  • OSC-8 URIs not getting overwritten (erased) by double-width characters (e.g. emojis).
  • Rendering of CSD borders when csd.border-width > 0 and desktop scaling has been enabled.
  • Failure to launch when exec(3):ed with an empty argv.
  • Pasting from the primary clipboard (mouse middle clicking) did not reset the scrollback view to the bottom.
  • Wrong mouse binding triggered when doing two mouse selections in very quick (< 300ms) succession (#883).
  • Bash completion giving an error when completing a list of short options
  • Sixel: large image resizes (triggered by e.g. large repeat counts in DECGRI) are now truncated instead of ignored.
  • Sixel: a repeat count of 0 in DECGRI now emits a single sixel.
  • LIGHT ARC box drawing characters incorrectly rendered platforms (#914).

Contributors

  • lamonte
  • Érico Nogueira
  • feeptr
  • Felix Lechner
  • grtcdr
  • Mark Stosberg
  • Nicolai Dagestad
  • Oğuz Ersen
  • Pranjal Kole
  • Simon Ser

1.10.3

Added

Fixed

  • Crash when bitmap fonts are scaled down to very small font sizes (#830).
  • Crash when overwriting/erasing an OSC-8 URL.

1.10.2

Added

Fixed

  • An ongoing mouse selection is now finalized on a pointer leave event (for example by switching workspace while doing a mouse selection).
  • OSC-8 URIs in the last column
  • OSC-8 URIs sometimes being applied to too many, and seemingly unrelated cells (#816).
  • OSC-8 URIs incorrectly being dropped when resizing the terminal window with the alternate screen active.
  • CSD border not being dimmed when window is not focused.
  • Visual corruption with large CSD borders (#823).
  • Mouse cursor shape sometimes not being updated correctly.
  • Color palette changes (via OSC 4/104) no longer affect RGB colors (#678).

Contributors

  • Jonas Ådahl

1.10.1

Added

  • -Dthemes=false|true meson command line option. When disabled, example theme files are not installed.
  • XDG desktop file for footclient.

Fixed

  • Regression: letter-spacing resulting in a "not a valid option" error (#795).
  • Regression: bad section name in configuration error messages.
  • Regression: pipe-* key bindings not being parsed correctly, resulting in invalid error messages (#809).
  • OSC-8 data not being cleared when cell is overwritten (#804, #801).

Contributors

  • Arnavion
  • Craig Barnes
  • Soc Virnyl Silab Estela
  • Xiretza

1.10.0

Added

  • notify-focus-inhibit boolean option, which can be used to control whether desktop notifications should be inhibited when the terminal has keyboard focus
  • [colors].scrollback-indicator color-pair option, which specifies foreground and background colors for the scrollback indicator.
  • [key-bindings].noop action. Key combinations assigned to this action will not be sent to the application (#765).
  • Color schemes are now installed to ${datadir}/foot/themes.
  • [csd].border-width and [csd].border-color, allowing you to configure the width and color of the CSD border.
  • Support for XTMODKEYS with Pp=4 and Pv=2 (modifyOtherKeys=2).
  • [colors].dim0-7 options, allowing you to configure custom "dim" colors (#776).

Changed

  • [tweak].grapheme-shaping is now enabled by default when both foot itself, and fcft has been compiled with support for it.
  • Default value of [tweak].grapheme-width-method changed from double-width to wcswidth.
  • INSTALL.md: --override tweak.grapheme-shaping=no added to PGO command line.
  • Foot now terminates if there are no available seats - for example, due to the compositor not implementing a recent enough version of the wl_seat interface (#779).
  • Boolean options in foot.ini are now limited to "yes|true|on|1|no|false|off|0", Previously, anything that did not match "yes|true|on", or a number greater than 0, was treated as "false".
  • [scrollback].multiplier is no longer applied when the alternate screen is in use (#787).

Removed

  • The bundled PKGBUILD.
  • Deprecated bell option (replaced with [bell] section in 1.8.0).
  • Deprecated url-launch, jump-label-letters and osc8-underline options (moved to a dedicated [url] section in 1.8.0)

Fixed

  • 'Sticky' modifiers in input handling; when determining modifier state, foot was looking at depressed modifiers, not effective modifiers, like it should.
  • Fix crashes after enabling CSD at runtime when csd.size is 0.
  • Convert \r to \n when reading clipboard data (#752).
  • Clipboard occasionally ceasing to work, until window has been re-focused (#753).
  • Don't propagate window title updates to the Wayland compositor unless the new title is different from the old title.

Contributors

  • armin
  • Craig Barnes
  • Daniel Martí
  • feeptr
  • Mitja Horvat
  • Ronan Pigott
  • Stanislav Ochotnický

1.9.2

Changed

  • PGO helper scripts no longer set LC_CTYPE=en_US.UTF-8. But, note that "full" PGO builds still require a UTF-8 locale; you need to set one manually in your build script (#728).

1.9.1

Added

  • Warn when it appears the primary font is not monospaced. Can be disabled by setting [tweak].font-monospace-warn=no (#704).
  • PGO build scripts, in the pgo directory. See INSTALL.md - Performance optimized, PGO, for details (#701).
  • Braille characters (U+2800 - U+28FF) are now rendered by foot itself (#702).
  • -e command-line option. This option is simply ignored, to appease program launchers that blindly pass -e to any terminal emulator (#184).

Changed

  • -Ddefault-terminfo is now also applied to the generated terminfo definitions when -Dterminfo=enabled.
  • -Dcustom-terminfo-install-location no longer accepts no as a special value, to disable exporting TERMINFO. To achieve the same result, simply don't set it at all. If it is set, TERMINFO is still exported, like before.
  • The default install location for the terminfo definitions have been changed back to ${datadir}/terminfo.
  • dpi-aware=auto: fonts are now scaled using the monitor's DPI only when all monitors have a scaling factor of one (#714).
  • fcft >= 3.0.0 in now required.

Fixed

  • Added workaround for GNOME bug where multiple button press events (for the same button) is sent to the CSDs without any release or leave events in between (#709).
  • Line-wise selection not taking soft line-wrapping into account (#726).

Contributors

1.9.0

Added

  • Window title in the CSDs (#638).
  • -Ddocs=disabled|enabled|auto meson command line option.
  • Support for ~-expansion in the include directive (#659).
  • Unicode 13 characters U+1FB3C - U+1FB6F, U+1FB9A and U+1FB9B to list of box drawing characters rendered by foot itself (rather than using font glyphs) (#474).
  • XM+xm to terminfo.
  • Mouse buttons 6/7 (mouse wheel left/right).
  • url.uri-characters option to foot.ini (#654).

Changed

  • Terminfo files can now co-exist with the foot terminfo files from ncurses. See INSTALL.md for more information (#671).
  • bold-text-in-bright=palette-based now only brightens colors from palette
  • Raised grace period between closing the PTY and sending SIGKILL (when terminating the client application) from 4 to 60 seconds.
  • When terminating the client application, foot now sends SIGTERM immediately after closing the PTY, instead of waiting 2 seconds.
  • Foot now sends SIGTERM/SIGKILL to the client application's process group, instead of just to the client application's process.
  • kmous terminfo capability from \E[M to \E[<.
  • pt-or-px values (letter-spacing, etc) and the line thickness (tweak.box-drawing-base-thickness) in box drawing characters are now translated to pixel values using the monitor's scaling factor when dpi-aware=no, or dpi-aware=auto and the scaling factor is larger than 1 (#680).
  • Spawning a new terminal with a working directory that does not exist is no longer a fatal error.

Removed

  • km/smm/rmm from terminfo; foot prefixes Alt-key combinations with ESC, and not by setting the 8:th "meta" bit, regardless of smm/rmm. While this can be disabled by, resetting private mode 1036, the terminfo should reflect the default behavior (#670).
  • Keypad application mode keys from terminfo; enabling the keypad application mode is not enough to make foot emit these sequences - you also need to disable private mode 1035 (#670).

Fixed

  • Rendering into the right margin area with tweak.overflowing-glyphs enabled.
  • PGO builds with clang (#642).
  • Crash in scrollback search mode when selection has been canceled due to terminal content updates (#644).
  • Foot process not terminating when the Wayland connection is broken (#651).
  • Output scale being zero on compositors that does not advertise a scaling factor.
  • Slow-to-terminate client applications causing other footclient instances to freeze when closing a footclient window.
  • Underlying cell content showing through in the left-most column of sixels.
  • cursor.blink not working in GNOME (#686).
  • Blinking cursor stops blinking, or becoming invisible, when switching focus from, and then back to a terminal window on GNOME (#686).

Contributors

1.8.2

Added

  • locked-title=no|yes to foot.ini (#386).
  • tweak.overflowing-glyphs option, which can be enabled to fix rendering issues with glyphs of any width that appear cut-off (#592).

Changed

  • Non-empty lines are now considered to have a hard linebreak, unless an actual word-wrap is inserted.
  • Setting DECSDM now disables sixel scrolling, while resetting it enables scrolling (#631).

Removed

  • The tweak.allow-overflowing-double-width-glyphs and tweak.pua-double-width options (which have been superseded by tweak.overflowing-glyphs).

Fixed

  • FD exhaustion when repeatedly entering/exiting URL mode with many URLs.
  • Double free of URL while removing duplicated and/or overlapping URLs in URL mode (#627).
  • Crash when an unclosed OSC-8 URL ran into un-allocated scrollback rows.
  • Some box-drawing characters were rendered incorrectly on big-endian architectures.
  • Crash when resizing the window to the smallest possible size while scrollback search is active.
  • Scrollback indicator being incorrectly rendered when window size is very small.
  • Reduced memory usage in URL mode.
  • Crash when the E3 escape (\E[3J) was executed, and there was a selection, or sixel image, in the scrollback (#633).

Contributors

1.8.1

Added

  • --log-level=none command-line option.
  • Tc, setrgbf and setrgbb capabilities in foot and foot-direct terminfo entries. This should make 24-bit RGB colors work in tmux and neovim, without the need for config hacks or detection heuristics (#615).

Changed

  • Grapheme cluster width is now limited to two cells by default. This may cause cursor synchronization issues with many applications. You can set [tweak].grapheme-width-method=wcswidth to revert to the behavior in foot-1.8.0.

Fixed

  • Grapheme cluster state being reset between codepoints.
  • Regression: custom URL key bindings not working (#614).

Contributors

1.8.0

Grapheme shaping

This release adds experimental, opt-in support for grapheme cluster segmentation and grapheme shaping.

(note: several of the examples below may not render correctly in your browser, viewer or editor).

Grapheme cluster segmentation is the art of splitting up text into grapheme clusters, where a cluster may consist of more than one Unicode codepoint. For example, 🙂 is a single codepoint, while 👩🏽‍🚀 consists of 4 codepoints (Woman + Medium skin tone + Zero width joiner + Rocket). The goal is to cluster codepoints belonging to the same grapheme in the same cell in the terminal.

Previous versions of foot implemented a simple grapheme cluster segmentation technique that only handled zero-width codepoints. This allowed us to cluster combining characters, like q́ (q + COMBINING ACUTE ACCENT).

Once we have a grapheme cluster, we need to shape it.

Combining characters are simple: they are typically rendered as multiple glyphs layered on top of each other. This is why previous versions of foot got away with it without any actual text shaping support.

Beyond that, support from the font library is needed. Foot now depends on fcft-2.4, which added support for grapheme and text shaping. When rendering a cell, we ask the font library: give us the glyph(s) for this sequence of codepoints.

Fancy emoji sequences aside, using libutf8proc for grapheme cluster segmentation means improved correctness.

For full support, the following is required:

  • fcft compiled with HarfBuzz support
  • foot compiled with libutf8proc support
  • tweak.grapheme-shaping=yes in foot.ini

If tweak.grapheme-shaping has not been enabled, foot will neither use libutf8proc to do grapheme cluster segmentation, nor will it use fcft's grapheme shaping capabilities to shape combining characters.

This feature is experimental mostly due to the "wcwidth" problem; how many cells should foot allocate for a grapheme cluster? While the answer may seem simple, the problem is that, whatever the answer is, the client application must come up with the same answer. Otherwise we get cursor synchronization issues.

In this release, foot simply adds together the wcwidth() of all codepoints in the grapheme cluster. This is equivalent to running wcswidth() on the entire cluster. This is likely to change in the future.

Finally, note that grapheme shaping is not the same thing as text (or text run) shaping. In this version, foot only shapes individual graphemes, not entire text runs. That means e.g. ligatures are not supported.

Added

  • Support for DECSET/DECRST 2026, as an alternative to the existing "synchronized updates" DCS sequences (#459).
  • cursor.beam-thickness option to foot.ini (#464).
  • cursor.underline-thickness option to foot.ini (#524).
  • Unicode 13 characters U+1FB70 - U+1FB8B to list of box drawing characters rendered by foot itself (rather than using font glyphs) (#471).
  • Dedicated [bell] section to config, supporting multiple actions and a new command action to run an arbitrary command. (https://codeberg.org/dnkl/foot/pulls/483)
  • Dedicated [url] section to config.
  • [url].protocols option to foot.ini (#531).
  • Support for setting the full 256 color palette in foot.ini (#489)
  • XDG activation support, will be used by [bell].urgent when available (falling back to coloring the window margins red when unavailable) (#487).
  • ctrl+c as a default key binding; to cancel search/url mode.
  • ${window-title} to notify.
  • Support for including files in foot.ini (#555).
  • ENVIRONMENT section in foot(1) and footclient(1) man pages (#556).
  • tweak.pua-double-width option to foot.ini, letting you force Private Usage Area codepoints to be treated as double-width characters.
  • OSC 9 desktop notifications (iTerm2 compatible).
  • Support for LS2 and LS3 (locking shift) escape sequences (#581).
  • Support for overriding configuration options on the command line (#554, #600).
  • underline-offset option to foot.ini (#490).
  • csd.button-color option to foot.ini.
  • -Dterminfo-install-location=disabled|<custom-path> meson command line option (#569).

Changed

  • fcft: required version bumped from 2.3.x to 2.4.x.
  • generate-alt-random-writes.py --sixel: width and height of emitted sixels has been adjusted.
  • Concealed text (\E[8m) is now revealed when highlighted.
  • The background color of highlighted text is now adjusted, when the foreground and background colors are the same, making the highlighted text legible (#455).
  • cursor.style=bar to cursor.style=beam. bar remains a recognized value, but will eventually be deprecated, and removed.
  • Point values in line-height, letter-spacing, horizontal-letter-offset and vertical-letter-offset are now rounded, not truncated, when translated to pixel values.
  • Foot's exit code is now -26/230 when foot itself failed to launch (due to invalid command line options, client application/shell not found etc). Footclient's exit code is -36/220 when it itself fails to launch (e.g. bad command line option) and -26/230 when the foot server failed to instantiate a new window (#466).
  • Background alpha no longer applied to palette or RGB colors that matches the background color.
  • Improved performance on compositors that does not release shm buffers immediately, e.g. KWin (#478).
  • ctrl + w (extend-to-word-boundary) can now be used across lines (#421).
  • Ignore auto-detected URLs that overlap with OSC-8 URLs.
  • Default value for the notify option to use -a ${app-id} -i ${app-id} ... instead of -a foot -i foot ....
  • scrollback-*+pipe-scrollback key bindings are now passed through to the client application when the alt screen is active (#573).
  • Reverse video (\E[?5h) now only swaps the default foreground and background colors. Cells with explicit foreground and/or background colors remain unchanged.
  • Tabs (\t) are now preserved when the window is resized, and when copying text (#508).
  • Writing a sixel on top of another sixel no longer erases the first sixel, but the two are instead blended (#562).
  • Running foot without a configuration file is no longer an error; it has been demoted to a warning, and is no longer presented as a notification in the terminal window, but only logged on stderr.

Deprecated

  • bell option in foot.ini; set actions in the [bell] section instead.
  • url-launch option in foot.ini; use launch in the [url] section instead.
  • jump-label-letters option in foot.ini; use label-letters in the [url] section instead.
  • osc8-underline option in foot.ini; use osc8-underline in the [url] section instead.

Removed

  • Buffer damage quirk for Plasma/KWin.

Fixed

  • generate-alt-random-writes.py --sixel sometimes crashing, resulting in PGO build failures.
  • Wrong colors in the 256-color cube (#479).
  • Memory leak triggered by "opening" an OSC-8 URI and then resetting the terminal without closing the URI (#495).
  • Assertion when emitting a sixel occupying the entire scrollback history (#494).
  • Font underlines being positioned below the cell (and thus being invisible) for certain combinations of fonts and font sizes (#503).
  • Sixels with transparent bottom border being resized below the size specified in "Set Raster Attributes".
  • Fonts sometimes not being reloaded with the correct scaling factor when dpi-aware=no, or dpi-aware=auto with monitor(s) with a scaling factor > 1 (#509).
  • Crash caused by certain CSI sequences with very large parameter values (#522).
  • Rare occurrences where the window did not close when the shell exited. Only seen on FreeBSD (#534)
  • Foot process(es) sometimes remaining, using 100% CPU, when closing multiple foot windows at the same time (#542).
  • Regression where <mod>+shift+tab always produced \E[Z instead of the correct \E[27;<mod>;9~ sequence (#547).
  • Crash when a line wrapping OSC-8 URI crossed the scrollback wrap around (#552).
  • Selection incorrectly wrapping rows ending with an explicit newline (#565).
  • Off-by-one error in markup of auto-detected URLs when the URL ends in the right-most column.
  • Multi-column characters being cut in half when resizing the alternate screen.
  • Restore SIGHUP in spawned processes.
  • Text reflow performance (#504).
  • IL+DL (CSI Ps L + CSI Ps M) now moves the cursor to column 0.
  • SS2 and SS3 (single shift) escape sequences behaving like locking shifts (#580).
  • TEXT+STRING+UTF8_STRING mime types not being recognized in clipboard offers (#583).
  • Memory leak caused by custom box drawing glyphs not being completely freed when destroying a foot window instance (#586).
  • Crash in scrollback search when current XKB layout is missing compose definitions.
  • Window title not being updated while window is hidden (#591).
  • Crash on badly formatted URIs in e.g. OSC-8 URLs.
  • Window being incorrectly resized on CSD/SSD run-time changes.

Contributors

1.7.2

Added

  • URxvt OSC-11 extension to set background alpha (#436).
  • OSC 17/117/19/119 - change/reset selection background/foreground color.
  • box-drawings-uses-font-glyphs=yes|no option to foot.ini (#430).

Changed

  • Underline cursor is now rendered below text underline (#415).
  • Foot now tries much harder to keep URL jump labels inside the window geometry (#443).
  • bold-text-in-bright may now be set to palette-based, in which case it will use the corresponding bright palette color when the color to brighten matches one of the base 8 colors, instead of increasing the luminance (#449).

Fixed

  • Reverted "Consumed modifiers are no longer sent to the client application" (#425).
  • Crash caused by a double free originating in XTSMGRAPHICS - set number of color registers (#427).
  • Wrong action referenced in error message for key binding collisions (#432).
  • OSC 4/104 out-of-bounds accesses to the color table. This was the reason pywal turned foot windows transparent (#434).
  • PTY not being drained when the client application terminates.
  • auto_left_margin not being limited to cub1 (#441).
  • Crash in scrollback search mode when searching beyond the last output.

Contributors

1.7.1

Changed

  • Update PGO build instructions in INSTALL.md (#418).
  • In scrollback search mode, empty cells can now be matched by spaces.

Fixed

  • Logic that repairs invalid key bindings ended up breaking valid key bindings instead (#407).
  • Custom line-height settings now scale when increasing or decreasing the font size at run-time.
  • Newlines sometimes incorrectly inserted into copied text (#410).
  • Crash when compositor send text-input-v3::enter events without first having sent a keyboard::enter event (#411).
  • Deadlock when rendering sixel images.
  • URL labels, scrollback search box or scrollback position indicator sometimes not showing up, caused by invalidly sized surface buffers when output scaling was enabled (#409).
  • Empty sixels resulted in non-empty images.

1.7.0

Added

  • The pad option now accepts an optional third argument, center (e.g. pad=5x5 center), causing the grid to be centered in the window, with equal amount of padding of the left/right and top/bottom side (#273).
  • line-height, letter-spacing, horizontal-letter-offset and vertical-letter-offset to foot.ini. These options let you tweak cell size and glyph positioning (#244).
  • Key/mouse binding select-extend-character-wise, which forces the selection mode to 'character-wise' when extending a selection.
  • DECSET 47, 1047 and 1048.
  • URL detection and OSC-8 support. URLs are highlighted and activated using the keyboard (no mouse support). See foot(1)::URLs, or README.md for details (#14).
  • -d,--log-level={info|warning|error} to both foot and footclient (#337).
  • -D,--working-directory=DIR to both foot and footclient (#347)
  • DECSET 80 - sixel scrolling (#361).
  • DECSET 1070 - sixel private color palette (#362).
  • DECSET 8452 - position cursor to the right of sixels (#363).
  • Man page foot-ctlseqs(7), documenting all supported escape sequences (#235).
  • Support for transparent sixels (DCS parameter P2=1) (#391).
  • -N,--no-wait to footclient (#395).
  • Completions for Bash shell (#10).
  • Implement XTVERSION (CSI > 0q). Foot will reply with DCS>|foot(<major>.<minor>.<patch>)ST (#359).

Changed

  • The fcft and tllist library subprojects are now handled via Meson wrap files instead of needing to be manually cloned.
  • Box drawing characters are now rendered by foot, instead of using font glyphs (#198)
  • Double- or triple clicking then dragging now extends the selection word- or line-wise (#267).
  • The line thickness of box drawing characters now depend on the font size (#281).
  • Extending a word/line-wise selection now uses the original selection mode instead of switching to character-wise.
  • While doing an interactive resize of a foot window, foot now requires 100ms of idle time (where the window size does not change) before sending the new dimensions to the client application. The timing can be tweaked, or completely disabled, by setting resize-delay-ms (#301).
  • CSI 13 ; 2 t now reports (0,0).
  • Key binding matching logic; key combinations like Control+Shift+C must now be written as either Control+C or Control+Shift+c, the latter being the preferred variant. (#376)
  • Consumed modifiers are no longer sent to the client application (#376).
  • The minimum version requirement for the libxkbcommon dependency is now 1.0.0.
  • Empty pixel rows at the bottom of a sixel is now trimmed.
  • Sixels with DCS parameter P2=0|2 now use the current ANSI background color for empty pixels instead of the default background color (#391).
  • Sixel decoding optimized; up to 100% faster in some cases.
  • Reported sixel "max geometry" from current window size, to the configured maximum size (defaulting to 10000x10000).

Removed

  • The -g,--geometry command-line option (which had been deprecated and superseded by -w,--window-size-pixels since 1.5.0).

Fixed

  • Some mouse bindings (primary paste, for example) did not require shift to be pressed while used in a mouse grabbing application. This meant the mouse event was never seen by the application.
  • Terminals spawned with ctrl+shift+n not terminating when exiting shell (#366).
  • Default value of -t,--term in --help output when foot was built without terminfo support.
  • Drain PTY when the client application terminates.

Contributors

1.6.4

Added

  • selection-target=none|primary|clipboard|both to foot.ini. It can be used to configure which clipboard(s) selected text should be copied to. The default is primary, which corresponds to the behavior in older foot releases (#288).

Changed

  • The IME state no longer stays stuck in the terminal if the IME goes away during preedit.
  • -Dterminfo changed from a boolean to a feature option.
  • Use standard signals instead of a signalfd to handle SIGCHLD. Fixes an issue on FreeBSD where foot did not detect when the client application had terminated.

Fixed

  • BS, HT and DEL from being stripped in bracketed paste mode.

Contributors

1.6.3

Added

  • Completions for fish shell (#11)
  • FreeBSD support (#238).
  • IME popup location support: foot now sends the location of the cursor so any popup can be displayed near the text that is being typed.

Changed

  • Trailing comments in foot.ini must now be preceded by a space or tab (#270)
  • The scrollback search box no longer accepts non-printable characters.
  • Non-formatting C0 control characters, BS, HT and DEL are now stripped from pasted text.

Fixed

  • Exit when the client application terminates, not when the TTY file descriptor is closed.
  • Crash on compositors not implementing the text input interface (#259).
  • Erased, overflowing glyphs (when tweak.allow-overflowing-double-width-glyphs=yes - the default) not properly erasing the cell overflowed into.
  • word-delimiters option ignores # and subsequent characters (#270)
  • Combining characters not being rendered when composed with colored bitmap glyphs (i.e. colored emojis).
  • Pasting URIs from the clipboard when the source has not newline-terminated the last URI (#291).
  • Sixel "current geometry" query response not being bounded by the current window dimensions (fixes lsix output)
  • Crash on keyboard input when repeat rate was zero (i.e. no repeat).
  • Wrong button encoding of mouse buttons 6 and 7 in mouse events.
  • Scrollback search not matching composed characters.
  • High CPU usage when holding down e.g. arrow keys while in scrollback search mode.
  • Rendering of composed characters in the scrollback search box.
  • IME pre-edit cursor when positioned at the end of the pre-edit string.
  • Scrollback search not matching multi-column characters.

Contributors

1.6.2

Fixed

  • Version number in meson.build.

1.6.1

Added

  • --seed to generate-alt-random.py, enabling deterministic PGO builds.

Changed

  • Use -std=c11 instead of -std=c18.
  • Added -Wno-profile-instr-unprofiled to Clang cflags in PGO builds (INSTALL.md)

Fixed

  • Missing dependencies in meson, causing heavily parallelized builds to fail.
  • Background color when alpha < 1.0 being wrong (#249).
  • generate-alt-random.py failing in containers.

Contributors

1.6.0

For packagers

Starting with this release, foot can be PGO:d (compiled using profile guided optimizations) without a running Wayland session. This means foot can be PGO:d in e.g. sandboxed build scripts. See INSTALL.md.

Added

  • IME support. This is compile-time optional, see INSTALL.md (#134).
  • DECSET escape to enable/disable IME: CSI ? 737769 h enables IME and CSI ? 737769 l disables it. This can be used to e.g. enable/disable IME when entering/leaving insert mode in vim.
  • dpi-aware option to foot.ini. The default, auto, sizes fonts using the monitor's DPI when output scaling has been disabled. If output scaling has been enabled, fonts are sized using the scaling factor. DPI-only font sizing can be forced by setting dpi-aware=yes. Setting dpi-aware=no forces font sizing to be based on the scaling factor. (#206).
  • Implement reverse auto-wrap (auto_left_margin, bw, in terminfo). This mode can be enabled/disabled with CSI ? 45 h and CSI ? 45 l. It is enabled by default (#150).
  • bell option to foot.ini. Can be set to set-urgency to make foot render the margins in red when receiving BEL while not having keyboard focus. Applications can dynamically enable/disable this with the CSI ? 1042 h and CSI ? 1042 l escape sequences. Note that Wayland does not implement an urgency hint like X11, but that there is a proposal to add support for this. The value set-urgency was chosen for forward-compatibility, in the hopes that this proposal eventualizes (#157).
  • bell option can also be set to notify, in which case a desktop notification is emitted when foot receives BEL in an unfocused window.
  • word-delimiters option to foot.ini (#156).
  • csd.preferred can now be set to none to disable window decorations. Note that some compositors will render SSDs despite this option being used (#163).
  • Terminal content is now auto-scrolled when moving the mouse above or below the window while selecting (#149).
  • font-bold, font-italic font-bold-italic options to foot.ini. These options allow custom bold/italic fonts. They are unset by default, meaning the bold/italic version of the regular font is used (#169).
  • Drag & drop support; text, files and URLs can now be dropped in a foot terminal window (#175).
  • clipboard-paste and primary-paste scrollback search bindings. By default, they are bound to ctrl+v ctrl+y and shift+insert respectively, and lets you paste from the clipboard or primary selection into the search buffer.
  • Support for pipe-* actions in mouse bindings. It was previously not possible to add a command to these actions when used in mouse bindings, making them useless (#183).
  • bold-text-in-bright option to foot.ini. When enabled, bold text is rendered in a brighter color (#199).
  • -w,--window-size-pixels and -W,--window-size-chars command line options to footclient (#189).
  • Short command line options for --title, --maximized, --fullscreen, --login-shell, --hold and --check-config.
  • DECSET escape to modify the escape key to send \E[27;1;27~ instead of \E: CSI ? 27127 h enables the new behavior, CSI ? 27127 l disables it (the default).
  • OSC 777;notify: desktop notifications. Use in combination with the new notify option in foot.ini (#224).
  • Status line terminfo capabilities hs, tsl, fsl and dsl. This enables e.g. vim to set the window title (#242).

Changed

  • Blinking text now uses the foreground color, but dimmed down in its off state, instead of the background color.
  • Sixel default maximum size is now 10000x10000 instead of the current window size.
  • Graphical glitches/flashes when resizing the window while running a fullscreen application, i.e. the 'alt' screen (#221).
  • Cursor will now blink if either CSI ? 12 h or CSI Ps SP q has been used to enable blinking. cursor.blink in foot.ini controls the default state of CSI Ps SP q (#218).
  • The sub-parameter versions of the SGR RGB color escapes (e.g \E[38:2...m) can now be used without the color space ID parameter.
  • SGR 21 no longer disables bold. According to ECMA-48, SGR 21 is "double underline". Foot does not (yet) implement that, but that's no reason to implement a non-standard behavior.
  • DECRQM now returns actual state of the requested mode, instead of always returning 2.

Removed

  • Support for loading configuration from $XDG_CONFIG_HOME/footrc.
  • scrollback option from foot.ini.
  • geometry from foot.ini.
  • Key binding action scrollback-up and scrollback-down.

Fixed

  • Error when re-assigning a default key binding (#233).
  • \E[s+\E[u (save/restore cursor) now saves and restores attributes and charset configuration, just like \E7+\E8.
  • Report mouse motion events to the client application also while dragging the cursor outside the grid.
  • Parsing of the sub-parameter versions of indexed SGR color escapes (e.g. \E[38:5...m)
  • Frames occasionally being rendered while application synchronized updates is in effect.
  • Handling of failures to parse the font specification string.
  • Extra private/intermediate characters in escape sequences not being ignored.

Contributors

1.5.4

Changed

  • Num Lock by default overrides the keypad mode. See foot.ini(5)::KEYPAD, or README.md for details (#194).
  • Single-width characters with double-width glyphs are now allowed to overflow into neighboring cells by default. Set tweak.allow-overflowing-double-width-glyphs to 'no' to disable this.

Fixed

  • Resize very slow when window is hidden (#190).
  • Key mappings for key combinations with shift+tab (#210).
  • Key mappings for key combinations with alt+return.
  • footclient -m (--maximized) flag being ignored.
  • Crash with explicitly sized sixels with a height less than 6 pixels.
  • Key mappings for esc with modifiers.

Contributors

1.5.3

Fixed

  • Crash when libxkbcommon cannot find a suitable libX11 compose file. Note that foot will run, but without support for dead keys. (#170).
  • Restored window size when window is un-tiled.
  • XCursor shape in CSD corners when window is tiled.
  • Error handling when processing keyboard input (maybe #171).
  • Compilation error "overflow in conversion from long 'unsigned int' to 'int' changes value... " seen on platforms where the request argument in ioctl(3) is an int (for example: linux/ppc64).
  • Crash when using the mouse in alternate scroll mode in an unfocused window (#179).
  • Character dropped from selection when "right-click-hold"-extending a selection (#180).

1.5.2

Fixed

  • Regression: middle clicking double pastes in e.g. vim (#168)

1.5.1

Changed

  • Default value of the scrollback.multiplier option in foot.ini from 1.0 to 3.0.
  • shift+insert now pastes from the primary selection by default. This is in addition to middle-clicking with the mouse.

Fixed

  • Mouse bindings now match even if the actual click count is larger than specified in the binding. This allows you to, for example, quickly press the middle-button to paste multiple times (#146).
  • Color flashes when changing the color palette with OSC 4,10,11 (#141).
  • Scrollback position is now retained when resizing the window (#142).
  • Trackpad scrolling speed to better match the mouse scrolling speed, and to be consistent with other (Wayland) terminal emulators. Note that it is (much) slower compared to previous foot versions. Use the scrollback.multiplier option in foot.ini if you find the new speed too slow (#144).
  • Crash when foot.ini contains an invalid section name (#159).
  • Background opacity when in reverse video mode.
  • Crash when writing a sixel image that extends outside the terminal's right margin (#151).
  • Sixel image at non-zero column positions getting sheared at seemingly random occasions (#151).
  • Crash after either resizing a window or changing the font size if there were sixels present in the scrollback while doing so.
  • Send Device Attributes to only send a response if Ps == 0.
  • Paste from primary when clipboard is empty.

Contributors

1.5.0

Deprecated

  • $XDG_CONFIG_HOME/footrc/~/.config/footrc. Use $XDG_CONFIG_HOME/foot/foot.ini/~/.config/foot/foot.ini instead.
  • scrollback option in foot.ini. Use scrollback.lines instead.
  • scrollback-up key binding. Use scrollback-up-page instead.
  • scrollback-down key binding. Use scrollback-down-page instead.

Added

  • Scrollback position indicator. This feature is optional and controlled by the scrollback.indicator-position and scrollback.indicator-format options in foot.ini (#42).
  • Key bindings in scrollback search mode are now configurable.
  • --check-config command line option.
  • pipe-selected key binding. Works like pipe-visible and pipe-scrollback, but only pipes the currently selected text, if any (#51).
  • mouse.hide-when-typing option to foot.ini.
  • scrollback.multiplier option to foot.ini (#54).
  • colors.selection-foreground and colors.selection-background options to foot.ini.
  • tweak.render-timer option to foot.ini.
  • Modifier support in mouse bindings (#77).
  • Click count support in mouse bindings, i.e double- and triple-click (#78).
  • All mouse actions (begin selection, select word, select row etc) are now configurable, via the new select-begin, select-begin-block, select-extend, select-word, select-word-whitespace and select-row options in the mouse-bindings section in foot.ini (#79).
  • Implement XTSAVE/XTRESTORE escape sequences, CSI ? Ps s and CSI ? Ps r (#91).
  • $COLORTERM is now set to truecolor at startup, to indicate support for 24-bit RGB colors.
  • Experimental support for rendering double-width glyphs with a character width of 1. Must be explicitly enabled with tweak.allow-overflowing-double-width-glyphs (#116).
  • initial-window-size-pixels options to foot.ini and -w,--window-size-pixels command line option to foot. This option replaces the now deprecated geometry and -g,--geometry options.
  • initial-window-size-chars option to foot.ini and -W,--window-size-chars command line option to foot. This option configures the initial window size in characters, and is an alternative to initial-window-size-pixels.
  • scrollback-up-half-page and scrollback-down-half-page key bindings. They scroll up/down half of a page in the scrollback (#128).
  • scrollback-up-line and scrollback-down-line key bindings. They scroll up/down a single line in the scrollback.
  • mouse.alternate-scroll-mode option to foot.ini. This option controls the initial state of the Alternate Scroll Mode, and defaults to yes. When enabled, mouse scroll events are translated to up/down key events in the alternate screen, letting you scroll in e.g. less and other applications without enabling native mouse support in them (#135).

Changed

  • Renamed man page for foot.ini from foot(5) to foot.ini(5).
  • Configuration errors are no longer fatal; foot will start and print an error inside the terminal (and of course still log errors on stderr).
  • Default --server socket path to use $WAYLAND_DISPLAY instead of $XDG_SESSION_ID (#55).
  • Trailing empty cells are no longer highlighted in mouse selections.
  • Foot now searches for its configuration in $XDG_DATA_DIRS/foot/foot.ini, if no configuration is found in $XDG_CONFIG_HOME/foot/foot.ini or in $XDG_CONFIG_HOME/footrc.
  • Minimum window size changed from four rows and 20 columns, to 1 row and 2 columns.
  • scrollback-up/down renamed to scrollback-up/down-page.
  • fcft >= 2.3.0 is now required.

Fixed

  • Command lines for pipe-visible and pipe-scrollback are now tokenized (i.e. syntax checked) when the configuration is loaded, instead of every time the key binding is executed.
  • Incorrect multi-column character spacer insertion when reflowing text.
  • Compilation errors in 32-bit builds.
  • Mouse cursor style in top and left margins.
  • Selection is now updated when the cursor moves outside the grid (#70).
  • Viewport sometimes not moving when doing a scrollback search.
  • Crash when canceling a scrollback search and the window had been resized while searching.
  • Selection start point not moving when the selection changes direction.
  • OSC 10/11/104/110/111 (modify colors) did not update existing screen content (#94).
  • Extra newlines when copying empty cells (#97).
  • Mouse events from being sent to client application when a mouse binding has consumed it.
  • Input events from getting mixed with paste data (#101).
  • Missing DPI values for "some" monitors on Gnome (#118).
  • Handling of multi-column composed characters while reflowing.
  • Escape sequences sent for key combinations with Return, that did not include Alt.
  • Clipboard (or primary selection) is now cleared when receiving an OSC-52 command with an invalid base64 encoded payload.
  • Cursor position being set outside the grid when reflowing text.
  • CSD buttons to be hidden when window size becomes so small that they no longer fit.

Contributors

1.4.4

Changed

  • Mouse cursor is now always a left_ptr when inside the margins, to indicate it is not possible to start a selection.

Fixed

  • Crash when starting a selection inside the margins.
  • Improved font size consistency across multiple monitors with different DPI (#47).
  • Handle trailing comments in footrc

1.4.3

Added

  • Section to README.md describing how to programmatically identify foot.
  • LICENSE, README.md and CHANGELOG.md are now installed to ${datadir}/doc/foot.
  • Support for escaping quotes in pipe-visible and pipe-scrollback commands.

Changed

  • Primary DA to no longer indicate support for Selective Erase, Technical Characters and Terminal State Interrogation.
  • Secondary DA to report foot as a VT220 instead of a VT420.
  • Secondary DA to report foot's version number in parameter 2, the Firmware Version. The string is made up of foot's major, minor and patch version numbers, always using two digits for each version number and without any other separating characters. Thus, 1.4.2 would be reported as 010402 (i.e. the full response would be \E[>1;010402;0c).
  • Scrollback search to only move the viewport if the match lies outside it.
  • Scrollback search to focus match, that requires a viewport change, roughly in the center of the screen.
  • Extending a selection with the right mouse button now works while dragging the mouse.

Fixed

  • Crash in scrollback search.
  • Crash when a pipe-visible or pipe-scrollback command contained an unclosed quote (#49).

Contributors

1.4.2

Changed

  • Maximum window title length from 100 to 2048.

Fixed

  • Crash when overwriting a sixel and the row being overwritten did not cover an entire cell.
  • Assertion failure in debug builds when overwriting a sixel image.

1.4.1

Fixed

  • Compilation errors in release builds with some combinations of compilers and compiler flags.

1.4.0

Added

  • Sync to terminfo. This is a tmux extension that indicates "Synchronized Updates" are supported.
  • --hold command line option to footclient.
  • Key mapping for KP_Decimal.
  • Terminfo entries for keypad keys: ka1, ka2, ka3, kb1, kb3, kc1, kc2, kc3, kp5, kpADD, kpCMA, kpDIV, kpDOT, kpMUL, kpSUB and kpZRO.
  • blink option to footrc; a boolean that lets you control whether the cursor should blink or not by default. Note that applications can override this.
  • Multi-seat support
  • Implemented C0::FF (form feed)
  • pipe-visible and pipe-scrollback key bindings. These let you pipe either the currently visible text, or the entire scrollback to external tools (#29). Example: pipe-visible=[sh -c "xurls | bemenu | xargs -r firefox] Control+Print

Changed

  • Background transparency to only be used with the default background color.
  • Copy-to-clipboard/primary-selection to insert a line break if either the last cell on the previous line or the first cell on the next line is empty.
  • Number of lines to scroll is now always clamped to the number of lines in the scrolling region..
  • New terminal windows spawned with ctrl+shift+n are no longer double forked.
  • Unicode combining character overflow errors are only logged when debug logging has been enabled.
  • OSC 4 (Set Color) now updates already rendered cells, excluding scrollback.
  • Mouse cursor from hand2 to left_ptr when client is capturing the mouse.
  • Sixel images are now removed when the font size is decreased.
  • DECSCUSR (Set Cursor Style, CSI Ps SP q) now uses Ps=0 instead of Ps=2 to reset the style to the user configured default style. Ps=2 now always configures a Steady Block cursor.
  • Se terminfo capability from \E[2 q to \E[ q.
  • Hollow cursor to be drawn when window has lost keyboard focus rather than visual focus.

Fixed

  • Do not stop an ongoing selection when shift is released. When the client application is capturing the mouse, one must hold down shift to start a selection. This selection is now finalized only when the mouse button is released - not as soon as shift is released.
  • Selected cells did not appear selected if programmatically modified.
  • Rare crash when scrolling and the new viewport ended up exactly on the wrap around.
  • Selection handling when viewport wrapped around.
  • Restore signal mask in the client process.
  • Set IUTF8.
  • Selection of double-width characters. It is no longer possible to select half of a double-width character.
  • Draw hollow block cursor on top of character.
  • Set an initial TIOCSWINSZ. This ensures clients never read a 0x0 terminal size (#20).
  • Glyphs overflowing into surrounding cells (#21).
  • Crash when last rendered cursor cell had scrolled off screen and \E[J3 was executed.
  • Assert (debug builds) when an \e]4 OSC escape was not followed by a ;.
  • Window title always being set to "foot" on reset.
  • Terminfo entry kb2 (center keypad key); it is now set to \EOu (which is what foot emits) instead of the incorrect value \EOE.
  • Palette reuse in sixel images. Previously, the palette was reset after each image.
  • Do not auto-resize a sixel image for which the client has specified a size. This fixes an issue where an image would incorrectly overflow into the cell row beneath.
  • Text printed, or other sixel images drawn, on top of a sixel image no longer erases the entire image, only the part(s) covered by the new text or image.
  • Sixel images being erased when printing text next to them.
  • Sixel handling when resizing window.
  • Sixel handling when scrollback wraps around.
  • Foot now issues much fewer wl_surface_damage_buffer() calls (#35).
  • C0::VT to be processed as C0::LF. Previously, C0::VT would only move the cursor down, but never scroll.
  • C0::HT (Horizontal Tab, or \t) no longer clears LCF (Last Column Flag).
  • C0::LF now always clears LCF. Previously, it only cleared it when the cursor was not at the bottom of the scrolling region.
  • IND and RI now clears LCF.
  • DECAWM now clears LCF.
  • A multi-column character that does not fit on the current line is now printed on the next line, instead of only printing half the character.
  • Font size can no longer be reduced to negative values (#38).

1.3.0

Added

  • User configurable key- and mouse bindings. See man 5 foot and the example footrc (#1)
  • initial-window-mode option to footrc, that lets you control the initial mode for each newly spawned window: windowed, maximized or fullscreen.
  • app-id option to footrc and --app-id command line option, that sets the app-id property on the Wayland window.
  • title option to footrc and --title command line option, that sets the initial window title.
  • Right mouse button extends the current selection.
  • CSI Ps ; Ps ; Ps t escape sequences for the following parameters: 11t, 13t, 13;2t, 14t, 14;2t, 15t, 19t.
  • Unicode combining characters.

Changed

  • Spaces no longer removed from zsh font name completions.
  • Default key binding for spawn-terminal to ctrl+shift+n.
  • Renderer is now much faster with interactive scrolling (#4)
  • memfd sealing failures are no longer fatal errors.
  • Selection to no longer be cleared on resize.
  • The current monitor's subpixel order (RGB/BGR/V-RGB/V-BGR) is preferred over FontConfig's rgba property. Only if the monitor's subpixel order is unknown is FontConfig's rgba property used. If the subpixel order is none, then grayscale antialiasing is used. The subpixel order is ignored if antialiasing has been disabled.
  • The four primary font variants (normal, bold, italic, bold italic) are now loaded in parallel. This speeds up both the initial startup time, as well as DPI changes.
  • Command line parsing no longer tries to parse arguments following the command-to-execute. This means one can now write foot sh -c true instead of foot -- sh -c true.

Removed

  • Keyboard/pointer handler workarounds for Sway 1.2.

Fixed

  • Sixel images moved or deleted on window resize.
  • Cursor sometimes incorrectly restored on exit from alternate screen.
  • 'Underline' cursor being invisible on underlined text.
  • Restored cursor position in 'normal' screen when window was resized while in 'alt' screen.
  • Hostname in OSC 7 URI not being validated.
  • OSC 4 with multiple c;spec pairs.
  • Alt+Return to emit "ESC \r".
  • Trackpad sloooow scrolling to eventually scroll a line.
  • Memory leak in terminal reset.
  • Translation of cursor coordinates on resize
  • Scaling color specifiers in OSC sequences.
  • OSC 12 ? to return the cursor color, not the cursor's text color.
  • OSC 12;#000000 to configure the cursor to use inverted foreground/background colors.
  • Call ioctl(TIOCSCTTY) on the pts fd in the slave process.

1.2.3

Fixed

  • Forgot to version bump 1.2.2

1.2.2

Changed

  • Changed icon name in foot.desktop and foot-server.desktop from terminal to utilities-terminal.
  • XDG_SESSION_ID is now included in the server/daemon default socket path.

Fixed

  • Window size doubling when moving window between outputs with different scaling factors (#3).
  • Font being too small on monitors with fractional scaling (#5).

1.2.1

Fixed

  • Building AUR package

1.2.0

Added

  • Run-time text resize using ctrl-+, ctrl+- and ctrl+0
  • Font size adjusts dynamically to outputs' DPI
  • Reflow text when resizing window
  • pad option to footrc
  • login-shell option to footrc and --login-shell command line option
  • Client side decorations (CSDs). This finally makes foot usable on GNOME.
  • Sixel graphics support
  • OSC 12 and 112 escape sequences (set/reset text cursor color)
  • REP CSI escape sequence
  • oc to terminfo
  • foot-server.desktop file
  • Window and cell size reporting escape sequences
  • --hold command line option
  • --print-pid=FILE|FD command line option

Changed

  • Subpixel antialiasing is only enabled when background is opaque
  • Meta/alt ESC prefix can now be disabled with \E[?1036l. In this mode, the 8:th bit is set and the result is UTF-8 encoded. This can also be disabled with \E[1024l (in which case the Alt key is effectively being ignored).
  • terminfo now uses ST instead of BEL as OSC terminator
  • Logging to print to stderr, not stdout
  • Backspace now emits DEL (^?), and ctrl+backspace emits BS (^H)

Removed

  • '28' from DA response
1# Changelog
3* [Unreleased](#unreleased)
4* [1.28.0](#1-28-0)
5* [1.27.0](#1-27-0)
6* [1.26.1](#1-26-1)
7* [1.26.0](#1-26-0)
8* [1.25.0](#1-25-0)
9* [1.24.0](#1-24-0)
10* [1.23.1](#1-23-1)
11* [1.23.0](#1-23-0)
12* [1.22.3](#1-22-3)
13* [1.22.2](#1-22-2)
14* [1.22.1](#1-22-1)
15* [1.22.0](#1-22-0)
16* [1.21.0](#1-21-0)
17* [1.20.2](#1-20-2)
18* [1.20.1](#1-20-1)
19* [1.20.0](#1-20-0)
20* [1.19.0](#1-19-0)
21* [1.18.1](#1-18-1)
22* [1.18.0](#1-18-0)
23* [1.17.2](#1-17-2)
24* [1.17.1](#1-17-1)
25* [1.17.0](#1-17-0)
26* [1.16.2](#1-16-2)
27* [1.16.1](#1-16-1)
28* [1.16.0](#1-16-0)
29* [1.15.3](#1-15-3)
30* [1.15.2](#1-15-2)
31* [1.15.1](#1-15-1)
32* [1.15.0](#1-15-0)
33* [1.14.0](#1-14-0)
34* [1.13.1](#1-13-1)
35* [1.13.0](#1-13-0)
36* [1.12.1](#1-12-1)
37* [1.12.0](#1-12-0)
38* [1.11.0](#1-11-0)
39* [1.10.3](#1-10-3)
40* [1.10.2](#1-10-2)
41* [1.10.1](#1-10-1)
42* [1.10.0](#1-10-0)
43* [1.9.2](#1-9-2)
44* [1.9.1](#1-9-1)
45* [1.9.0](#1-9-0)
46* [1.8.2](#1-8-2)
47* [1.8.1](#1-8-1)
48* [1.8.0](#1-8-0)
49* [1.7.2](#1-7-2)
50* [1.7.1](#1-7-1)
51* [1.7.0](#1-7-0)
52* [1.6.4](#1-6-4)
53* [1.6.3](#1-6-3)
54* [1.6.2](#1-6-2)
55* [1.6.1](#1-6-1)
56* [1.6.0](#1-6-0)
57* [1.5.4](#1-5-4)
58* [1.5.3](#1-5-3)
59* [1.5.2](#1-5-2)
60* [1.5.1](#1-5-1)
61* [1.5.0](#1-5-0)
62* [1.4.4](#1-4-4)
63* [1.4.3](#1-4-3)
64* [1.4.2](#1-4-2)
65* [1.4.1](#1-4-1)
66* [1.4.0](#1-4-0)
67* [1.3.0](#1-3-0)
68* [1.2.3](#1-2-3)
69* [1.2.2](#1-2-2)
70* [1.2.1](#1-2-1)
71* [1.2.0](#1-2-0)
74## Unreleased
75### Added
76### Changed
78* Cells with a non-default background colors, but otherwise empty, are
79 now preserved (not removed) when resizing a terminal window
80 ([#2462][2462]).
82[2462]: https://codeberg.org/dnkl/foot/issues/2462
85### Deprecated
86### Removed
87### Fixed
89* Use-after-free during shutdown when footclient and the client
90 application exit simultaneously in a short window ([#2432][2432]).
91* Crash when a buggy compositor sends an `ime_enter()` event with a
92 `NULL` surface ([#2467][2467]).
93* Possible memory leak when processing keymap data ([#2482][2482]).
94* Word-wise selection sometimes not working properly due to incorrect
95 selection direction ([#2483][2483]).
96* Crash in `xdg_output_handle_done()` if called when a terminal is in
97 the process of shutting down ([#2487][2487]).
98* Not responding to an OSC-52 query if clipboard source has no data
99 ([#2493][2493]).
101[2432]: https://codeberg.org/dnkl/foot/pulls/2432
102[2467]: https://codeberg.org/dnkl/foot/issues/2467
103[2482]: https://codeberg.org/dnkl/foot/pulls/2482
104[2483]: https://codeberg.org/dnkl/foot/issues/2483
105[2487]: https://codeberg.org/dnkl/foot/issues/2487
106[2493]: https://codeberg.org/dnkl/foot/issues/2493
109### Security
110### Contributors
113## 1.28.0
115### Added
117* Command line option `--class`, an alias for `--app-id`. Intended to
118 be used by scripts and similar that wants to launch terminal
119 instances in a terminal agnostic way ([#2368][2368]).
120* Support for [terminal visibility
121 reports](https://rockorager.dev/misc/visibility-reports/), using the
122 Wayland `xdg_toplevel` suspended state.
123* Support for `wl_fixes::ack_global_remove()`.
125[2368]: https://codeberg.org/dnkl/foot/issues/2368
128### Changed
130* Do not allow codepoints to be merged into grapheme clusters directly
131 after a cursor move ([#2383][2383]).
132* Dracula theme updated to latest official, and light theme alucard
133 added.
134* Sixels: pan/pad clamped to 5 ([#2371][2371]).
135* Default URL regex changed to:
136 + allow single quotes (`'`) _inside_ the URL (but not at the end,
137 unless balanced).
138 + require at least one character inside balanced `[]`, `()`, `''` or
139 `""`.
140 ([#2417][2417]).
141* Foot now sets window urgency when a notification is activated, and
142 foot hasn't received an XDG activation token.
143* `-D,--working-directory` now supports `file://` URIs.
145[2383]: https://codeberg.org/dnkl/foot/issues/2383
146[2371]: https://codeberg.org/dnkl/foot/issues/2371
147[2417]: https://codeberg.org/dnkl/foot/issues/2417
150### Removed
152* `[colors]` and `[colors2]` config sections, and the corresponding
153 `color-theme-switch-1` and `color-theme-switch-2` key
154 bindings.
156 These were deprecated in 1.26.0, and were replaced by
157 `[colors-dark]`, `[colors-light]`, `color-theme-switch-dark` and
158 `color-theme-switch-light`.
160### Fixed
162* Out-of-bounds read when parsing URIs with malformed %-encoded
163 content ([#2353][2353]).
164* DECCRA not clamping or verifying the destination rectangle
165 ([#2352][2352]).
166* Empty selection clearing the clipboard ([#2327][2327]).
167* Require xkbcommon >= 1.6.0. This has been the case for a while, due
168 to our use of `XKB_KEYSYM_MAX`. Now it is formalized in
169 `meson.build` ([#2379][2379]).
170* Block selection area incorrectly updated when selecting back
171 across the starting column.
172* Passing a very large value as CHT/CBT argument hangs the terminal
173 ([#2360][2360]).
174* Sixel: crash when using a shared palette and gamma-correct blending
175 has been enabled, or foot is using 10-bit surface ([#2370][2370]).
176* Kitty text-size protocol: fix crash when text is zero-length
177 ([#2364][2364]).
178* Escape quotes in file names being DnD:ed on the command line
179 ([#2363][2363]).
180* Crash in `--server` mode, when a tracked notification is closed
181 after the associated terminal instance has been closed
182 ([#2397][2397]).
183* Incorrect word boundary detection when selection words with a
184 multi-column character in the last column ([#2411][2411]).
185* `reallocarray()` is no longer required, so as to support platforms
186 where libc doesn't include it (e.g. Termux + Android API < 29).
187* Crash in `select-quote` when the right-side quote appeared right
188 after a newline, in column 0 ([#2405][2405]).
189* Resizing a terminal window may break current selection.
190* Crash when closing a window that touch input focus.
191* Application mouse grabbing not working when there is no keymap
192 available.
193* Crash when a buggy compositor sends a `keyboard_enter()` event with
194 a `NULL` surface ([#2438][2438]).
195* Crash when clicking without moving the mouse after resizing the
196 window, and the clicked area is now outside the cell grid
197 ([#2435][2435]).
198* Modifiers in mouse-bindings colliding with the modifiers in
199 `selection-override-modifiers` not always detected.
200* `selection-override-modifiers=none` preventing applications from
201 grabbing the mouse.
203[2353]: https://codeberg.org/dnkl/foot/issues/2353
204[2352]: https://codeberg.org/dnkl/foot/issues/2352
205[2327]: https://codeberg.org/dnkl/foot/issues/2327
206[2379]: https://codeberg.org/dnkl/foot/issues/2379
207[2360]: https://codeberg.org/dnkl/foot/issues/2360
208[2370]: https://codeberg.org/dnkl/foot/issues/2370
209[2364]: https://codeberg.org/dnkl/foot/issues/2364
210[2363]: https://codeberg.org/dnkl/foot/issues/2363
211[2397]: https://codeberg.org/dnkl/foot/issues/2397
212[2411]: https://codeberg.org/dnkl/foot/issues/2411
213[2405]: https://codeberg.org/dnkl/foot/issues/2405
214[2438]: https://codeberg.org/dnkl/foot/issues/2438
215[2435]: https://codeberg.org/dnkl/foot/issues/2435
218### Contributors
220* 0WD0
221* airkoala
222* aloires
223* Campbell Barton
224* CismonX
225* Craig Barnes
226* Emily Vlasics
227* fhqh
228* K4
229* koru
230* lumerue
231* Marinus Klasen
232* sentriz
233* Tim Culverhouse
236## 1.27.0
238### Added
240* `url.style=none|single|double|curly|dotted|dashed` option added,
241 allowing you to configure how URL underlines are drawn. The default
242 is `dotted` ([#2302][2302]).
244[2302]: https://codeberg.org/dnkl/foot/issues/2302
247### Changed
249* URL underlines are now dotted by default, instead of plain
250 underlines. This can be changed with the new `url.style` option.
251* If the cursor foreground and background colors are identical, use
252 the current cell's foreground and background colors (inverted),
253 instead of the default foreground and background colors
254 ([#2323][2323]).
256[2323]: https://codeberg.org/dnkl/foot/issues/2323
259### Fixed
261* Other output (key presses, query replies etc) being mixed with paste
262 data, both interactive pastes and OSC-52 ([#2307][2307]).
263* Scrollback search not working correctly when the terminal
264 application has enabled the kitty keyboard protocol with release
265 event reporting ([#2316][2316]).
266* Keypad escapes in the legacy keyboard protocol ignoring the shift
267 modifier ([#2324][2324]).
268* Crash when querying the kitty notification protocol (OSC-99, with
269 `p=?`) ([#2335][2335]).
271[2307]: https://codeberg.org/dnkl/foot/issues/2307
272[2316]: https://codeberg.org/dnkl/foot/issues/2316
273[2324]: https://codeberg.org/dnkl/foot/issues/2324
274[2335]: https://codeberg.org/dnkl/foot/issues/2335
277## 1.26.1
279### Fixed
281* Wrong documented default value for `initial-color-theme` in
282 `foot.ini(5)` ([#2292][2292]).
283* Occasional crashes when closing a window and
284 `tweak.pre-apply-damage=yes` (the default) ([#2288][2288]).
286[2292]: https://codeberg.org/dnkl/foot/issues/2292
287[2288]: https://codeberg.org/dnkl/foot/issues/2288
290### Contributors
292* Roshless
293* vlkrs
296## 1.26.0
298### Added
300* `toplevel-tag` option (and `--toplevel-tag` command line options to
301 `foot` and `footclient`), allowing you to set a custom toplevel
302 tag. The compositor must implement the new `xdg-toplevel-tag-v1`
303 Wayland protocol ([#2212][2212]).
304* `[colors-dark]` section to `foot.ini`. Replaces `[colors]`.
305* `[colors-light]` section to `foot.ini`. Replaces `[colors2]`.
306* `XTGETTCAP`: added `query-os-name`, returning the OS foot is
307 compiled for (e.g. _'Linux'_) ([#2209][2209]).
308* `pad` option now supports 4-directional padding format:
309 `LEFTxTOPxRIGHTxBOTTOM` (e.g., `20x10x20x10`).
310* `--config=PATH` option is now automatically passed to new
311 terminals spawned via `spawn-terminal` action ([#2259][2259]).
312* Preliminary (untested) support for background blur via the new
313 `ext-background-effect-v1` protocol. Enable by setting
314 `colors-{dark,light}.blur=yes`. Foot needs to have been **built**
315 against `wayland-protocols >= 1.45`, and the compositor **must**
316 implement the `ext-background-effect-v1` protocol, **and** the
317 `blur` effect.
319[2212]: https://codeberg.org/dnkl/foot/issues/2212
320[2209]: https://codeberg.org/dnkl/foot/issues/2209
321[2259]: https://codeberg.org/dnkl/foot/pulls/2259
324### Changed
326* When enabling _"focus mode"_ (private mode 1004), foot now sends a
327 focus event immediately, to inform the application what the current
328 state is ([#2202][2202]).
329* Scrollback search is now case sensitive when the search string
330 contains at least one upper case character.
331* Mouse tracking in SGR pixel mode no longer emits negative column/row
332 pixel values ([#2226][2226]).
333* Foot now always uses ARGB SHM surfaces. In earlier versions, XRGB
334 surfaces were used for opaque surfaces. Unfortunately, several
335 compositors had issues when foot switched between ARGB and XRGB
336 surfaces (for example when switching color theme, or toggling
337 fullscreen).
339[2202]: https://codeberg.org/dnkl/foot/issues/2202
340[2226]: https://codeberg.org/dnkl/foot/issues/2226
343### Deprecated
345* `[colors]` section in `foot.ini`. Use `[colors-dark]` instead.
346* `[colors2]` section in `foot.ini`. Use `[colors-light]` instead.
349### Removed
351* `cursor.color` config option (deprecated in 1.23.0). Use
352 `colors-{dark,light}.cursor` instead.
355### Fixed
357* Search mode: composing keys not ignored.
358* Crash when triple-clicking a soft-wrapped line and there is a quote
359 character in the last column.
360* Crash when reverse-scrolling (terminfo capability `rin`) such that
361 the current viewport ends up outside the scrollback ([#2232][2232]).
362* Regression: visual glitches in rare circumstances.
363* Key release events for shortcuts being sent to the client
364 application (kitty keyboard protocol only) ([#2257][2257]).
365* Crash when application emits sixel RA with a height of 0, a width >
366 0, and then starts writing sixel data ([#2267][2267]).
367* Crash if shutting down terminal instance while a "pre-apply damage"
368 thread is running ([#2263][2263]).
370[2232]: https://codeberg.org/dnkl/foot/issues/2232
371[2257]: https://codeberg.org/dnkl/foot/issues/2257
372[2267]: https://codeberg.org/dnkl/foot/issues/2267
373[2263]: https://codeberg.org/dnkl/foot/issues/2263
376### Contributors
378* Andrei
379* Barinderpreet Singh
380* c4llv07e
381* Johannes Altmanninger
382* nariby
383* pi66
384* Ronan Pigott
385* Stéphane Klein
386* valoq
387* Whyme Lyu
388* Yaakov Selkowitz
391## 1.25.0
393### Added
395* Performance increased and input latency decreased on compositors
396 that do not release SHM buffers immediately ([#2188][2188]).
397* `colors{,2}.dim-blend-towards=black|white` option, allowing you to
398 select towards which color to blend when dimming text. Defaults to
399 `black` in `[colors]`, and `white` in `[colors2]` ([#2187][2187]).
401[2188]: https://codeberg.org/dnkl/foot/issues/2188
402[2187]: https://codeberg.org/dnkl/foot/issues/2187
405### Changed
407* SHM buffer sizes are now rounded up to nearest page size, and their
408 stride is always an even multiple of 256 bytes (by default,
409 configurable by setting `tweak.min-stride-alignment`). This allows
410 compositor to directly import foot's SHM buffers to the GPU, with
411 e.g. integrated graphics ([#2182][2182]).
412* Jump label colors in the modus-operandi theme, for improved
413 readability.
415[2182]: https://codeberg.org/dnkl/foot/issues/2182
418### Fixed
420* URL labels misplaces when URL contains double-width characters
421 ([#2179][2179]).
422* One space too much consumed when copying (or pipe:ing) contents with
423 tabs ([#2194][2194])
424* Ensure we render a new frame when changing fullscreen state. Before,
425 this was automatically done if the window was also resized. But, it
426 is possible for a compositor to change an application's fullscreen
427 state without resizing the window.
429[2179]: https://codeberg.org/dnkl/foot/issues/2179
430[2194]: https://codeberg.org/dnkl/foot/issues/2194
433### Contributors
435* Charalampos Mitrodimas
436* Matthias Heyman
439## 1.24.0
441### Added
443* The `uppercase-regex-insert` option controls whether an uppercase hint
444 character will insert the selected text into the prompt in `regex-copy`
445 or `show-urls-copy` mode. It defaults to `true`. ([#2159][2159]).
447[2159]: https://codeberg.org/dnkl/foot/issues/2159
449### Changed
451* The label letters are no longer sorted before being assigned to URLs
452 ([#2140][2140]).
453* Sending SIGUSR1/SIGUSR2 to a `foot --server` process now causes
454 newly spawned client instances to use the selected theme, instead of
455 the original one.
456* SIGUSR1/SIGUSR2 can now be sent to `footclient` processes, to change
457 the theme of that particular instance ([#2156][2156]).
459[2156]: https://codeberg.org/dnkl/foot/issues/2156
462### Fixed
464* Invalid configuration values overriding valid ones in surprising
465 ways.
466* Bug where the libutempter utmp backend did not record logouts
467 correctly.
469### Contributors
471* Ryan Roden-Corrent
472* Tobias Mock
475## 1.23.1
477### Changed
479* URL labels are now assigned in reverse order, from bottom to
480 top. This ensures the **last** URL (which is often the one you are
481 interested in) is always assigned the same key ([#2140][2140]).
482* Sending `SIGUSR1` no longer **toggles** between `[colors]` and
483 `[colors2]`, but explicitly changes to `[colors]`. `SIGUSR2` changes
484 to `[colors2]` ([#2144][2144]).
486[2140]: https://codeberg.org/dnkl/foot/issues/2140
487[2144]: https://codeberg.org/dnkl/foot/issues/2144
490### Fixed
492* 10-bit surfaces sometimes used instead of 16-bit.
493* OSC-104/110/111/112/117/119 (reset colors) not taking the currently
494 active theme into account.
497## 1.23.0
499### Added
501* `colors2` config section. This section duplicates the `colors`
502 section, and lets you define an alternative color theme.
503* `key-bindings.color-theme-switch-1`,
504 `key-bindings.color-theme-switch-2` and
505 `key-bindings.color-theme-toggle` key bindings. These can be used to
506 switch between the primary and alternative color themes. They are
507 not bound by default.
508* Sending `SIGUSR1` to the foot process now triggers a theme switch
509 (in server mode, **all** instances toggles their themes).
510* Support for private mode 2031 - [_Dark and Light Mode
511 Detection_](https://contour-terminal.org/vt-extensions/color-palette-update-notifications/)
512 ([#2025][2025])
513* Added `initial-color-theme=1|2` config option. `1` uses colors from
514 the `[colors]` section, `2` uses `[colors2]`.
515* Combined dark/light theme files for (dark variant is the default,
516 set `initial-color-theme=2` to use the light variant by default):
517 - gruvbox
518 - nvim
519 - paper-color
520 - selenized
521 - solarized
522* `regex-copy`/`show-urls-copy` will copy and paste the selected text if the hint
523 is completed with an uppercase character ([#1975][1975]).
524* `16-bit` to `tweak.surface-bit-depth`. Makes foot use 16-bit image
525 buffers. They provide the necessary color precision required by
526 `gamma-correct-blending=yes`.
527* New cursor shapes, from `cursor-shape-v1` version 2.
528* `center-when-fullscreen` and `center-when-maximized-and-fullscreen`
529 to the `pad` option. This allows you to configure when the grid is
530 centered in more detail ([#2111][2111]).
532[2025]: https://codeberg.org/dnkl/foot/issues/2025
533[1975]: https://codeberg.org/dnkl/foot/issues/1975
534[2111]: https://codeberg.org/dnkl/foot/issues/2111
537### Changed
539* `cursor.color` moved to `colors.cursor`.
540* OSC-11 without an alpha value will now restore the configured
541 (i.e. from `foot.ini`) alpha, rather than keeping whatever the
542 current alpha value is, unchanged.
543* `gamma-correct-blending=yes` now defaults to `16-bit` image buffers,
544 instead of `10-bit`.
545* Allow setting either selection background, or selection foreground,
546 only ([#1846][1846]).
547* Drop required version of libxkbcommon from 1.8.0 back to 1.0.0
548 ([#2103][2103]).
549* OSC-52: an empty payload now clears the clipboard.
550* DA (Device Attributes): include `52` in the reply, to indicate
551 OSC-52 support (when at least _copy_ has been enabled in
552 `security.osc52`).
554[1846]: https://codeberg.org/dnkl/foot/issues/1846
555[2103]: https://codeberg.org/dnkl/foot/issues/2103
558### Deprecated
560* `cursor.color` config option; use `colors.cursor` instead.
563### Removed
565* Subsurface unmap quirk for Sway. This was a workaround added in
566 1.12.1, for Sway issue [#6960][sway-6960].
569### Fixed
571* `REP`: wrong width of repeated multi-codepoint graphemes.
572* Incorrect surface commit after a configure event, under certain
573 conditions ([#2105][2105]).
575[2105]: https://codeberg.org/dnkl/foot/issues/2105
578### Contributors
580* Chen Mulong
581* Kirill Primak
582* Ryan Roden-Corrent
583* tokyo4j
586## 1.22.3
588### Added
590* `auto` to the `tweak.surface-bit-depth` option.
593### Changed
595* `gamma-correct-blending` now defaults to `no` instead of `yes`.
596* `tweak.surface-bit-depth` default value changed to `auto`; uses
597 10-bit surfaces when `gamma-correct-blending=yes`, and 8-bit
598 surfaces otherwise.
601### Fixed
603* Inaccurate colors when `gamma-correct-blending=yes` ([#2082][2082]).
605[2082]: https://codeberg.org/dnkl/foot/issues/2082
608## 1.22.2
610### Changed
612* `gamma-correct-blending=yes` now uses a pure gamma 2.2 transfer
613 function, instead of the piece-wise sRGB transfer function, to match
614 what compositors do.
617### Fixed
619* Wrong colors when `gamma-correct-blending=yes` (the default when
620 there is compositor support). Note that some colors will still be
621 off by a **very** small amount, due to loss of precision when
622 converting to a linear color space. ([#2035][2035]).
624[2035]: https://codeberg.org/dnkl/foot/issues/2035
627## 1.22.1
629### Fixed
631* `colors.alpha-mode=matching` not working as intended.
632* Grapheme shaping was allowed to be "enabled" at runtime, even though
633 disabled at compile time. This caused mis-rendering of certain
634 codepoints ([#2039][2039]).
635* Keyboard modifiers not being reset on keyboard leave events
636 ([#2034][2034]).
637* Fallback font (and possibly wrong color) being used when a character
638 was followed by a zero-width grapheme breaking codepoint (for
639 example, _LEFT-TO-RIGHT MARK_) ([#2049][2049]).
640* Regression: alpha applied to inversed text/selections
641 ([#2073][2073]).
643[2039]: https://codeberg.org/dnkl/foot/issues/2039
644[2034]: https://codeberg.org/dnkl/foot/issues/2034
645[2049]: https://codeberg.org/dnkl/foot/issues/2049
646[2073]: https://codeberg.org/dnkl/foot/issues/2073
649### Contributors
651* Jan Palus
652* valoq
655## 1.22.0
657### Added
659* Support for toplevel edge constraints. When the compositor indicates
660 the toplevel has edge constraints, foot will not allow the window to
661 be resized (via CSDs) in the constrained directions.
662* Virtual modifiers (e.g. `Alt` instead of `Mod1`, `Super` instead of
663 `Mod4` etc) in key bindings are now recognized as being virtual, and
664 are automatically mapped to the corresponding real modifier. This
665 means you can use e.g. `Alt+b` instead of `Mod1+b`.
666* `alpha-mode` option to `foot.ini`. Defaults to `default`. This
667 config changes how alpha is handled on background colours not set by
668 the terminal.(e.g. vim) ([#2026](2026))
670[2026]: https://codeberg.org/dnkl/foot/issues/2026
673### Changed
675* UTF-8 error recovery now discards fewer bytes.
676* Auto-calculated dimmed and brightened colors (e.g. when custom dim
677 colors has not configured) is now done by linear RGB interpolation,
678 rather than converting to HSL and adjusting the luminance
679 ([#2006][2006]).
680* Virtual modifiers in keyboard events from the compositor are now
681 supported. This works around various issues seen when running foot
682 under mutter (GNOME) ([#2009][2009]):
683 - Some key combinations generating the wrong escape sequence in the
684 kitty keyboard protocol.
685 - some of foot's default shortcuts not working (mainly those using
686 `Mod1`) out of the box.
687* Default URL regex changed to a much more strict variant
688 ([#2016][2016]). You can manually set the [old
689 one](https://codeberg.org/dnkl/foot/src/tag/1.21.0/foot.ini#L72), if
690 you prefer it over the new regex.
691* A tiled window can now be resized in the corners (via CSDs), unless
692 the compositor has indicated the toplevel has edge constraints.
694[2006]: https://codeberg.org/dnkl/foot/issues/2006
695[2009]: https://codeberg.org/dnkl/foot/issues/2009
696[2016]: https://codeberg.org/dnkl/foot/issues/2016
699### Fixed
701* Regression: assertion in `url-mode.c` when activating a second URL
702 via `show-urls-persistent` ([#2000][2000]).
703* Build failure (`srgb.h` not found) when doing a parallel build.
704* Regression: reflowing (changing the window size) removing empty
705 lines ([#2011][2011]).
706* `url/regex-copy` not handling double-width characters correctly
707 ([#2027][2027]).
709[2000]: https://codeberg.org/dnkl/foot/issues/2000
710[2011]: https://codeberg.org/dnkl/foot/issues/2011
711[2027]: https://codeberg.org/dnkl/foot/issues/2027
714### Contributors
716* Alex Xu (Hello71)
717* datsudo
718* Dominique Martinet
719* Fazzi
720* llyyr
721* Łukasz Wojniłowicz
722* Sam McCall
725## 1.21.0
727### Added
729* Support for the new Wayland protocol `xdg-system-bell-v1` protocol
730 (added in wayland-protocols 1.38), via the new config option
731 `bell.system=no|yes` (defaults to `yes`).
732* Support for custom regex matching ([#1386][1386],
733 [#1872][1872])
734* Support for kitty's text-sizing protocol (`w`, width, only), OSC-66.
735* `cursor.style` can now be set to `hollow` ([#1965][1965]).
736* `search-bindings.delete-to-start` and
737 `search-bindings.delete-to-end` key bindings, defaulting to
738 `Control+u` and `Control+k` respectively ([#1972][1972]).
739* Gamma-correct font rendering. Requires compositor support
740 (`wp_color_management_v1`, and specifically, the `ext_linear`
741 transfer function). Enabled by default when compositor support is
742 available. Can be explicitly enabled or disabled with
743 `gamma-correct-blending=no|yes`.
745[1386]: https://codeberg.org/dnkl/foot/issues/1386
746[1872]: https://codeberg.org/dnkl/foot/issues/1872
747[1965]: https://codeberg.org/dnkl/foot/issues/1965
748[1972]: https://codeberg.org/dnkl/foot/issues/1972
751### Changed
753* Do not try to set a zero width, or height, if the compositor sends a
754 _configure_ event with only one dimension being zero
755 ([#1925][1925]).
756* Auto-detection of URLs (i.e. not OSC-8 based URLs) are now regex
757 based.
758* Rename Tokyo Night Day theme to Tokyo Night Light and update colors.
759* fcft >= 3.3.1 is now required.
760 - `tweak.scaling-filter` now supports more scaling-filters
761 - scaled bitmap fonts (when enabled in FontConfig) no longer have a
762 scaling-filter applied
763* Linefeed:ing control characters (e.g. `\n`) no longer **clears** a
764 row's internal linebreak flag. This fixes an issue where
765 e.g. multi-line prompt input in fish is treated as separate lines,
766 rather than one logical, when selecting and copying it
767 ([#1487][1487]).
768* wayland-protocols >= 1.41 is now required.
770[1925]: https://codeberg.org/dnkl/foot/issues/1925
771[1487]: https://codeberg.org/dnkl/foot/issues/1487
774### Removed
776* `url.uri-characters` and `url.protocols`. Both options have been
777 replaced by `url.regex`.
778* `notify` option (has been deprecated since 1.18.0).
779* `notify-focus-inhibit` option (has been deprecated since 1.18.0).
782### Fixed
784* Kitty keyboard protocol: alternate key reporting failing to report
785 the alternate codepoint in some corner cases ([#1918][1918]).
786* `foot` and `footclient` hanging, or terminating with `SIGABRT`, when
787 starting inside a directory whose total length is more than 1024
788 characters.
789* Regression: reflowing (resizing the window) a line that ends with a
790 double-width glyph that was pushed to the next line due to there
791 being only one cell left on current line, did not remove the virtual
792 space inserted at the end of the current line.
793* Wrong key bindings executed when using alternative keyboard layouts
794 ([#1929][1929]).
795* Foot not closing file descriptors for unrecognized or `no_keymap`
796 keymaps.
797* Combining characters (including emojis consisting of multiple
798 codepoints) not being handled correctly when _insert mode_ is
799 enabled ([#1947][1947]).
800* Reflow of the cursor (active + saved) when at the end of the line
801 with a pending wrap (LCF set) ([#1954][1954]).
802* ~~Zero-width characters that also are grapheme breaks (e.g. U+200B,
803 ZERO WIDTH SPACE) being ignored (discarded and never stored in the
804 grid) ([#1960][1960]).~~ (reverted)
805* `--server=<FD>` not working on FreeBSD ([#1956][1956]).
806* Crash when resetting the terminal and an application had previously
807 set a custom app ID ([#1963][1963])
808* Grapheme clustering state not reset on cursor movements.
809* Kitty keyboard protocol: no release events emitted for composed
810 keys.
811* IME: the initial cursor position was reported as 0,0,0,0
812 ([#1994][1994]).
814[1918]: https://codeberg.org/dnkl/foot/issues/1918
815[1929]: https://codeberg.org/dnkl/foot/issues/1929
816[1947]: https://codeberg.org/dnkl/foot/issues/1947
817[1954]: https://codeberg.org/dnkl/foot/issues/1954
818[1960]: https://codeberg.org/dnkl/foot/issues/1960
819[1956]: https://codeberg.org/dnkl/foot/issues/1956
820[1963]: https://codeberg.org/dnkl/foot/issues/1963
821[1994]: https://codeberg.org/dnkl/foot/issues/1994
824### Contributors
826* Adrian fxj9a
827* Alexander Orzechowski
828* Attila Fidan
829* camel-cdr
830* Craig Barnes
831* Guillaume Outters
832* Johannes Altmanninger
833* Ludovico Gerardi
834* sewn
835* Thomas Bonnefille
838## 1.20.2
840### Changed
842* The `CSI 21 t` (report window title) and `OSC 176 ?` (report app-id)
843 escape sequences are now ignored ([#1894][1894]).
845[1894]: https://codeberg.org/dnkl/foot/issues/1894
848### Fixed
850* 'flash' overlay (triggered by either `tput flash`, or enabling
851 `bell.visual` and then sending `BEL` to the terminal) stuck when
852 `colors.flash-alpha=1.0`.
853* Crash when compositor sends a keyboard enter event before the foot
854 window has been mapped ([#1910][1910]).
855* Build failures (`utf8proc.h` not found) on at least FreeBSD, but
856 most likely other BSDs, as well as some Linuxes ([#1903][1903]).
858[1910]: https://codeberg.org/dnkl/foot/issues/1910
859[1903]: https://codeberg.org/dnkl/foot/issues/1903
862### Contributors
864* Alexander Orzechowski
867## 1.20.1
869### Changed
871* Runtime changes to the app-id (OSC-176) now limits the app-id string
872 to 2048 characters ([#1897][1897]).
873* `colors.flash-alpha` can no longer be set to 1.0 (i.e. fully
874 opaque). This fixes an issue where the window would be stuck in the
875 flash state.
877[1897]: https://codeberg.org/dnkl/foot/issues/1897
880### Fixed
882* Regression: trying to print a Unicode _"Legacy Computing symbol"_,
883 in the range U+1FB00 - U+1FB9B would crash foot ([#1901][1901]).
885[1901]: https://codeberg.org/dnkl/foot/issues/1901
888## 1.20.0
890### Added
892* Unicode data files updated to Unicode 16. Foot uses these to
893 determine which VS-15 and VS-16 sequences are valid, and which are
894 not.
895* Box drawing characters U+1CD00...U+1CDE5 (the _"octants"_ from the
896 _"Symbols for Legacy Computing Supplement"_ codepoint range, added
897 in Unicode 16.0).
898* `security.osc52` option, allowing you to partially or fully disable
899 host clipboard access via the OSC-52 escape sequence
900 ([#1867][1867]).
902[1867]: https://codeberg.org/dnkl/foot/issues/1867
905### Changed
907* OSC-9: sequences beginning with `<number>;` are now ignored. These
908 sequences are ConEmu/Windows Terminal sequences, and not intended to
909 be notifications.
910* Use `utf8proc_charwidth()` instead of `wcwidth()`+`wcswidth()` when
911 calculating character width, when foot has been built with utf8proc
912 support ([#1865][1865]).
913* Run-time changes to the window title, and the app ID now require the
914 new value to consist of printable characters only.
915* Kitty keyboard protocol: Enter, Tab and Backspace no longer report
916 _release_ events unless _"Report all keys as escape codes"_ is
917 enabled ([#1892][1892]).
919[1865]: https://codeberg.org/dnkl/foot/issues/1865
920[1892]: https://codeberg.org/dnkl/foot/issues/1892
923### Fixed
925* Crash when receiving an OSC-9 or OSC-777 with an empty notification
926 body ([#1866][1866]).
927* Crash when tripple-clicking on region containing `NUL` characters.
929[1866]: https://codeberg.org/dnkl/foot/issues/1866
932### Contributors
934* cy
935* Denis Zharikov
936* heather7283
937* Jack Wilsdon
938* Mark Stosberg
941## 1.19.0
943### Added
945* `resize-keep-grid` option, controlling whether the window is resized
946 (and the grid reflowed) or not when e.g. zooming in/out
947 ([#1807][1807]).
948* `strikeout-thickness` option.
949* Implemented the new `xdg-toplevel-icon-v1` protocol.
950* Implemented `CSI 21 t`: report window title.
951* `colors.sixelNN` option, controlling the default sixel color
952 palette.
954[1807]: https://codeberg.org/dnkl/foot/issues/1807
957### Changed
959* `cursor.unfocused-style` is now effective even when `cursor.style`
960 is not `block`.
961* Activating a notification triggered with OSC-777, or BEL, now
962 focuses the foot window, if XDG activation tokens are supported by
963 the compositor, the notification daemon, and the notification helper
964 used by foot (i.e. `desktop-notifications.command`). This has been
965 supported for OSC-99 since 1.18.0, and now we also support it for
966 BEL and OSC-777 ([#1822][1822]).
967* Sixel background color (when `P2=0|2`) is now set to the **sixel**
968 color palette entry #0, instead of using the current ANSI background
969 color. This is what a real VT340 does.
970* The `.desktop` files no longer use the reverse DNS naming scheme,
971 and their names now match the default app-ids used by foot (`foot`
972 and `footclient`) ([#1607][1607]).
973* `file://` prefix are now stripped from OSC-8 URIs when
974 activated/opened, **if** the hostname matches the hostname of the
975 computer foot is running on ([#1840][1840]).
977[1822]: https://codeberg.org/dnkl/foot/issues/1822
978[1607]: https://codeberg.org/dnkl/foot/issues/1607
979[1840]: https://codeberg.org/dnkl/foot/issues/1840
982### Fixed
984* Some invalid UTF-8 strings passing the validity check when setting
985 the window title, triggering a Wayland protocol error which then
986 caused foot to shutdown.
987* "Too large" values for `scrollback.lines` causing an integer
988 overflow, resulting in either visual glitches, crashes, or both
989 ([#1828][1828]).
990* Crash when trying to set an invalid cursor shape with OSC-22, when
991 foot uses server-side cursor shapes.
992* Occasional visual glitches when selecting text, when foot is running
993 under a compositor that forces foot to double buffer
994 (e.g. KDE/KWin) ([#1715][1715]).
995* Sixels flickering when foot is running under a compositor that
996 forces foot to double buffer (e.g. KDE, or Smithay based
997 compositors) ([#1851][1851]).
999[1828]: https://codeberg.org/dnkl/foot/issues/1828
1000[1715]: https://codeberg.org/dnkl/foot/issues/1715
1001[1851]: https://codeberg.org/dnkl/foot/issues/1851
1004### Contributors
1006* Andrew J. Hesford
1007* Craig Barnes
1008* Oleh Hushchenkov
1009* tokyo4j
1012## 1.18.1
1014### Added
1016* OSC-99: support for the `s` parameter. Supported keywords are
1017 `silent`, `system` and names from the freedesktop sound naming
1018 specification.
1019* `${muted}` and `${sound-name}` added to the
1020 `desktop-notifications.command` template.
1023### Changed
1025* CSD buttons now activate on mouse button **release**, rather than
1026 press ([#1787][1787]).
1028[1787]: https://codeberg.org/dnkl/foot/issues/1787
1031### Fixed
1033* Regression: OSC-111 not handling alpha changes correctly, causing
1034 visual glitches ([#1801][1801]).
1036[1801]: https://codeberg.org/dnkl/foot/issues/1801
1039### Contributors
1041* Craig Barnes
1042* Shogo Yamazaki
1045## 1.18.0
1047### Added
1049* `cursor.blink-rate` option, allowing you to configure the rate the
1050 cursor blinks with (when `cursor.blink=yes`) ([#1707][1707]);
1051* Support for `wp_single_pixel_buffer_v1`; certain overlay surfaces
1052 will now utilize the new single-pixel buffer protocol. This mainly
1053 reduces the memory usage, but should also be slightly faster.
1054* Support for high-res mouse wheel scroll events ([#1738][1738]).
1055* Styled and colored underlines ([#828][828]).
1056* Support for SGR 21 (double underline).
1057* Support for `XTPUSHCOLORS`, `XTPOPCOLORS` and `XTREPORTCOLORS`,
1058 i.e. color palette stack ([#856][856]).
1059* Log output now respects the [`NO_COLOR`](http://no-color.org/)
1060 environment variable ([#1771][1771]).
1061* Support for [in-band window resize
1062 notifications](https://gist.github.com/rockorager/e695fb2924d36b2bcf1fff4a3704bd83),
1063 private mode `2048`.
1064* Support for OSC-99 [_"Kitty desktop
1065 notifications"_](https://sw.kovidgoyal.net/kitty/desktop-notifications/).
1066* `desktop-notifications.command` option, replaces `notify`.
1067* `desktop-notifications.inhibit-when-focused` option, replaces
1068 `notify-focus-inhibit`.
1069* `${category}`, `${urgency}`, `${expire-time}`, `${replace-id}`,
1070 `${icon}` and `${action-argument}` added to the
1071 `desktop-notifications.command` template.
1072* `desktop-notifications.command-action-argument` option, defining how
1073 `${action-argument}` (in `desktop-notifications.command`) should be
1074 expanded.
1075* `desktop-notifications.close` option, defining what to execute when
1076 an application wants to close an existing notification (via an
1077 OSC-99 escape sequence).
1079[1707]: https://codeberg.org/dnkl/foot/issues/1707
1080[1738]: https://codeberg.org/dnkl/foot/issues/1738
1081[828]: https://codeberg.org/dnkl/foot/issues/828
1082[856]: https://codeberg.org/dnkl/foot/issues/856
1083[1771]: https://codeberg.org/dnkl/foot/issues/1771
1086### Changed
1088* All `XTGETTCAP` capabilities are now in the `tigetstr()` format:
1090 - parameterized string capabilities were previously "source
1091 encoded", meaning e.g. `\E` where not "decoded" into `\x1b`.
1092 - Control characters were also "source encoded", meaning they were
1093 returned as e.g. "^G" instead of `\x07` ([#1701][1701]).
1095 In other words, if, after this change, `XTGETTCAP` returns a string
1096 that is different compared to `tigetstr()`, then it is likely a bug
1097 in foot's implementation of `XTGETTCAP`.
1098* If the cursor foreground and background colors are identical (for
1099 example, when cursor uses inverted colors and the cell's foreground
1100 and background are the same), the cursor will instead be rendered
1101 using the default foreground and background colors, inverted
1102 ([#1761][1761]).
1103* Mouse wheel events now generate `BTN_WHEEL_BACK` and
1104 `BTN_WHEEL_FORWARD` "button presses", instead of `BTN_BACK` and
1105 `BTN_FORWARD`. The default bindings have been updated, and
1106 `scrollback-up-mouse`, `scrollback-down-mouse`, `font-increase` and
1107 `font-decrease` now use the new button names.
1109 This change allow users to separate physical mouse buttons that
1110 _also_ generates `BTN_BACK` and `BTN_FORWARD`, from wheel scrolling
1111 ([#1763][1763]).
1112* Replaced the old catppuccin theme with updated flavored themes
1113 pulled from [catppuccin/foot](https://github.com/catppuccin/foot)
1114* Mouse selections can now be started inside the margins
1115 ([#1702][1702]).
1117[1701]: https://codeberg.org/dnkl/foot/issues/1701
1118[1761]: https://codeberg.org/dnkl/foot/issues/1761
1119[1763]: https://codeberg.org/dnkl/foot/issues/1763
1120[1702]: https://codeberg.org/dnkl/foot/issues/1702
1123### Deprecated
1125* `notify` option; replaced by `desktop-notifications.command`.
1126* `notify-focus-inhibit` option; replaced by
1127 `desktop-notifications.inhibit-when-focused`.
1130### Fixed
1132* Crash when zooming in or out, with `dpi-aware=yes`, and the
1133 monitor's DPI is 0 (this is true for, for example, nested Wayland
1134 sessions, or in virtualized environments).
1135* No error response for empty `XTGETTCAP` request ([#1694][1694]).
1136* Unicode-mode in one foot client affecting other clients, in foot
1137 server mode ([#1717][1717]).
1138* IME interfering in URL-mode ([#1718][1718]).
1139* OSC-52 reply interleaved with other data sent to the client
1140 ([#1734][1734]).
1141* XKB compose state being reset when foot receives a new keymap
1142 ([#1744][1744]).
1143* Regression: alpha changes through OSC-11 sequences not taking effect
1144 until window is resized.
1145* VS15 being ignored ([#1742][1742]).
1146* VS16 being ignored for a subset of the valid VS16 sequences
1147 ([#1742][1742]).
1148* Crash in debug builds, when using OSC-12 to set the cursor color and
1149 foot config has not set any custom cursor colors (i.e. without
1150 OSC-12, inverted fg/bg would be used).
1151* Wrong color used when drawing the unfocused, hollow cursor.
1152* Encoding of `BTN_BACK` and `BTN_FORWARD`, when sending a mouse input
1153 escape sequence to the terminal application.
1155[1694]: https://codeberg.org/dnkl/foot/issues/1694
1156[1717]: https://codeberg.org/dnkl/foot/issues/1717
1157[1718]: https://codeberg.org/dnkl/foot/issues/1718
1158[1734]: https://codeberg.org/dnkl/foot/issues/1734
1159[1744]: https://codeberg.org/dnkl/foot/issues/1744
1160[1742]: https://codeberg.org/dnkl/foot/issues/1742
1163### Contributors
1165* abs3nt
1166* Artturin
1167* Craig Barnes
1168* Jan Beich
1169* Mariusz Bialonczyk
1170* Nicolas Kolling Ribas
1173## 1.17.2
1175### Changed
1177* Notifications with invalid UTF-8 strings are now ignored.
1180### Fixed
1182* Crash when changing aspect ratio of a sixel, in the middle of the
1183 sixel data (this is unsupported in foot, but should of course not
1184 result in a crash).
1185* Crash when printing double-width (or longer) characters to, or near,
1186 the last column, when auto-wrap (private mode 7) has been disabled.
1187* Dynamically sized sixel being trimmed to nothing.
1188* Flickering with `dpi-aware=yes` and window is unmapped/remapped
1189 (some compositors do this when window is minimized), in a
1190 multi-monitor setup with different monitor DPIs.
1193## 1.17.1
1195### Added
1197* `cursor.unfocused-style=unchanged|hollow|none` to `foot.ini`. The
1198 default is `hollow` ([#1582][1582]).
1199* New key binding: `quit` ([#1475][1475]).
1201[1582]: https://codeberg.org/dnkl/foot/issues/1582
1202[1475]: https://codeberg.org/dnkl/foot/issues/1475
1205### Fixed
1207* Log-level not respected by syslog.
1208* Regression: terminal shutting down when the PTY is closed by the
1209 client application, which may be earlier than when the client
1210 application exits ([#1666][1666]).
1211* When closing the window, send `SIGHUP` to the client application,
1212 before sending `SIGTERM`. The signal sequence is now `SIGHUP`, wait,
1213 `SIGTERM`, wait `SIGKILL`.
1214* Crash when receiving a `DECRQSS` request with more than 2 bytes in
1215 the `q` parameter.
1217[1666]: https://codeberg.org/dnkl/foot/issues/1666
1220### Contributors
1222* Holger Weiß
1223* izmyname
1224* Marcin Puc
1225* tunjan
1228## 1.17.0
1230### Added
1232- Support for opening an existing PTY, e.g. a VM console.
1233 ([#1564][1564])
1234* Unicode input mode now accepts input from the numpad as well,
1235 numlock is ignored.
1236* A new `resize-by-cells` option, enabled by default, allows the size
1237 of floating windows to be constrained to multiples of the cell size.
1238* Support for custom (i.e. other than ctrl/shift/alt/super) modifiers
1239 in key bindings ([#1348][1348]).
1240* `pipe-command-output` key binding.
1241* Support for OSC-176, _"Set App-ID"_
1242 (https://gist.github.com/delthas/d451e2cc1573bb2364839849c7117239).
1243* Support for `DECRQM` queries with ANSI/ECMA-48 modes (`CSI Ps $ p`).
1244* Rectangular edit functions: `DECCARA`, `DECRARA`, `DECCRA`, `DECFRA`
1245 and `DECERA` ([#1633][1633]).
1246* `Rect` capability to terminfo.
1247* `fe` and `fd` (focus in/out enable/disable) capabilities to
1248 terminfo.
1249* `nel` capability to terminfo.
1251[1348]: https://codeberg.org/dnkl/foot/issues/1348
1252[1633]: https://codeberg.org/dnkl/foot/issues/1633
1253[1564]: https://codeberg.org/dnkl/foot/pulls/1564
1254[`DECBKM`]: https://vt100.net/docs/vt510-rm/DECBKM.html
1257### Changed
1259* config: ARGB color values now default to opaque, rather than
1260 transparent, when the alpha component has been left out
1261 ([#1526][1526]).
1262* The `foot` process now changes CWD to `/` after spawning the shell
1263 process. This ensures the terminal itself does not "lock" a
1264 directory; for example, preventing a mount point from being
1265 unmounted ([#1528][1528]).
1266* Kitty keyboard protocol: updated behavior of modifiers bits during
1267 modifier key events, to match the (new [#6913][kitty-6913]) behavior
1268 in kitty >= 0.32.0 ([#1561][1561]).
1269* When changing font sizes or display scales in floating windows, the
1270 window will be resized as needed to preserve the same grid size.
1271* `smm` now disables private mode 1036 (_"send ESC when Meta modifies
1272 a key"_), and enables private mode 1034 (_"8-bit Meta mode"_). `rmm`
1273 does the opposite ([#1584][1584]).
1274* Grid is now always centered in the window, when either fullscreened
1275 or maximized.
1276* Ctrl+wheel up/down bound to `font-increase` and `font-decrease`
1277 respectively (in addition to the already existing default key
1278 bindings `ctrl-+` and `ctrl+-`).
1279* Use XRGB pixel format (instead of ARGB) when there is no
1280 transparency.
1281* Prefer CSS xcursor names, and fallback to legacy X11 names.
1282* Kitty keyboard protocol: use the `XKB` mode when retrieving locked
1283 modifiers, instead of the `GTK` mode. This fixes an issue where some
1284 key combinations (e.g. Shift+space) produces different results
1285 depending on the state of e.g. the NumLock key.
1286* Kitty keyboard protocol: filter out **all** locked modifiers (as
1287 reported by XKB), rather than hardcoding it to CapsLock only, when
1288 determining whether a key combination produces text or not.
1289* CSI-t queries now report pixel values **unscaled**, instead of
1290 **scaled** ([#1643][1643]).
1291* Sixel: text cursor is now placed on the last text row touched by the
1292 sixel, instead of the text row touched by the _upper_ pixel of the
1293 last sixel ([#chafa-192][chafa-192]).
1294* Sixel: trailing, fully transparent rows are now trimmed
1295 ([#chafa-192][chafa-192]).
1296* `1004` (enable focus in/out events) removed from the `XM` terminfo
1297 capability. To enable focus in/out, use the `fe` and `fd`
1298 capabilities instead.
1299* Tightened the regular expression in the `rv` terminfo capability.
1300* Tightened the regular expression in the `xr` terminfo capability.
1301* `DECRQM` queries for private mode 67 ([`DECBKM`]) now reply with mode
1302 value 4 ("permanently reset") instead of 0 ("not recognized").
1304[1526]: https://codeberg.org/dnkl/foot/issues/1526
1305[1528]: https://codeberg.org/dnkl/foot/issues/1528
1306[1561]: https://codeberg.org/dnkl/foot/issues/1561
1307[kitty-6913]: https://github.com/kovidgoyal/kitty/issues/6913
1308[1584]: https://codeberg.org/dnkl/foot/issues/1584
1309[1643]: https://codeberg.org/dnkl/foot/issues/1643
1310[chafa-192]: https://github.com/hpjansson/chafa/issues/192
1313### Fixed
1315* config: improved validation of color values.
1316* config: double close of file descriptor, resulting in a chain of
1317 errors ultimately leading to a startup failure ([#1531][1531]).
1318* Crash when using a desktop scaling factor > 1, on compositors that
1319 implements neither the `fractional-scale-v1`, nor the
1320 `cursor-shape-v1` Wayland protocols ([#1573][1573]).
1321* Crash in `--server` mode when one or more environment variables are
1322 set in `[environment]`.
1323* Environment variables normally set by foot lost with `footclient
1324 -E,--client-environment` ([#1568][1568]).
1325* XDG toplevel protocol violation, by trying to set a title that
1326 contains an invalid UTF-8 sequence ([#1552][1552]).
1327* Crash when erasing the scrollback, when scrollback history is
1328 exactly 0 rows. This happens when `[scrollback].line = 0`, and the
1329 window size (number of rows) is a power of two (i.e. 2, 4, 8, 16
1330 etc) ([#1610][1610]).
1331* VS16 (variation selector 16 - emoji representation) should only
1332 affect emojis.
1333* Pressing a modifier key while the kitty keyboard protocol is enabled
1334 no longer resets the viewport, or clears the selection.
1335* Crash when failing to load an xcursor image ([#1624][1624]).
1336* Crash when resizing a dynamically sized sixel (no raster
1337 attributes), with a non-1:1 aspect ratio.
1338* The default sixel color table is now initialized to the colors used
1339 by the VT340, instead of not being initialized at all (thus
1340 requiring the sixel escape sequence to explicitly set all colors it
1341 used).
1343[1531]: https://codeberg.org/dnkl/foot/issues/1531
1344[1573]: https://codeberg.org/dnkl/foot/issues/1573
1345[1568]: https://codeberg.org/dnkl/foot/issues/1568
1346[1552]: https://codeberg.org/dnkl/foot/issues/1552
1347[1610]: https://codeberg.org/dnkl/foot/issues/1610
1348[1624]: https://codeberg.org/dnkl/foot/issues/1624
1351### Contributors
1353* Alyssa Ross
1354* Andrew J. Hesford
1355* Artturin
1356* Craig Barnes
1357* delthas
1358* eugenrh
1359* Fazzi
1360* Gregory Anders
1361* Jan Palus
1362* Leonardo Hernández Hernández
1363* LmbMaxim
1364* Matheus Afonso Martins Moreira
1365* Sivecano
1366* Tim Culverhouse
1367* xnuk
1370## 1.16.2
1372### Fixed
1374* Last row and/or column of opaque sixels (not having a size that is a
1375 multiple of the cell size) being the wrong color ([#1520][1520]).
1377[1520]: https://codeberg.org/dnkl/foot/issues/1520
1380## 1.16.1
1382### Fixed
1384* Foot not starting on linux kernels before 6.3 ([#1514][1514]).
1385* Cells underneath erased sixels not being repainted ([#1515][1515]).
1387[1514]: https://codeberg.org/dnkl/foot/issues/1514
1388[1515]: https://codeberg.org/dnkl/foot/issues/1515
1391## 1.16.0
1393### Added
1395* Support for building with _wayland-protocols_ as a subproject.
1396* Mouse wheel scrolls can now be used in `mouse-bindings`
1397 ([#1077][1077]).
1398* New mouse bindings: `scrollback-up-mouse` and
1399 `scrollback-down-mouse`, bound to `BTN_BACK` and `BTN_FORWARD`
1400 respectively.
1401* New key binding: `select-quote`. This key binding selects text
1402 between quote characters, and falls back to selecting the entire
1403 row ([#1364][1364]).
1404* Support for DECSET/DECRST/DECRQM 2027 (_Grapheme cluster
1405 processing_).
1406* New **search mode** key bindings (along with their defaults)
1407 ([#419][419]):
1408 - `extend-char` (shift+right)
1409 - `extend-line-down` (shift+down)
1410 - `extend-backward-char` (shift+left)
1411 - `extend-backward-to-word-boundary` (ctrl+shift+left)
1412 - `extend-backward-to-next-whitespace` (none)
1413 - `extend-line-up` (shift+up)
1414 - `scrollback-up-page` (shift+page-up)
1415 - `scrollback-up-half-page` (none)
1416 - `scrollback-up-line` (none)
1417 - `scrollback-down-page` (shift+page-down)
1418 - `scrollback-down-half-page` (none)
1419 - `scrollback-down-line` (none)
1420* Support for visual bell which flashes the terminal window.
1421 ([#1337][1337]).
1423[1077]: https://codeberg.org/dnkl/foot/issues/1077
1424[1364]: https://codeberg.org/dnkl/foot/issues/1364
1425[419]: https://codeberg.org/dnkl/foot/issues/419
1426[1337]: https://codeberg.org/dnkl/foot/issues/1337
1429### Changed
1431* Minimum required version of _wayland-protocols_ is now 1.32
1432 ([#1391][1391]).
1433* `foot-server.service` systemd now checks for
1434 `ConditionEnvironment=WAYLAND_DISPLAY` for consistency with the
1435 socket unit ([#1448][1448])
1436* Default key binding for `select-row` is now `BTN_LEFT+4`. However,
1437 in many cases, triple clicking will still be enough to select the
1438 entire row; see the new key binding `select-quote` (mapped to
1439 `BTN_LEFT+3` by default) ([#1364][1364]).
1440* `file://` prefix from URI's are no longer stripped when
1441 opened/activated ([#1474][1474]).
1442* `XTGETTCAP` with capabilities that are not properly hex encoded will
1443 be ignored, instead of echo:ed back to the TTY in an error response.
1444* Command line configuration overrides are now applied even if the
1445 configuration file does not exist or can't be
1446 parsed. ([#1495][1495]).
1447* Wayland surface damage is now more fine-grained. This should result
1448 in lower latencies in many use cases, especially on high DPI
1449 monitors.
1451[1391]: https://codeberg.org/dnkl/foot/issues/1391
1452[1448]: https://codeberg.org/dnkl/foot/pulls/1448
1453[1474]: https://codeberg.org/dnkl/foot/pulls/1474
1454[1495]: https://codeberg.org/dnkl/foot/pulls/1495
1457### Removed
1459* `utempter` config option (was deprecated in 1.15.0).
1462### Fixed
1464* Race condition for systemd units start in GNOME and KDE
1465 ([#1436][1436]).
1466* One frame being rendered at the wrong scale after being hidden by
1467 another opaque, maximized window ([#1464][1464]).
1468* Double-width characters, and grapheme clusters breaking URL
1469 auto-detection ([#1465][1465]).
1470* Crash when `XDG_ACTIVATION_TOKEN` is set, but compositor does not
1471 support XDG activation ([#1493][1493]).
1472* Crash when compositor calls `fractional_scale::preferred_scale()`
1473 when there are no monitors (for example, after a monitor has been
1474 turned off and then back on again) ([#1498][1498]).
1475* Transparency in margins (padding) not being disabled in fullscreen
1476 mode ([#1503][1503]).
1477* Crash when a scrollback search match is in the last column.
1478* Scrollback search: grapheme clusters not matching correctly.
1479* Wrong baseline offset for some fonts ([#1511][1511]).
1481[1436]: https://codeberg.org/dnkl/foot/issues/1436
1482[1464]: https://codeberg.org/dnkl/foot/issues/1464
1483[1465]: https://codeberg.org/dnkl/foot/issues/1465
1484[1493]: https://codeberg.org/dnkl/foot/pulls/1493
1485[1498]: https://codeberg.org/dnkl/foot/issues/1498
1486[1503]: https://codeberg.org/dnkl/foot/issues/1503
1487[1511]: https://codeberg.org/dnkl/foot/issues/1511
1489### Contributors
1491* 6t8k
1492* Alyssa Ross
1493* CismonX
1494* Max Gautier
1495* raggedmyth
1496* Raimund Sacherer
1497* Sertonix
1500## 1.15.3
1502### Fixed
1504* `-f,--font` command line option not affecting `csd.font` (if unset).
1505* Vertical alignment in URL jump labels, and the scrollback position
1506 indicator. The fix in 1.15.2 was incorrect, and was reverted in the
1507 last minute. But we forgot to remove the entry from the changelog
1508 ([#1430][1430]).
1511## 1.15.2
1513### Added
1515* `[tweak].bold-text-in-bright-amount` option ([#1434][1434]).
1516* `-Dterminfo-base-name` meson option, allowing you to name the
1517 terminfo files to something other than `-Ddefault-terminfo`. Use
1518 case: have foot default to using the terminfo from ncurses (`foot`,
1519 `foot-direct`), while still packaging foot's terminfo files, but
1520 under a different name (e.g. `foot-extra`, `foot-extra-direct`).
1522[1434]: https://codeberg.org/dnkl/foot/issues/1434
1525### Fixed
1527* Crash when copying text that contains invalid UTF-8 ([#1423][1423]).
1528* Wrong font size after suspending the monitor ([#1431][1431]).
1529* Vertical alignment in URL jump labels, and the scrollback position
1530 indicator ([#1430][1430]).
1531* Regression: line- and box drawing characters not covering the full
1532 height of the line, when a custom `line-height` is being used
1533 ([#1430][1430]).
1534* Crash when compositor does not implement the _viewporter_ interface
1535 ([#1444][1444]).
1536* CSD rendering with fractional scaling ([#1441][1441]).
1537* Regression: crash with certain combinations of
1538 `--window-size-chars=NxM` and desktop scaling factors
1539 ([#1446][1446]).
1541[1423]: https://codeberg.org/dnkl/foot/issues/1423
1542[1431]: https://codeberg.org/dnkl/foot/issues/1431
1543[1430]: https://codeberg.org/dnkl/foot/issues/1430
1544[1444]: https://codeberg.org/dnkl/foot/issues/1444
1545[1441]: https://codeberg.org/dnkl/foot/issues/1441
1546[1446]: https://codeberg.org/dnkl/foot/issues/1446
1549## 1.15.1
1551### Changed
1553* When window is mapped, use metadata (DPI, scaling factor, subpixel
1554 configuration) from the monitor we were most recently mapped on,
1555 instead of the one least recently.
1556* Starlight theme (the default theme) updated to [V4][starlight-v4]
1557* Background transparency (alpha) is now disabled in fullscreened
1558 windows ([#1416][1416]).
1559* Foot server systemd units now use the standard
1560 graphical-session.target ([#1281][1281]).
1561* If `$XDG_RUNTIME_DIR/foot-$WAYLAND_DISPLAY.sock` does not exist,
1562 `footclient` now tries `$XDG_RUNTIME_DIR/foot.sock`, then
1563 `/tmp/foot.sock`, even if `$WAYLAND_DISPLAY` and/or
1564 `$XDG_RUNTIME_DIR` are defined ([#1281][1281]).
1565* Font baseline calculation: try to center the text within the line,
1566 instead of anchoring it at the top ([#1302][1302]).
1568[starlight-v4]: https://github.com/CosmicToast/starlight/blob/v4/CHANGELOG.md#v4
1569[1416]: https://codeberg.org/dnkl/foot/issues/1416
1570[1281]: https://codeberg.org/dnkl/foot/pulls/1281
1571[1302]: https://codeberg.org/dnkl/foot/issues/1302
1574### Fixed
1576* Use appropriate rounding when applying fractional scales.
1577* Xcursor not being scaled correctly on `fractional-scale-v1` capable
1578 compositors.
1579* `dpi-aware=yes` being broken on `fractional-scale-v1` capable
1580 compositors (and when a fractional scaling factor is being used)
1581 ([#1404][1404]).
1582* Initial font size being wrong on `fractional-scale-v1` capable
1583 compositors, with multiple monitors with different scaling factors
1584 connected ([#1404][1404]).
1585* Crash when _pointer capability_ is removed from a seat, on
1586 compositors without `cursor-shape-v1 support` ([#1411][1411]).
1587* Crash on exit, if the mouse is hovering over the foot window (does
1588 not happen on all compositors)
1589* Visual glitches when CSD titlebar is transparent.
1591[1404]: https://codeberg.org/dnkl/foot/issues/1404
1592[1411]: https://codeberg.org/dnkl/foot/pulls/1411
1595### Contributors
1597* Ayush Agarwal
1598* CismonX
1599* Max Gautier
1600* Ronan Pigott
1601* xdavidwu
1604## 1.15.0
1606### Added
1608* VT: implemented `XTQMODKEYS` query (`CSI ? Pp m`).
1609* Meson option `utmp-backend=none|libutempter|ulog|auto`. The default
1610 is `auto`, which will select `libutempter` on Linux, `ulog` on
1611 FreeBSD, and `none` for all others.
1612* Sixel aspect ratio.
1613* Support for the new `fractional-scale-v1` Wayland protocol. This
1614 brings true fractional scaling to Wayland in general, and with this
1615 release, to foot.
1616* Support for the new `cursor-shape-v1` Wayland protocol, i.e. server
1617 side cursor shapes ([#1379][1379]).
1618* Support for touchscreen input ([#517][517]).
1619* `csd.double-click-to-maximize` option to `foot.ini`. Defaults to
1620 `yes` ([#1293][1293]).
1622[1379]: https://codeberg.org/dnkl/foot/issues/1379
1623[517]: https://codeberg.org/dnkl/foot/issues/517
1624[1293]: https://codeberg.org/dnkl/foot/issues/1293
1627### Changed
1629* Default color theme is now
1630 [starlight](https://github.com/CosmicToast/starlight)
1631 ([#1321][1321]).
1632* Minimum required meson version is now 0.59 ([#1371][1371]).
1633* `Control+Shift+u` is now bound to `unicode-input` instead of
1634 `show-urls-launch`, to follow the convention established in GTK and
1635 Qt ([#1183][1183]).
1636* `show-urls-launch` now bound to `Control+Shift+o` ([#1183][1183]).
1637* Kitty keyboard protocol: F3 is now encoded as `CSI 13~` instead of
1638 `CSI R`. The kitty keyboard protocol originally allowed F3 to be
1639 encoded as `CSI R`, but this was removed from the specification
1640 since `CSI R` conflicts with the _"Cursor Position Report"_.
1641* `[main].utempter` renamed to `[main].utmp-helper`. The old option
1642 name is still recognized, but will log a deprecation warning.
1643* Meson option `default-utempter-path` renamed to
1644 `utmp-default-helper-path`.
1645* Opaque sixels now retain the background opacity (when current
1646 background color is the **default** background color)
1647 ([#1360][1360]).
1648* Text cursor's vertical position after emitting a sixel, when sixel
1649 scrolling is **enabled** (the default) has been updated to match
1650 XTerm's, and the VT382's behavior: the cursor is positioned **on**
1651 the last sixel row, rather than _after_ it. This allows printing
1652 sixels on the last row without scrolling up, but also means
1653 applications may have to explicitly emit a newline to ensure the
1654 sixel is visible. For example, `cat`:ing a sixel in the shell will
1655 typically result in the last row not being visible, unless a newline
1656 is explicitly added.
1657* Default sixel aspect ratio is now 2:1 instead of 1:1.
1658* Sixel images are no longer cropped to the last non-transparent row.
1659* Sixel images are now re-scaled when the font size is changed
1660 ([#1383][1383]).
1661* `dpi-aware` now defaults to `no`, and the `auto` value has been
1662 removed.
1663* When using custom cursor colors (`cursor.color` is set in
1664 `foot.ini`), the cursor is no longer inverted when the cell is
1665 selected, or when the cell has the `reverse` (SGR 7) attribute set
1666 ([#1347][1347]).
1668[1321]: https://codeberg.org/dnkl/foot/issues/1321
1669[1371]: https://codeberg.org/dnkl/foot/pulls/1371
1670[1183]: https://codeberg.org/dnkl/foot/issues/1183
1671[1360]: https://codeberg.org/dnkl/foot/issues/1360
1672[1383]: https://codeberg.org/dnkl/foot/issues/1383
1673[1347]: https://codeberg.org/dnkl/foot/issues/1347
1676### Deprecated
1678* `[main].utempter` option.
1681### Removed
1683* `auto` value for the `dpi-aware` option.
1686### Fixed
1688* Incorrect icon in dock and window switcher on Gnome ([#1317][1317])
1689* Crash when scrolling after resizing the window with non-zero
1690 scrolling regions.
1691* `XTMODKEYS` state not being reset on a terminal reset.
1692* In Gnome dock foot always groups under "foot client". Change
1693 instances of footclient and foot to appear as "foot client" and
1694 "foot" respectively. ([#1355][1355]).
1695* Glitchy rendering when alpha (transparency) is changed between
1696 opaque and non-opaque at runtime (using OSC-11).
1697* Regression: crash when resizing the window when `resize-delay-ms >
1698 0` ([#1377][1377]).
1699* Crash when scrolling up while running something that generates a lot
1700 of output (for example, `yes`) ([#1380][1380]).
1701* Default key binding for URL mode conflicting with Unicode input on
1702 some DEs; `show-urls-launched` is now mapped to `Control+Shift+o` by
1703 default, instead of `Control+Shift+u` ([#1183][1183]).
1705[1317]: https://codeberg.org/dnkl/foot/issues/1317
1706[1355]: https://codeberg.org/dnkl/foot/issues/1355
1707[1377]: https://codeberg.org/dnkl/foot/issues/1377
1708[1380]: https://codeberg.org/dnkl/foot/issues/1380
1711### Contributors
1713* Antoine Beaupré
1714* CismonX
1715* Craig Barnes
1716* Dan Bungert
1717* jdevdevdev
1718* Kyle Gunger
1719* locture
1720* Phillip Susi
1721* sewn
1722* ShugarSkull
1723* Vivian Szczepanski
1724* Vladimir Bauer
1725* wout
1726* CosmicToast
1729## 1.14.0
1731### Added
1733* Support for adjusting the thickness of regular underlines ([#1136][1136]).
1734* Support (optional) for utmp logging with libutempter.
1735* `kxIN` and `kxOUT` (focus in/out events) to terminfo.
1736* `name` capability to `XTGETTCAP`.
1737* String values in `foot.ini` may now be quoted. This can be used to
1738 set a value to the empty string, for example.
1739* Environment variables can now be **unset**, by setting
1740 `[environment].<variable>=""` (quotes are required) ([#1225][1225]).
1741* `font-size-adjustment=N[px]` option, letting you configure how much
1742 to increment/decrement the font size when zooming in or out
1743 ([#1188][1188]).
1744* Bracketed paste terminfo entries (`BD`, `BE`, `PE` and `PS`, added
1745 to ncurses in 2022-12-24). Vim makes use of these.
1746* "Report version" terminfo entries (`XR`/`xr`).
1747* "Report DA2" terminfo entries (`RV`/`rv`).
1748* `XF` terminfo capability (focus in/out events available).
1749* `$TERM_PROGRAM` and `$TERM_PROGRAM_VERSION` environment variables
1750 unset in the slave process.
1752[1136]: https://codeberg.org/dnkl/foot/issues/1136
1753[1225]: https://codeberg.org/dnkl/foot/issues/1225
1754[1188]: https://codeberg.org/dnkl/foot/issues/1188
1757### Changed
1759* Default color theme from a variant of the Zenburn theme, to a
1760 variant of the Solarized dark theme.
1761* Default `pad` from 2x2 to 0x0 (i.e. no padding at all).
1762* Current working directory (as set by OSC-7) is now passed to the
1763 program executed by the `pipe-*` key bindings ([#1166][1166]).
1764* `DECRPM` replies (to `DECRQM` queries) now report a value of `4`
1765 ("permanently reset") instead of `2` ("reset") for DEC private
1766 modes that are known but unsupported.
1767* Set `PWD` environment variable in the slave process ([#1179][1179]).
1768* DPI is now forced to 96 when found to be unreasonably high.
1769* Set default log level to warning ([#1215][1215]).
1770* Default `grapheme-width-method` from `wcswidth` to `double-width`.
1771* When determining initial font size, do FontConfig config
1772 substitution if the user-provided font pattern has no {pixel}size
1773 option ([#1287][1287]).
1774* DECRST of DECCOLM and DECSCLM removed from terminfo.
1776[1166]: https://codeberg.org/dnkl/foot/issues/1166
1777[1179]: https://codeberg.org/dnkl/foot/issues/1179
1778[1215]: https://codeberg.org/dnkl/foot/pulls/1215
1779[1287]: https://codeberg.org/dnkl/foot/issues/1287
1782### Fixed
1784* Crash in `foot --server` on key press, after another `footclient`
1785 has terminated very early (for example, by trying to launch a
1786 non-existing shell/client).
1787* Glitchy rendering when scrolling in the scrollback, on compositors
1788 that does not allow Wayland buffer reuse (e.g. KDE/plasma)
1789 ([#1173][1173])
1790* Scrollback search matches not being highlighted correctly, on
1791 compositors that does not allow Wayland buffer reuse
1792 (e.g. KDE/plasma).
1793* Nanosecs "overflow" when calculating timeout value for
1794 `resize-delay-ms` option.
1795* Missing backslash in ST terminator in escape sequences in the
1796 built-in terminfo (accessed via XTGETTCAP).
1797* Crash when interactively resizing the window with a very large
1798 scrollback.
1799* Crash when a sixel image exceeds the current sixel max height.
1800* Crash after reverse-scrolling (`CSI Ps T`) in the 'normal'
1801 (non-alternate) screen ([#1190][1190]).
1802* Background transparency being applied to the text "behind" the
1803 cursor. Only applies to block cursor using inversed fg/bg
1804 colors. ([#1205][1205]).
1805* Crash when monitor's physical size is "too small" ([#1209][1209]).
1806* Line-height adjustment when incrementing/decrementing the font size
1807 with a user-set line-height ([#1218][1218]).
1808* Scaling factor not being correctly applied when converting pt-or-px
1809 config values (e.g. letter offsets, line height etc).
1810* Selection being stuck visually when `IL` and `DL`.
1811* URL underlines sometimes still being visible after exiting URL mode.
1812* Text-bindings, and pipe-* bindings, with multiple key mappings
1813 causing a crash (double-free) on exit ([#1259][1259]).
1814* Double-width glyphs glitching when surrounded by glyphs overflowing
1815 into the double-width glyph ([#1256][1256]).
1816* Wayland protocol violation when ack:ing a configure event for an
1817 unmapped surface ([#1249][1249]).
1818* `xdg_toplevel::set_min_size()` not being called.
1819* Key bindings with consumed modifiers masking other key bindings
1820 ([#1280][1280]).
1821* Multi-character compose sequences with the kitty keyboard protocol
1822 ([#1288][1288]).
1823* Crash when application output scrolls very fast, e.g. `yes`
1824 ([#1305][1305]).
1825* Crash when application scrolls **many** lines (> ~2³¹).
1826* DECCOLM erasing the screen ([#1265][1265]).
1828[1173]: https://codeberg.org/dnkl/foot/issues/1173
1829[1190]: https://codeberg.org/dnkl/foot/issues/1190
1830[1205]: https://codeberg.org/dnkl/foot/issues/1205
1831[1209]: https://codeberg.org/dnkl/foot/issues/1209
1832[1218]: https://codeberg.org/dnkl/foot/issues/1218
1833[1259]: https://codeberg.org/dnkl/foot/issues/1259
1834[1256]: https://codeberg.org/dnkl/foot/issues/1256
1835[1249]: https://codeberg.org/dnkl/foot/issues/1249
1836[1280]: https://codeberg.org/dnkl/foot/issues/1280
1837[1288]: https://codeberg.org/dnkl/foot/issues/1288
1838[1305]: https://codeberg.org/dnkl/foot/issues/1305
1839[1265]: https://codeberg.org/dnkl/foot/issues/1265
1842### Contributors
1844* Alexey Sakovets
1845* Andrea Pappacoda
1846* Antoine Beaupré
1847* argosatcore
1848* Craig Barnes
1849* EuCaue
1850* Grigory Kirillov
1851* Harri Nieminen
1852* Hugo Osvaldo Barrera
1853* jaroeichler
1854* Joakim Nohlgård
1855* Nick Hastings
1856* Soren A D
1857* Torsten Trautwein
1858* Vladimír Magyar
1859* woojiq
1860* Yorick Peterse
1863## 1.13.1
1865### Changed
1867* Window is now dimmed while in Unicode input mode.
1870### Fixed
1872* Compiling against wayland-protocols < 1.25
1873* Crash on buggy compositors (GNOME) that sometimes send pointer-enter
1874 events with a NULL surface. Foot now ignores these events, and the
1875 subsequent motion and leave events.
1876* Regression: "random" selected empty cells being highlighted as
1877 selected when they should not.
1878* Crash when either resizing the terminal window, or scrolling in the
1879 scrollback history ([#1074][1074])
1880* OSC-8 URLs with matching IDs, but mismatching URIs being incorrectly
1881 connected.
1883[1074]: https://codeberg.org/dnkl/foot/pulls/1074
1886## 1.13.0
1888### Added
1890* XDG activation support when opening URLs ([#1058][1058]).
1891* `-Dsystemd-units-dir=<path>` meson command line option.
1892* Support for custom environment variables in `foot.ini`
1893 ([#1070][1070]).
1894* Support for jumping to previous/next prompt (requires shell
1895 integration). By default bound to `ctrl`+`shift`+`z` and
1896 `ctrl`+`shift`+`x` respectively ([#30][30]).
1897* `colors.search-box-no-match` and `colors.search-box-match` options
1898 to `foot.ini` ([#1112][1112]).
1899* Very basic Unicode input mode via the new
1900 `key-bindings.unicode-input` and `search-bindings.unicode-input` key
1901 bindings. Note that there is no visual feedback, as the preferred
1902 way of entering Unicode characters is with an IME ([#1116][1116]).
1903* Support for `xdg_toplevel.wm_capabilities`, to adapt the client-side
1904 decoration buttons to the compositor capabilities ([#1061][1061]).
1906[1058]: https://codeberg.org/dnkl/foot/issues/1058
1907[1070]: https://codeberg.org/dnkl/foot/issues/1070
1908[30]: https://codeberg.org/dnkl/foot/issues/30
1909[1112]: https://codeberg.org/dnkl/foot/issues/1112
1910[1116]: https://codeberg.org/dnkl/foot/issues/1116
1911[1061]: https://codeberg.org/dnkl/foot/pulls/1061
1914### Changed
1916* Use `$HOME` instead of `getpwuid()` to retrieve the user's home
1917 directory when searching for `foot.ini`.
1918* HT, VT and FF are no longer stripped when pasting in non-bracketed
1919 mode ([#1084][1084]).
1920* NUL is now stripped when pasting in non-bracketed mode
1921 ([#1084][1084]).
1922* `alt`+`escape` now emits `\E\E` instead of a `CSI 27` sequence
1923 ([#1105][1105]).
1925[1084]: https://codeberg.org/dnkl/foot/issues/1084
1926[1105]: https://codeberg.org/dnkl/foot/issues/1105
1929### Fixed
1931* Graphical corruption when viewport is at the top of the scrollback,
1932 and the output is scrolling.
1933* Improved text reflow of logical lines with trailing empty cells
1934 ([#1055][1055])
1935* IME focus is now tracked independently from keyboard focus.
1936* Workaround for buggy compositors (e.g. some versions of GNOME)
1937 allowing drag-and-drops even though foot has reported it does not
1938 support the offered mime-types ([#1092][1092]).
1939* Keyboard enter/leave events being ignored if there is no keymap
1940 ([#1097][1097]).
1941* Crash when application emitted an invalid `CSI 38;5;<idx>m`, `CSI
1942 38:5:<idx>m`, `CSI 48;5;<idx>m` or `CSI 48:5:<idx>m` sequence
1943 ([#1111][1111]).
1944* Certain dead-key combinations resulting in different escape
1945 sequences compared to kitty, when the kitty keyboard protocol is
1946 used ([#1120][1120]).
1947* Search matches ending with a double-width character not being
1948 highlighted correctly.
1949* Selection not being cancelled correctly when scrolled out.
1950* Extending a multi-page selection behaving inconsistently.
1951* Poor performance when making very large selections ([#1114][1114]).
1952* Bogus error message when using systemd socket activation for server
1953 mode ([#1107][1107])
1954* Empty line at the bottom after a window resize ([#1108][1108]).
1956[1055]: https://codeberg.org/dnkl/foot/issues/1055
1957[1092]: https://codeberg.org/dnkl/foot/issues/1092
1958[1097]: https://codeberg.org/dnkl/foot/issues/1097
1959[1111]: https://codeberg.org/dnkl/foot/issues/1111
1960[1120]: https://codeberg.org/dnkl/foot/issues/1120
1961[1114]: https://codeberg.org/dnkl/foot/issues/1114
1962[1107]: https://codeberg.org/dnkl/foot/issues/1107
1963[1108]: https://codeberg.org/dnkl/foot/issues/1108
1966### Contributors
1968* Craig Barnes
1969* Lorenz
1970* Max Gautier
1971* Simon Ser
1972* Stefan Prosiegel
1975## 1.12.1
1977### Added
1979* Workaround for Sway bug [#6960][sway-6960]: scrollback search and
1980 the OSC-555 ("flash") escape sequence leaves dimmed (search) and
1981 yellow (flash) artifacts ([#1046][1046]).
1982* `Control+Shift+v` and `XF86Paste` have been added to the default set
1983 of key bindings that paste from the clipboard into the scrollback
1984 search buffer. This is in addition to the pre-existing `Control+v`
1985 and `Control+y` bindings.
1987[sway-6960]: https://github.com/swaywm/sway/issues/6960
1988[1046]: https://codeberg.org/dnkl/foot/issues/1046
1991### Changed
1993* Scrollback search's `extend-to-word-boundary` no longer stops at
1994 space-to-word boundaries, making selection extension feel more
1995 natural.
1998### Fixed
2000* build: missing symbols when linking the `pgo` helper binary.
2001* UI not refreshing when pasting something into the scrollback search
2002 box, that does not result in a grid update (for example, when the
2003 search criteria did not result in any matches) ([#1040][1040]).
2004* foot freezing in scrollback search mode, using 100% CPU
2005 ([#1036][1036], [#1047][1047]).
2006* Crash when extending a selection to the next word boundary in
2007 scrollback search mode ([#1036][1036]).
2008* Scrollback search mode not always highlighting all matches
2009 correctly.
2010* Sixel options not being reset on hard resets (`\Ec`)
2012[1040]: https://codeberg.org/dnkl/foot/issues/1040
2013[1036]: https://codeberg.org/dnkl/foot/issues/1036
2014[1047]: https://codeberg.org/dnkl/foot/issues/1047
2017## 1.12.0
2019### Added
2021* OSC-22 - set xcursor pointer.
2022* Add "xterm" as fallback cursor where "text" is not available.
2023* `[key-bindings].scrollback-home|end` options.
2024* Socket activation for `foot --server` and accompanying systemd unit
2025 files
2026* Support for re-mapping input, i.e. mapping input to custom escape
2027 sequences ([#325][325]).
2028* Support for [DECNKM](https://vt100.net/docs/vt510-rm/DECNKM.html),
2029 which allows setting/saving/restoring/querying the keypad mode.
2030* Sixel support can be disabled by setting `[tweak].sixel=no`
2031 ([#950][950]).
2032* footclient: `-E,--client-environment` command line option. When
2033 used, the child process in the new terminal instance inherits the
2034 environment from the footclient process instead of the server's
2035 ([#1004][1004]).
2036* `[csd].hide-when-maximized=yes|no` option ([#1019][1019]).
2037* Scrollback search mode now highlights all matches.
2038* `[key-binding].show-urls-persistent` action. This key binding action
2039 is similar to `show-urls-launch`, but does not automatically exit
2040 URL mode after activating an URL ([#964][964]).
2041* Support for `CSI > 4 n`, disable _modifyOtherKeys_. Note that since
2042 foot only supports level 1 and 2 (and not level 0), this sequence
2043 does not disable _modifyOtherKeys_ completely, but simply reverts it
2044 back to level 1 (the default).
2045* `-Dtests=false|true` meson command line option. When disabled, test
2046 binaries will neither be built, nor will `ninja test` attempt to
2047 execute them. Enabled by default ([#919][919]).
2049[325]: https://codeberg.org/dnkl/foot/issues/325
2050[950]: https://codeberg.org/dnkl/foot/issues/950
2051[1004]: https://codeberg.org/dnkl/foot/issues/1004
2052[1019]: https://codeberg.org/dnkl/foot/issues/1019
2053[964]: https://codeberg.org/dnkl/foot/issues/964
2054[919]: https://codeberg.org/dnkl/foot/issues/919
2057### Changed
2059* Minimum required meson version is now 0.58.
2060* Mouse selections are now finalized when the window is resized
2061 ([#922][922]).
2062* OSC-4 and OSC-11 replies now uses four digits instead of 2
2063 ([#971][971]).
2064* `\r` is no longer translated to `\n` when pasting clipboard data
2065 ([#980][980]).
2066* Use circles for rendering light arc box-drawing characters
2067 ([#988][988]).
2068* Example configuration is now installed to
2069 `${sysconfdir}/xdg/foot/foot.ini`, typically resolving to
2070 `/etc/xdg/foot/foot.ini` ([#1001][1001]).
2072[922]: https://codeberg.org/dnkl/foot/issues/922
2073[971]: https://codeberg.org/dnkl/foot/issues/971
2074[980]: https://codeberg.org/dnkl/foot/issues/980
2075[988]: https://codeberg.org/dnkl/foot/issues/988
2076[1001]: https://codeberg.org/dnkl/foot/issues/1001
2079### Removed
2081* DECSET mode 27127 (which was first added in release 1.6.0).
2082 The kitty keyboard protocol (added in release 1.10.3) can
2083 be used to similar effect.
2086### Fixed
2088* Build: missing `wayland_client` dependency in `test-config`
2089 ([#918][918]).
2090* "(null)" being logged as font-name (for some fonts) when warning
2091 about a non-monospaced primary font.
2092* Rare crash when the window is resized while a mouse selection is
2093 ongoing ([#922][922]).
2094* Large selections crossing the scrollback wrap-around ([#924][924]).
2095* Crash in `pipe-scrollback` ([#926][926]).
2096* Exit code being 0 when a foot server with no open windows terminate
2097 due to e.g. a Wayland connection failure ([#943][943]).
2098* Key binding collisions not detected for bindings specified as option
2099 overrides on the command line.
2100* Crash when seat has no keyboard ([#963][963]).
2101* Key presses with e.g. `AltGr` triggering key combinations with the
2102 base symbol ([#983][983]).
2103* Underline cursor sometimes being positioned too low, either making
2104 it look thinner than what it should be, or being completely
2105 invisible ([#1005][1005]).
2106* Fallback to `/etc/xdg` if `XDG_CONFIG_DIRS` is unset
2107 ([#1008][1008]).
2108* Improved compatibility with XTerm when `modifyOtherKeys=2`
2109 ([#1009][1009]).
2110* Window geometry when CSDs are enabled and CSD border width set to a
2111 non-zero value. This fixes window snapping in e.g. GNOME.
2112* Window size "jumping" when starting an interactive resize when CSDs
2113 are enabled, and CSD border width set to a non-zero value.
2114* Key binding overrides on the command line having no effect with
2115 `footclient` instances ([#931][931]).
2116* Search prev/next not updating the selection correctly when the
2117 previous and new match overlaps.
2118* Various minor fixes to scrollback search, and how it finds the
2119 next/prev match.
2121[918]: https://codeberg.org/dnkl/foot/issues/918
2122[922]: https://codeberg.org/dnkl/foot/issues/922
2123[924]: https://codeberg.org/dnkl/foot/issues/924
2124[926]: https://codeberg.org/dnkl/foot/issues/926
2125[943]: https://codeberg.org/dnkl/foot/issues/943
2126[963]: https://codeberg.org/dnkl/foot/issues/963
2127[983]: https://codeberg.org/dnkl/foot/issues/983
2128[1005]: https://codeberg.org/dnkl/foot/issues/1005
2129[1008]: https://codeberg.org/dnkl/foot/issues/1008
2130[1009]: https://codeberg.org/dnkl/foot/issues/1009
2131[931]: https://codeberg.org/dnkl/foot/issues/931
2134### Contributors
2136* Ashish SHUKLA
2137* Craig Barnes
2138* Enes Hecan
2139* Johannes Altmanninger
2140* L3MON4D3
2141* Leonardo Neumann
2142* Mariusz Bialonczyk
2143* Max Gautier
2144* Merlin Büge
2145* jvoisin
2146* merkix
2149## 1.11.0
2151### Added
2153* `[mouse-bindings].selection-override-modifiers` option, specifying
2154 which modifiers to hold to override mouse grabs by client
2155 applications and force selection instead.
2156* _irc://_ and _ircs://_ to the default set of protocols recognized
2157 when auto-detecting URLs.
2158* [SGR-Pixels (1016) mouse extended coordinates](https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Extended-coordinates) is now supported
2159 ([#762](https://codeberg.org/dnkl/foot/issues/762)).
2160* `XTGETTCAP` - builtin terminfo. See
2161 [README.md::XTGETTCAP](README.md#xtgettcap) for details
2162 ([#846](https://codeberg.org/dnkl/foot/issues/846)).
2163* `DECRQSS` - _Request Selection or Setting_
2164 ([#798](https://codeberg.org/dnkl/foot/issues/798)). Implemented settings
2165 are:
2166 - `DECSTBM` - _Set Top and Bottom Margins_
2167 - `SGR` - _Set Graphic Rendition_
2168 - `DECSCUSR` - _Set Cursor Style_
2169* Support for searching for the last searched-for string in scrollback
2170 search (search for next/prev match with an empty search string).
2173### Changed
2175* PaperColorDark and PaperColorLight themes renamed to
2176 paper-color-dark and paper-color-light, for consistency with other
2177 theme names.
2178* `[scrollback].multiplier` is now applied in "alternate scroll" mode,
2179 where scroll events are translated to fake arrow key presses on the
2180 alt screen ([#859](https://codeberg.org/dnkl/foot/issues/859)).
2181* The width of the block cursor's outline in an unfocused window is
2182 now scaled by the output scaling factor ("desktop
2183 scaling"). Previously, it was always 1px.
2184* Foot will now try to change the locale to either "C.UTF-8" or
2185 "en_US.UTF-8" if started with a non-UTF8 locale. If this fails, foot
2186 will start, but only to display a window with an error (user's shell
2187 is not executed).
2188* `gettimeofday()` has been replaced with `clock_gettime()`, due to it being
2189 marked as obsolete by POSIX.
2190* `alt+tab` now emits `ESC \t` instead of `CSI 27;3;9~`
2191 ([#900](https://codeberg.org/dnkl/foot/issues/900)).
2192* File pasted, or dropped, on the alt screen is no longer quoted
2193 ([#379](https://codeberg.org/dnkl/foot/issues/379)).
2194* Line-based selections now include a trailing newline when copied
2195 ([#869](https://codeberg.org/dnkl/foot/issues/869)).
2196* Foot now clears the signal mask and resets all signal handlers to
2197 their default handlers at startup
2198 ([#854](https://codeberg.org/dnkl/foot/issues/854)).
2199* `Copy` and `Paste` keycodes are supported by default for the
2200 clipboard. These are useful for keyboards with custom firmware like
2201 QMK to enable global copy/paste shortcuts that work inside and
2202 outside the terminal (https://codeberg.org/dnkl/foot/pulls/894).
2205### Removed
2207* Workaround for slow resize in Sway <= 1.5, when a foot window was
2208 hidden, for example, in a tabbed view
2209 (https://codeberg.org/dnkl/foot/pulls/507).
2212### Fixed
2214* Font size adjustment ("zooming") when font is configured with a
2215 **pixelsize**, and `dpi-aware=no`
2216 ([#842](https://codeberg.org/dnkl/foot/issues/842)).
2217* Key presses triggering keyboard layout switches also emitting CSI
2218 codes in the Kitty keyboard protocol.
2219* Assertion in `shm.c:buffer_release()`
2220 ([#844](https://codeberg.org/dnkl/foot/issues/844)).
2221* Crash when setting a key- or mouse binding to the empty string
2222 ([#851](https://codeberg.org/dnkl/foot/issues/851)).
2223* Crash when maximizing the window and `[csd].size=1`
2224 ([#857](https://codeberg.org/dnkl/foot/issues/857)).
2225* OSC-8 URIs not getting overwritten (erased) by double-width
2226 characters (e.g. emojis).
2227* Rendering of CSD borders when `csd.border-width > 0` and desktop
2228 scaling has been enabled.
2229* Failure to launch when `exec(3)`:ed with an empty argv.
2230* Pasting from the primary clipboard (mouse middle clicking) did not
2231 reset the scrollback view to the bottom.
2232* Wrong mouse binding triggered when doing two mouse selections in
2233 very quick (< 300ms) succession
2234 ([#883](https://codeberg.org/dnkl/foot/issues/883)).
2235* Bash completion giving an error when completing a list of short
2236 options
2237* Sixel: large image resizes (triggered by e.g. large repeat counts in
2238 `DECGRI`) are now truncated instead of ignored.
2239* Sixel: a repeat count of 0 in `DECGRI` now emits a single sixel.
2240* LIGHT ARC box drawing characters incorrectly rendered
2241 platforms ([#914](https://codeberg.org/dnkl/foot/issues/914)).
2244### Contributors
2246* [lamonte](https://codeberg.org/lamonte)
2247* Érico Nogueira
2248* feeptr
2249* Felix Lechner
2250* grtcdr
2251* Mark Stosberg
2252* Nicolai Dagestad
2253* Oğuz Ersen
2254* Pranjal Kole
2255* Simon Ser
2258## 1.10.3
2260### Added
2262* Kitty keyboard protocol ([#319](https://codeberg.org/dnkl/foot/issues/319)):
2263 - [Report event types](https://sw.kovidgoyal.net/kitty/keyboard-protocol/#report-events)
2264 (mode `0b10`)
2265 - [Report alternate keys](https://sw.kovidgoyal.net/kitty/keyboard-protocol/#report-alternates)
2266 (mode `0b100`)
2267 - [Report all keys as escape codes](https://sw.kovidgoyal.net/kitty/keyboard-protocol/#report-all-keys)
2268 (mode `0b1000`)
2269 - [Report associated text](https://sw.kovidgoyal.net/kitty/keyboard-protocol/#report-text)
2270 (mode `0b10000`)
2273### Fixed
2275* Crash when bitmap fonts are scaled down to very small font sizes
2276 ([#830](https://codeberg.org/dnkl/foot/issues/830)).
2277* Crash when overwriting/erasing an OSC-8 URL.
2280## 1.10.2
2282### Added
2284* New value, `max`, for `[tweak].grapheme-width-method`.
2285* Initial support for the [Kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/).
2286 Modes supported:
2287 - [Disambiguate escape codes](https://sw.kovidgoyal.net/kitty/keyboard-protocol/#disambiguate) (mode `0b1`)
2288* "Window menu" (compositor provided) on right clicks on the CSD title
2289 bar.
2292### Fixed
2294* An ongoing mouse selection is now finalized on a pointer leave event
2295 (for example by switching workspace while doing a mouse selection).
2296* OSC-8 URIs in the last column
2297* OSC-8 URIs sometimes being applied to too many, and seemingly
2298 unrelated cells ([#816](https://codeberg.org/dnkl/foot/issues/816)).
2299* OSC-8 URIs incorrectly being dropped when resizing the terminal
2300 window with the alternate screen active.
2301* CSD border not being dimmed when window is not focused.
2302* Visual corruption with large CSD borders
2303 ([#823](https://codeberg.org/dnkl/foot/issues/823)).
2304* Mouse cursor shape sometimes not being updated correctly.
2305* Color palette changes (via OSC 4/104) no longer affect RGB colors
2306 ([#678](https://codeberg.org/dnkl/foot/issues/678)).
2309### Contributors
2311* Jonas Ådahl
2314## 1.10.1
2316### Added
2318* `-Dthemes=false|true` meson command line option. When disabled,
2319 example theme files are **not** installed.
2320* XDG desktop file for footclient.
2323### Fixed
2325* Regression: `letter-spacing` resulting in a "not a valid option"
2326 error ([#795](https://codeberg.org/dnkl/foot/issues/795)).
2327* Regression: bad section name in configuration error messages.
2328* Regression: `pipe-*` key bindings not being parsed correctly,
2329 resulting in invalid error messages
2330 ([#809](https://codeberg.org/dnkl/foot/issues/809)).
2331* OSC-8 data not being cleared when cell is overwritten
2332 ([#804](https://codeberg.org/dnkl/foot/issues/804),
2333 [#801](https://codeberg.org/dnkl/foot/issues/801)).
2336### Contributors
2338* Arnavion
2339* Craig Barnes
2340* Soc Virnyl Silab Estela
2341* Xiretza
2344## 1.10.0
2346### Added
2348* `notify-focus-inhibit` boolean option, which can be used to control
2349 whether desktop notifications should be inhibited when the terminal
2350 has keyboard focus
2351* `[colors].scrollback-indicator` color-pair option, which specifies
2352 foreground and background colors for the scrollback indicator.
2353* `[key-bindings].noop` action. Key combinations assigned to this
2354 action will not be sent to the application
2355 ([#765](https://codeberg.org/dnkl/foot/issues/765)).
2356* Color schemes are now installed to `${datadir}/foot/themes`.
2357* `[csd].border-width` and `[csd].border-color`, allowing you to
2358 configure the width and color of the CSD border.
2359* Support for `XTMODKEYS` with `Pp=4` and `Pv=2` (_modifyOtherKeys=2_).
2360* `[colors].dim0-7` options, allowing you to configure custom "dim"
2361 colors ([#776](https://codeberg.org/dnkl/foot/issues/776)).
2364### Changed
2366* `[tweak].grapheme-shaping` is now enabled by default when both foot
2367 itself, and fcft has been compiled with support for it.
2368* Default value of `[tweak].grapheme-width-method` changed from
2369 `double-width` to `wcswidth`.
2370* INSTALL.md: `--override tweak.grapheme-shaping=no` added to PGO
2371 command line.
2372* Foot now terminates if there are no available seats - for example,
2373 due to the compositor not implementing a recent enough version of
2374 the `wl_seat` interface ([#779](https://codeberg.org/dnkl/foot/issues/779)).
2375* Boolean options in `foot.ini` are now limited to
2376 "yes|true|on|1|no|false|off|0", Previously, anything that did not
2377 match "yes|true|on", or a number greater than 0, was treated as
2378 "false".
2379* `[scrollback].multiplier` is no longer applied when the alternate
2380 screen is in use ([#787](https://codeberg.org/dnkl/foot/issues/787)).
2383### Removed
2385* The bundled PKGBUILD.
2386* Deprecated `bell` option (replaced with `[bell]` section in 1.8.0).
2387* Deprecated `url-launch`, `jump-label-letters` and `osc8-underline`
2388 options (moved to a dedicated `[url]` section in 1.8.0)
2391### Fixed
2393* 'Sticky' modifiers in input handling; when determining modifier
2394 state, foot was looking at **depressed** modifiers, not
2395 **effective** modifiers, like it should.
2396* Fix crashes after enabling CSD at runtime when `csd.size` is 0.
2397* Convert `\r` to `\n` when reading clipboard data
2398 ([#752](https://codeberg.org/dnkl/foot/issues/752)).
2399* Clipboard occasionally ceasing to work, until window has been
2400 re-focused ([#753](https://codeberg.org/dnkl/foot/issues/753)).
2401* Don't propagate window title updates to the Wayland compositor
2402 unless the new title is different from the old title.
2405### Contributors
2407* armin
2408* Craig Barnes
2409* Daniel Martí
2410* feeptr
2411* Mitja Horvat
2412* Ronan Pigott
2413* Stanislav Ochotnický
2416## 1.9.2
2418### Changed
2420* PGO helper scripts no longer set `LC_CTYPE=en_US.UTF-8`. But, note
2421 that "full" PGO builds still **require** a UTF-8 locale; you need
2422 to set one manually in your build script
2423 ([#728](https://codeberg.org/dnkl/foot/issues/728)).
2426## 1.9.1
2428### Added
2430* Warn when it appears the primary font is not monospaced. Can be
2431 disabled by setting `[tweak].font-monospace-warn=no`
2432 ([#704](https://codeberg.org/dnkl/foot/issues/704)).
2433* PGO build scripts, in the `pgo` directory. See INSTALL.md -
2434 _Performance optimized, PGO_, for details
2435 ([#701](https://codeberg.org/dnkl/foot/issues/701)).
2436* Braille characters (U+2800 - U+28FF) are now rendered by foot
2437 itself ([#702](https://codeberg.org/dnkl/foot/issues/702)).
2438* `-e` command-line option. This option is simply ignored, to appease
2439 program launchers that blindly pass `-e` to any terminal emulator
2440 ([#184](https://codeberg.org/dnkl/foot/issues/184)).
2443### Changed
2445* `-Ddefault-terminfo` is now also applied to the generated terminfo
2446 definitions when `-Dterminfo=enabled`.
2447* `-Dcustom-terminfo-install-location` no longer accepts `no` as a
2448 special value, to disable exporting `TERMINFO`. To achieve the same
2449 result, simply don't set it at all. If it _is_ set, `TERMINFO` is
2450 still exported, like before.
2451* The default install location for the terminfo definitions have been
2452 changed back to `${datadir}/terminfo`.
2453* `dpi-aware=auto`: fonts are now scaled using the monitor's DPI only
2454 when **all** monitors have a scaling factor of one
2455 ([#714](https://codeberg.org/dnkl/foot/issues/714)).
2456* fcft >= 3.0.0 in now required.
2459### Fixed
2461* Added workaround for GNOME bug where multiple button press events
2462 (for the same button) is sent to the CSDs without any release or
2463 leave events in between ([#709](https://codeberg.org/dnkl/foot/issues/709)).
2464* Line-wise selection not taking soft line-wrapping into account
2465 ([#726](https://codeberg.org/dnkl/foot/issues/726)).
2468### Contributors
2470* [craigbarnes](https://codeberg.org/craigbarnes)
2471* Arnavion
2474## 1.9.0
2476### Added
2478* Window title in the CSDs
2479 ([#638](https://codeberg.org/dnkl/foot/issues/638)).
2480* `-Ddocs=disabled|enabled|auto` meson command line option.
2481* Support for `~`-expansion in the `include` directive
2482 ([#659](https://codeberg.org/dnkl/foot/issues/659)).
2483* Unicode 13 characters U+1FB3C - U+1FB6F, U+1FB9A and U+1FB9B to list
2484 of box drawing characters rendered by foot itself (rather than using
2485 font glyphs) ([#474](https://codeberg.org/dnkl/foot/issues/474)).
2486* `XM`+`xm` to terminfo.
2487* Mouse buttons 6/7 (mouse wheel left/right).
2488* `url.uri-characters` option to `foot.ini`
2489 ([#654](https://codeberg.org/dnkl/foot/issues/654)).
2492### Changed
2494* Terminfo files can now co-exist with the foot terminfo files from
2495 ncurses. See `INSTALL.md` for more information
2496 ([#671](https://codeberg.org/dnkl/foot/issues/671)).
2497* `bold-text-in-bright=palette-based` now only brightens colors from palette
2498* Raised grace period between closing the PTY and sending `SIGKILL` (when
2499 terminating the client application) from 4 to 60 seconds.
2500* When terminating the client application, foot now sends `SIGTERM` immediately
2501 after closing the PTY, instead of waiting 2 seconds.
2502* Foot now sends `SIGTERM`/`SIGKILL` to the client application's process group,
2503 instead of just to the client application's process.
2504* `kmous` terminfo capability from `\E[M` to `\E[<`.
2505* pt-or-px values (`letter-spacing`, etc) and the line thickness
2506 (`tweak.box-drawing-base-thickness`) in box drawing characters are
2507 now translated to pixel values using the monitor's scaling factor
2508 when `dpi-aware=no`, or `dpi-aware=auto` and the scaling factor is
2509 larger than 1 ([#680](https://codeberg.org/dnkl/foot/issues/680)).
2510* Spawning a new terminal with a working directory that does not exist
2511 is no longer a fatal error.
2514### Removed
2516* `km`/`smm`/`rmm` from terminfo; foot prefixes Alt-key combinations
2517 with `ESC`, and not by setting the 8:th "meta" bit, regardless of
2518 `smm`/`rmm`. While this _can_ be disabled by, resetting private mode
2519 1036, the terminfo should reflect the **default** behavior
2520 ([#670](https://codeberg.org/dnkl/foot/issues/670)).
2521* Keypad application mode keys from terminfo; enabling the keypad
2522 application mode is not enough to make foot emit these sequences -
2523 you also need to disable private mode 1035
2524 ([#670](https://codeberg.org/dnkl/foot/issues/670)).
2527### Fixed
2529* Rendering into the right margin area with `tweak.overflowing-glyphs`
2530 enabled.
2531* PGO builds with clang ([#642](https://codeberg.org/dnkl/foot/issues/642)).
2532* Crash in scrollback search mode when selection has been canceled due
2533 to terminal content updates
2534 ([#644](https://codeberg.org/dnkl/foot/issues/644)).
2535* Foot process not terminating when the Wayland connection is broken
2536 ([#651](https://codeberg.org/dnkl/foot/issues/651)).
2537* Output scale being zero on compositors that does not advertise a
2538 scaling factor.
2539* Slow-to-terminate client applications causing other footclient instances to
2540 freeze when closing a footclient window.
2541* Underlying cell content showing through in the left-most column of
2542 sixels.
2543* `cursor.blink` not working in GNOME
2544 ([#686](https://codeberg.org/dnkl/foot/issues/686)).
2545* Blinking cursor stops blinking, or becoming invisible, when
2546 switching focus from, and then back to a terminal window on GNOME
2547 ([#686](https://codeberg.org/dnkl/foot/issues/686)).
2550### Contributors
2552* Nihal Jere
2553* [nowrep](https://codeberg.org/nowrep)
2554* [clktmr](https://codeberg.org/clktmr)
2557## 1.8.2
2559### Added
2561* `locked-title=no|yes` to `foot.ini`
2562 ([#386](https://codeberg.org/dnkl/foot/issues/386)).
2563* `tweak.overflowing-glyphs` option, which can be enabled to fix rendering
2564 issues with glyphs of any width that appear cut-off
2565 ([#592](https://codeberg.org/dnkl/foot/issues/592)).
2568### Changed
2570* Non-empty lines are now considered to have a hard linebreak,
2571 _unless_ an actual word-wrap is inserted.
2572* Setting `DECSDM` now _disables_ sixel scrolling, while resetting it
2573 _enables_ scrolling ([#631](https://codeberg.org/dnkl/foot/issues/631)).
2576### Removed
2578* The `tweak.allow-overflowing-double-width-glyphs` and
2579 `tweak.pua-double-width` options (which have been superseded by
2580 `tweak.overflowing-glyphs`).
2583### Fixed
2585* FD exhaustion when repeatedly entering/exiting URL mode with many
2586 URLs.
2587* Double free of URL while removing duplicated and/or overlapping URLs
2588 in URL mode ([#627](https://codeberg.org/dnkl/foot/issues/627)).
2589* Crash when an unclosed OSC-8 URL ran into un-allocated scrollback
2590 rows.
2591* Some box-drawing characters were rendered incorrectly on big-endian
2592 architectures.
2593* Crash when resizing the window to the smallest possible size while
2594 scrollback search is active.
2595* Scrollback indicator being incorrectly rendered when window size is
2596 very small.
2597* Reduced memory usage in URL mode.
2598* Crash when the `E3` escape (`\E[3J`) was executed, and there was a
2599 selection, or sixel image, in the scrollback
2600 ([#633](https://codeberg.org/dnkl/foot/issues/633)).
2603### Contributors
2605* [clktmr](https://codeberg.org/clktmr)
2608## 1.8.1
2610### Added
2612* `--log-level=none` command-line option.
2613* `Tc`, `setrgbf` and `setrgbb` capabilities in `foot` and `foot-direct`
2614 terminfo entries. This should make 24-bit RGB colors work in tmux and
2615 neovim, without the need for config hacks or detection heuristics
2616 ([#615](https://codeberg.org/dnkl/foot/issues/615)).
2619### Changed
2621* Grapheme cluster width is now limited to two cells by default. This
2622 may cause cursor synchronization issues with many applications. You
2623 can set `[tweak].grapheme-width-method=wcswidth` to revert to the
2624 behavior in foot-1.8.0.
2627### Fixed
2629* Grapheme cluster state being reset between codepoints.
2630* Regression: custom URL key bindings not working
2631 ([#614](https://codeberg.org/dnkl/foot/issues/614)).
2634### Contributors
2636* [craigbarnes](https://codeberg.org/craigbarnes)
2639## 1.8.0
2641### Grapheme shaping
2643This release adds _experimental, opt-in_ support for grapheme cluster
2644segmentation and grapheme shaping.
2646(note: several of the examples below may not render correctly in your
2647browser, viewer or editor).
2649Grapheme cluster segmentation is the art of splitting up text into
2650grapheme clusters, where a cluster may consist of more than one
2651Unicode codepoint. For example, 🙂 is a single codepoint, while 👩🏽‍🚀
2652consists of 4 codepoints (_Woman_ + _Medium skin tone_ + _Zero width
2653joiner_ + _Rocket_). The goal is to _cluster_ codepoints belonging to
2654the same grapheme in the same cell in the terminal.
2656Previous versions of foot implemented a simple grapheme cluster
2657segmentation technique that **only** handled zero-width
2658codepoints. This allowed us to cluster combining characters, like q́
2659(_q_ + _COMBINING ACUTE ACCENT_).
2661Once we have a grapheme cluster, we need to _shape_ it.
2663Combining characters are simple: they are typically rendered as
2664multiple glyphs layered on top of each other. This is why previous
2665versions of foot got away with it without any actual text shaping
2666support.
2668Beyond that, support from the font library is needed. Foot now depends
2669on fcft-2.4, which added support for grapheme and text shaping. When
2670rendering a cell, we ask the font library: give us the glyph(s) for
2671this sequence of codepoints.
2673Fancy emoji sequences aside, using libutf8proc for grapheme cluster
2674segmentation means **improved correctness**.
2676For full support, the following is required:
2678* fcft compiled with HarfBuzz support
2679* foot compiled with libutf8proc support
2680* `tweak.grapheme-shaping=yes` in `foot.ini`
2682If `tweak.grapheme-shaping` has **not** been enabled, foot will
2683neither use libutf8proc to do grapheme cluster segmentation, nor will
2684it use fcft's grapheme shaping capabilities to shape combining
2685characters.
2687This feature is _experimental_ mostly due to the "wcwidth" problem;
2688how many cells should foot allocate for a grapheme cluster? While the
2689answer may seem simple, the problem is that, whatever the answer is,
2690the client application **must** come up with the **same**
2691answer. Otherwise we get cursor synchronization issues.
2693In this release, foot simply adds together the `wcwidth()` of all
2694codepoints in the grapheme cluster. This is equivalent to running
2695`wcswidth()` on the entire cluster. **This is likely to change in the
2696future**.
2698Finally, note that grapheme shaping is not the same thing as text (or
2699text run) shaping. In this version, foot only shapes individual
2700graphemes, not entire text runs. That means e.g. ligatures are **not**
2701supported.
2704### Added
2706* Support for DECSET/DECRST 2026, as an alternative to the existing
2707 "synchronized updates" DCS sequences
2708 ([#459](https://codeberg.org/dnkl/foot/issues/459)).
2709* `cursor.beam-thickness` option to `foot.ini`
2710 ([#464](https://codeberg.org/dnkl/foot/issues/464)).
2711* `cursor.underline-thickness` option to `foot.ini`
2712 ([#524](https://codeberg.org/dnkl/foot/issues/524)).
2713* Unicode 13 characters U+1FB70 - U+1FB8B to list of box drawing
2714 characters rendered by foot itself (rather than using font glyphs)
2715 ([#471](https://codeberg.org/dnkl/foot/issues/471)).
2716* Dedicated `[bell]` section to config, supporting multiple actions
2717 and a new `command` action to run an arbitrary command.
2718 (https://codeberg.org/dnkl/foot/pulls/483)
2719* Dedicated `[url]` section to config.
2720* `[url].protocols` option to `foot.ini`
2721 ([#531](https://codeberg.org/dnkl/foot/issues/531)).
2722* Support for setting the full 256 color palette in foot.ini
2723 ([#489](https://codeberg.org/dnkl/foot/issues/489))
2724* XDG activation support, will be used by `[bell].urgent` when
2725 available (falling back to coloring the window margins red when
2726 unavailable) ([#487](https://codeberg.org/dnkl/foot/issues/487)).
2727* `ctrl`+`c` as a default key binding; to cancel search/url mode.
2728* `${window-title}` to `notify`.
2729* Support for including files in `foot.ini`
2730 ([#555](https://codeberg.org/dnkl/foot/issues/555)).
2731* `ENVIRONMENT` section in **foot**(1) and **footclient**(1) man pages
2732 ([#556](https://codeberg.org/dnkl/foot/issues/556)).
2733* `tweak.pua-double-width` option to `foot.ini`, letting you force
2734 _Private Usage Area_ codepoints to be treated as double-width
2735 characters.
2736* OSC 9 desktop notifications (iTerm2 compatible).
2737* Support for LS2 and LS3 (locking shift) escape sequences
2738 ([#581](https://codeberg.org/dnkl/foot/issues/581)).
2739* Support for overriding configuration options on the command line
2740 ([#554](https://codeberg.org/dnkl/foot/issues/554),
2741 [#600](https://codeberg.org/dnkl/foot/issues/600)).
2742* `underline-offset` option to `foot.ini`
2743 ([#490](https://codeberg.org/dnkl/foot/issues/490)).
2744* `csd.button-color` option to `foot.ini`.
2745* `-Dterminfo-install-location=disabled|<custom-path>` meson command
2746 line option ([#569](https://codeberg.org/dnkl/foot/issues/569)).
2749### Changed
2751* [fcft](https://codeberg.org/dnkl/fcft): required version bumped from
2752 2.3.x to 2.4.x.
2753* `generate-alt-random-writes.py --sixel`: width and height of emitted
2754 sixels has been adjusted.
2755* _Concealed_ text (`\E[8m`) is now revealed when highlighted.
2756* The background color of highlighted text is now adjusted, when the
2757 foreground and background colors are the same, making the
2758 highlighted text legible
2759 ([#455](https://codeberg.org/dnkl/foot/issues/455)).
2760* `cursor.style=bar` to `cursor.style=beam`. `bar` remains a
2761 recognized value, but will eventually be deprecated, and removed.
2762* Point values in `line-height`, `letter-spacing`,
2763 `horizontal-letter-offset` and `vertical-letter-offset` are now
2764 rounded, not truncated, when translated to pixel values.
2765* Foot's exit code is now -26/230 when foot itself failed to launch
2766 (due to invalid command line options, client application/shell not
2767 found etc). Footclient's exit code is -36/220 when it itself fails
2768 to launch (e.g. bad command line option) and -26/230 when the foot
2769 server failed to instantiate a new window
2770 ([#466](https://codeberg.org/dnkl/foot/issues/466)).
2771* Background alpha no longer applied to palette or RGB colors that
2772 matches the background color.
2773* Improved performance on compositors that does not release shm
2774 buffers immediately, e.g. KWin
2775 ([#478](https://codeberg.org/dnkl/foot/issues/478)).
2776* `ctrl + w` (_extend-to-word-boundary_) can now be used across lines
2777 ([#421](https://codeberg.org/dnkl/foot/issues/421)).
2778* Ignore auto-detected URLs that overlap with OSC-8 URLs.
2779* Default value for the `notify` option to use `-a ${app-id} -i
2780 ${app-id} ...` instead of `-a foot -i foot ...`.
2781* `scrollback-*`+`pipe-scrollback` key bindings are now passed through
2782 to the client application when the alt screen is active
2783 ([#573](https://codeberg.org/dnkl/foot/issues/573)).
2784* Reverse video (`\E[?5h`) now only swaps the default foreground and
2785 background colors. Cells with explicit foreground and/or background
2786 colors remain unchanged.
2787* Tabs (`\t`) are now preserved when the window is resized, and when
2788 copying text ([#508](https://codeberg.org/dnkl/foot/issues/508)).
2789* Writing a sixel on top of another sixel no longer erases the first
2790 sixel, but the two are instead blended
2791 ([#562](https://codeberg.org/dnkl/foot/issues/562)).
2792* Running foot without a configuration file is no longer an error; it
2793 has been demoted to a warning, and is no longer presented as a
2794 notification in the terminal window, but only logged on stderr.
2797### Deprecated
2799* `bell` option in `foot.ini`; set actions in the `[bell]` section
2800 instead.
2801* `url-launch` option in `foot.ini`; use `launch` in the `[url]`
2802 section instead.
2803* `jump-label-letters` option in `foot.ini`; use `label-letters` in
2804 the `[url]` section instead.
2805* `osc8-underline` option in `foot.ini`; use `osc8-underline` in the
2806 `[url]` section instead.
2809### Removed
2811* Buffer damage quirk for Plasma/KWin.
2814### Fixed
2816* `generate-alt-random-writes.py --sixel` sometimes crashing,
2817 resulting in PGO build failures.
2818* Wrong colors in the 256-color cube
2819 ([#479](https://codeberg.org/dnkl/foot/issues/479)).
2820* Memory leak triggered by "opening" an OSC-8 URI and then resetting
2821 the terminal without closing the URI
2822 ([#495](https://codeberg.org/dnkl/foot/issues/495)).
2823* Assertion when emitting a sixel occupying the entire scrollback
2824 history ([#494](https://codeberg.org/dnkl/foot/issues/494)).
2825* Font underlines being positioned below the cell (and thus being
2826 invisible) for certain combinations of fonts and font sizes
2827 ([#503](https://codeberg.org/dnkl/foot/issues/503)).
2828* Sixels with transparent bottom border being resized below the size
2829 specified in _"Set Raster Attributes"_.
2830* Fonts sometimes not being reloaded with the correct scaling factor
2831 when `dpi-aware=no`, or `dpi-aware=auto` with monitor(s) with a
2832 scaling factor > 1 ([#509](https://codeberg.org/dnkl/foot/issues/509)).
2833* Crash caused by certain CSI sequences with very large parameter
2834 values ([#522](https://codeberg.org/dnkl/foot/issues/522)).
2835* Rare occurrences where the window did not close when the shell
2836 exited. Only seen on FreeBSD
2837 ([#534](https://codeberg.org/dnkl/foot/issues/534))
2838* Foot process(es) sometimes remaining, using 100% CPU, when closing
2839 multiple foot windows at the same time
2840 ([#542](https://codeberg.org/dnkl/foot/issues/542)).
2841* Regression where `<mod>+shift+tab` always produced `\E[Z` instead of
2842 the correct `\E[27;<mod>;9~` sequence
2843 ([#547](https://codeberg.org/dnkl/foot/issues/547)).
2844* Crash when a line wrapping OSC-8 URI crossed the scrollback wrap
2845 around ([#552](https://codeberg.org/dnkl/foot/issues/552)).
2846* Selection incorrectly wrapping rows ending with an explicit newline
2847 ([#565](https://codeberg.org/dnkl/foot/issues/565)).
2848* Off-by-one error in markup of auto-detected URLs when the URL ends
2849 in the right-most column.
2850* Multi-column characters being cut in half when resizing the
2851 alternate screen.
2852* Restore `SIGHUP` in spawned processes.
2853* Text reflow performance ([#504](https://codeberg.org/dnkl/foot/issues/504)).
2854* IL+DL (`CSI Ps L` + `CSI Ps M`) now moves the cursor to column 0.
2855* SS2 and SS3 (single shift) escape sequences behaving like locking
2856 shifts ([#580](https://codeberg.org/dnkl/foot/issues/580)).
2857* `TEXT`+`STRING`+`UTF8_STRING` mime types not being recognized in
2858 clipboard offers ([#583](https://codeberg.org/dnkl/foot/issues/583)).
2859* Memory leak caused by custom box drawing glyphs not being completely
2860 freed when destroying a foot window instance
2861 ([#586](https://codeberg.org/dnkl/foot/issues/586)).
2862* Crash in scrollback search when current XKB layout is missing
2863 _compose_ definitions.
2864* Window title not being updated while window is hidden
2865 ([#591](https://codeberg.org/dnkl/foot/issues/591)).
2866* Crash on badly formatted URIs in e.g. OSC-8 URLs.
2867* Window being incorrectly resized on CSD/SSD run-time changes.
2870### Contributors
2871* [r\_c\_f](https://codeberg.org/r_c_f)
2872* [craigbarnes](https://codeberg.org/craigbarnes)
2875## 1.7.2
2877### Added
2879* URxvt OSC-11 extension to set background alpha
2880 ([#436](https://codeberg.org/dnkl/foot/issues/436)).
2881* OSC 17/117/19/119 - change/reset selection background/foreground
2882 color.
2883* `box-drawings-uses-font-glyphs=yes|no` option to `foot.ini`
2884 ([#430](https://codeberg.org/dnkl/foot/issues/430)).
2887### Changed
2889* Underline cursor is now rendered below text underline
2890 ([#415](https://codeberg.org/dnkl/foot/issues/415)).
2891* Foot now tries much harder to keep URL jump labels inside the window
2892 geometry ([#443](https://codeberg.org/dnkl/foot/issues/443)).
2893* `bold-text-in-bright` may now be set to `palette-based`, in which
2894 case it will use the corresponding bright palette color when the
2895 color to brighten matches one of the base 8 colors, instead of
2896 increasing the luminance
2897 ([#449](https://codeberg.org/dnkl/foot/issues/449)).
2900### Fixed
2902* Reverted _"Consumed modifiers are no longer sent to the client
2903 application"_ ([#425](https://codeberg.org/dnkl/foot/issues/425)).
2904* Crash caused by a double free originating in `XTSMGRAPHICS` - set
2905 number of color registers
2906 ([#427](https://codeberg.org/dnkl/foot/issues/427)).
2907* Wrong action referenced in error message for key binding collisions
2908 ([#432](https://codeberg.org/dnkl/foot/issues/432)).
2909* OSC 4/104 out-of-bounds accesses to the color table. This was the
2910 reason pywal turned foot windows transparent
2911 ([#434](https://codeberg.org/dnkl/foot/issues/434)).
2912* PTY not being drained when the client application terminates.
2913* `auto_left_margin` not being limited to `cub1`
2914 ([#441](https://codeberg.org/dnkl/foot/issues/441)).
2915* Crash in scrollback search mode when searching beyond the last output.
2918### Contributors
2920* [cglogic](https://codeberg.org/cglogic)
2923## 1.7.1
2925### Changed
2927* Update PGO build instructions in `INSTALL.md`
2928 ([#418](https://codeberg.org/dnkl/foot/issues/418)).
2929* In scrollback search mode, empty cells can now be matched by spaces.
2932### Fixed
2934* Logic that repairs invalid key bindings ended up breaking valid key
2935 bindings instead ([#407](https://codeberg.org/dnkl/foot/issues/407)).
2936* Custom `line-height` settings now scale when increasing or
2937 decreasing the font size at run-time.
2938* Newlines sometimes incorrectly inserted into copied text
2939 ([#410](https://codeberg.org/dnkl/foot/issues/410)).
2940* Crash when compositor send `text-input-v3::enter` events without
2941 first having sent a `keyboard::enter` event
2942 ([#411](https://codeberg.org/dnkl/foot/issues/411)).
2943* Deadlock when rendering sixel images.
2944* URL labels, scrollback search box or scrollback position indicator
2945 sometimes not showing up, caused by invalidly sized surface buffers
2946 when output scaling was enabled
2947 ([#409](https://codeberg.org/dnkl/foot/issues/409)).
2948* Empty sixels resulted in non-empty images.
2951## 1.7.0
2953### Added
2955* The `pad` option now accepts an optional third argument, `center`
2956 (e.g. `pad=5x5 center`), causing the grid to be centered in the
2957 window, with equal amount of padding of the left/right and
2958 top/bottom side ([#273](https://codeberg.org/dnkl/foot/issues/273)).
2959* `line-height`, `letter-spacing`, `horizontal-letter-offset` and
2960 `vertical-letter-offset` to `foot.ini`. These options let you tweak
2961 cell size and glyph positioning
2962 ([#244](https://codeberg.org/dnkl/foot/issues/244)).
2963* Key/mouse binding `select-extend-character-wise`, which forces the
2964 selection mode to 'character-wise' when extending a selection.
2965* `DECSET` `47`, `1047` and `1048`.
2966* URL detection and OSC-8 support. URLs are highlighted and activated
2967 using the keyboard (**no** mouse support). See **foot**(1)::URLs, or
2968 [README.md](README.md#urls) for details
2969 ([#14](https://codeberg.org/dnkl/foot/issues/14)).
2970* `-d,--log-level={info|warning|error}` to both `foot` and
2971 `footclient` ([#337](https://codeberg.org/dnkl/foot/issues/337)).
2972* `-D,--working-directory=DIR` to both `foot` and `footclient`
2973 ([#347](https://codeberg.org/dnkl/foot/issues/347))
2974* `DECSET 80` - sixel scrolling
2975 ([#361](https://codeberg.org/dnkl/foot/issues/361)).
2976* `DECSET 1070` - sixel private color palette
2977 ([#362](https://codeberg.org/dnkl/foot/issues/362)).
2978* `DECSET 8452` - position cursor to the right of sixels
2979 ([#363](https://codeberg.org/dnkl/foot/issues/363)).
2980* Man page **foot-ctlseqs**(7), documenting all supported escape
2981 sequences ([#235](https://codeberg.org/dnkl/foot/issues/235)).
2982* Support for transparent sixels (DCS parameter `P2=1`)
2983 ([#391](https://codeberg.org/dnkl/foot/issues/391)).
2984* `-N,--no-wait` to `footclient`
2985 ([#395](https://codeberg.org/dnkl/foot/issues/395)).
2986* Completions for Bash shell
2987 ([#10](https://codeberg.org/dnkl/foot/issues/10)).
2988* Implement `XTVERSION` (`CSI > 0q`). Foot will reply with
2989 `DCS>|foot(<major>.<minor>.<patch>)ST`
2990 ([#359](https://codeberg.org/dnkl/foot/issues/359)).
2993### Changed
2995* The fcft and tllist library subprojects are now handled via Meson
2996 [wrap files](https://mesonbuild.com/Wrap-dependency-system-manual.html)
2997 instead of needing to be manually cloned.
2998* Box drawing characters are now rendered by foot, instead of using
2999 font glyphs ([#198](https://codeberg.org/dnkl/foot/issues/198))
3000* Double- or triple clicking then dragging now extends the selection
3001 word- or line-wise ([#267](https://codeberg.org/dnkl/foot/issues/267)).
3002* The line thickness of box drawing characters now depend on the font
3003 size ([#281](https://codeberg.org/dnkl/foot/issues/281)).
3004* Extending a word/line-wise selection now uses the original selection
3005 mode instead of switching to character-wise.
3006* While doing an interactive resize of a foot window, foot now
3007 requires 100ms of idle time (where the window size does not change)
3008 before sending the new dimensions to the client application. The
3009 timing can be tweaked, or completely disabled, by setting
3010 `resize-delay-ms` ([#301](https://codeberg.org/dnkl/foot/issues/301)).
3011* `CSI 13 ; 2 t` now reports (0,0).
3012* Key binding matching logic; key combinations like `Control+Shift+C`
3013 **must** now be written as either `Control+C` or `Control+Shift+c`,
3014 the latter being the preferred
3015 variant. ([#376](https://codeberg.org/dnkl/foot/issues/376))
3016* Consumed modifiers are no longer sent to the client application
3017 ([#376](https://codeberg.org/dnkl/foot/issues/376)).
3018* The minimum version requirement for the libxkbcommon dependency is
3019 now 1.0.0.
3020* Empty pixel rows at the bottom of a sixel is now trimmed.
3021* Sixels with DCS parameter `P2=0|2` now use the _current_ ANSI
3022 background color for empty pixels instead of the default background
3023 color ([#391](https://codeberg.org/dnkl/foot/issues/391)).
3024* Sixel decoding optimized; up to 100% faster in some cases.
3025* Reported sixel "max geometry" from current window size, to the
3026 configured maximum size (defaulting to 10000x10000).
3029### Removed
3031* The `-g,--geometry` command-line option (which had been deprecated
3032 and superseded by `-w,--window-size-pixels` since 1.5.0).
3035### Fixed
3037* Some mouse bindings (_primary paste_, for example) did not require
3038 `shift` to be pressed while used in a mouse grabbing
3039 application. This meant the mouse event was never seen by the
3040 application.
3041* Terminals spawned with `ctrl`+`shift`+`n` not terminating when
3042 exiting shell ([#366](https://codeberg.org/dnkl/foot/issues/366)).
3043* Default value of `-t,--term` in `--help` output when foot was built
3044 without terminfo support.
3045* Drain PTY when the client application terminates.
3048### Contributors
3050* [craigbarnes](https://codeberg.org/craigbarnes)
3051* toast
3052* [l3mon4d3](https://codeberg.org/l3mon4d3)
3053* [Simon Schricker](mailto:s.schricker@sillage.at)
3056## 1.6.4
3058### Added
3060* `selection-target=none|primary|clipboard|both` to `foot.ini`. It can
3061 be used to configure which clipboard(s) selected text should be
3062 copied to. The default is `primary`, which corresponds to the
3063 behavior in older foot releases
3064 ([#288](https://codeberg.org/dnkl/foot/issues/288)).
3067### Changed
3069* The IME state no longer stays stuck in the terminal if the IME goes
3070 away during preedit.
3071* `-Dterminfo` changed from a `boolean` to a `feature` option.
3072* Use standard signals instead of a signalfd to handle
3073 `SIGCHLD`. Fixes an issue on FreeBSD where foot did not detect when
3074 the client application had terminated.
3077### Fixed
3079* `BS`, `HT` and `DEL` from being stripped in bracketed paste mode.
3082### Contributors
3084* [tdeo](https://codeberg.org/tdeo)
3085* jbeich
3088## 1.6.3
3090### Added
3092* Completions for fish shell
3093 ([#11](https://codeberg.org/dnkl/foot/issues/11))
3094* FreeBSD support ([#238](https://codeberg.org/dnkl/foot/issues/238)).
3095* IME popup location support: foot now sends the location of the cursor
3096 so any popup can be displayed near the text that is being typed.
3099### Changed
3101* Trailing comments in `foot.ini` must now be preceded by a space or tab
3102 ([#270](https://codeberg.org/dnkl/foot/issues/270))
3103* The scrollback search box no longer accepts non-printable characters.
3104* Non-formatting C0 control characters, `BS`, `HT` and `DEL` are now
3105 stripped from pasted text.
3108### Fixed
3110* Exit when the client application terminates, not when the TTY file
3111 descriptor is closed.
3112* Crash on compositors not implementing the _text input_ interface
3113 ([#259](https://codeberg.org/dnkl/foot/issues/259)).
3114* Erased, overflowing glyphs (when
3115 `tweak.allow-overflowing-double-width-glyphs=yes` - the default) not
3116 properly erasing the cell overflowed **into**.
3117* `word-delimiters` option ignores `#` and subsequent characters
3118 ([#270](https://codeberg.org/dnkl/foot/issues/270))
3119* Combining characters not being rendered when composed with colored
3120 bitmap glyphs (i.e. colored emojis).
3121* Pasting URIs from the clipboard when the source has not
3122 newline-terminated the last URI
3123 ([#291](https://codeberg.org/dnkl/foot/issues/291)).
3124* Sixel "current geometry" query response not being bounded by the
3125 current window dimensions (fixes `lsix` output)
3126* Crash on keyboard input when repeat rate was zero (i.e. no repeat).
3127* Wrong button encoding of mouse buttons 6 and 7 in mouse events.
3128* Scrollback search not matching composed characters.
3129* High CPU usage when holding down e.g. arrow keys while in scrollback
3130 search mode.
3131* Rendering of composed characters in the scrollback search box.
3132* IME pre-edit cursor when positioned at the end of the pre-edit
3133 string.
3134* Scrollback search not matching multi-column characters.
3137### Contributors
3139* [pc](https://codeberg.org/pc)
3140* [FollieHiyuki](https://codeberg.org/FollieHiyuki)
3141* jbeich
3142* [tdeo](https://codeberg.org/tdeo)
3145## 1.6.2
3147### Fixed
3149* Version number in `meson.build`.
3152## 1.6.1
3153### Added
3155* `--seed` to `generate-alt-random.py`, enabling deterministic PGO
3156 builds.
3159### Changed
3162* Use `-std=c11` instead of `-std=c18`.
3163* Added `-Wno-profile-instr-unprofiled` to Clang cflags in PGO builds
3164 ([INSTALL.md](https://codeberg.org/dnkl/foot/src/branch/releases/1.6/INSTALL.md#user-content-performance-optimized-pgo))
3167### Fixed
3169* Missing dependencies in meson, causing heavily parallelized builds
3170 to fail.
3171* Background color when alpha < 1.0 being wrong
3172 ([#249](https://codeberg.org/dnkl/foot/issues/249)).
3173* `generate-alt-random.py` failing in containers.
3176### Contributors
3178* [craigbarnes](https://codeberg.org/craigbarnes)
3179* [sterni](https://codeberg.org/sterni)
3182## 1.6.0
3184### For packagers
3186Starting with this release, foot can be PGO:d (compiled using profile
3187guided optimizations) **without** a running Wayland session. This
3188means foot can be PGO:d in e.g. sandboxed build scripts. See
3189[INSTALL.md](INSTALL.md#user-content-performance-optimized-pgo).
3192### Added
3194* IME support. This is compile-time optional, see
3195 [INSTALL.md](INSTALL.md#user-content-options)
3196 ([#134](https://codeberg.org/dnkl/foot/issues/134)).
3197* `DECSET` escape to enable/disable IME: `CSI ? 737769 h` enables IME
3198 and `CSI ? 737769 l` disables it. This can be used to
3199 e.g. enable/disable IME when entering/leaving insert mode in vim.
3200* `dpi-aware` option to `foot.ini`. The default, `auto`, sizes fonts
3201 using the monitor's DPI when output scaling has been
3202 **disabled**. If output scaling has been **enabled**, fonts are
3203 sized using the scaling factor. DPI-only font sizing can be forced
3204 by setting `dpi-aware=yes`. Setting `dpi-aware=no` forces font
3205 sizing to be based on the scaling factor.
3206 ([#206](https://codeberg.org/dnkl/foot/issues/206)).
3207* Implement reverse auto-wrap (_auto\_left\_margin_, _bw_, in
3208 terminfo). This mode can be enabled/disabled with `CSI ? 45 h` and
3209 `CSI ? 45 l`. It is **enabled** by default
3210 ([#150](https://codeberg.org/dnkl/foot/issues/150)).
3211* `bell` option to `foot.ini`. Can be set to `set-urgency` to make
3212 foot render the margins in red when receiving `BEL` while **not**
3213 having keyboard focus. Applications can dynamically enable/disable
3214 this with the `CSI ? 1042 h` and `CSI ? 1042 l` escape
3215 sequences. Note that Wayland does **not** implement an _urgency_
3216 hint like X11, but that there is a
3217 [proposal](https://gitlab.freedesktop.org/wayland/wayland-protocols/-/merge_requests/9)
3218 to add support for this. The value `set-urgency` was chosen for
3219 forward-compatibility, in the hopes that this proposal eventualizes
3220 ([#157](https://codeberg.org/dnkl/foot/issues/157)).
3221* `bell` option can also be set to `notify`, in which case a desktop
3222 notification is emitted when foot receives `BEL` in an unfocused
3223 window.
3224* `word-delimiters` option to `foot.ini`
3225 ([#156](https://codeberg.org/dnkl/foot/issues/156)).
3226* `csd.preferred` can now be set to `none` to disable window
3227 decorations. Note that some compositors will render SSDs despite
3228 this option being used ([#163](https://codeberg.org/dnkl/foot/issues/163)).
3229* Terminal content is now auto-scrolled when moving the mouse above or
3230 below the window while selecting
3231 ([#149](https://codeberg.org/dnkl/foot/issues/149)).
3232* `font-bold`, `font-italic` `font-bold-italic` options to
3233 `foot.ini`. These options allow custom bold/italic fonts. They are
3234 unset by default, meaning the bold/italic version of the regular
3235 font is used ([#169](https://codeberg.org/dnkl/foot/issues/169)).
3236* Drag & drop support; text, files and URLs can now be dropped in a
3237 foot terminal window ([#175](https://codeberg.org/dnkl/foot/issues/175)).
3238* `clipboard-paste` and `primary-paste` scrollback search bindings. By
3239 default, they are bound to `ctrl+v ctrl+y` and `shift+insert`
3240 respectively, and lets you paste from the clipboard or primary
3241 selection into the search buffer.
3242* Support for `pipe-*` actions in mouse bindings. It was previously
3243 not possible to add a command to these actions when used in mouse
3244 bindings, making them useless
3245 ([#183](https://codeberg.org/dnkl/foot/issues/183)).
3246* `bold-text-in-bright` option to `foot.ini`. When enabled, bold text
3247 is rendered in a brighter color
3248 ([#199](https://codeberg.org/dnkl/foot/issues/199)).
3249* `-w,--window-size-pixels` and `-W,--window-size-chars` command line
3250 options to `footclient` ([#189](https://codeberg.org/dnkl/foot/issues/189)).
3251* Short command line options for `--title`, `--maximized`,
3252 `--fullscreen`, `--login-shell`, `--hold` and `--check-config`.
3253* `DECSET` escape to modify the `escape` key to send `\E[27;1;27~`
3254 instead of `\E`: `CSI ? 27127 h` enables the new behavior, `CSI ?
3255 27127 l` disables it (the default).
3256* OSC 777;notify: desktop notifications. Use in combination with the
3257 new `notify` option in `foot.ini`
3258 ([#224](https://codeberg.org/dnkl/foot/issues/224)).
3259* Status line terminfo capabilities `hs`, `tsl`, `fsl` and `dsl`. This
3260 enables e.g. vim to set the window title
3261 ([#242](https://codeberg.org/dnkl/foot/issues/242)).
3264### Changed
3266* Blinking text now uses the foreground color, but dimmed down in its
3267 off state, instead of the background color.
3268* Sixel default maximum size is now 10000x10000 instead of the current
3269 window size.
3270* Graphical glitches/flashes when resizing the window while running a
3271 fullscreen application, i.e. the 'alt' screen
3272 ([#221](https://codeberg.org/dnkl/foot/issues/221)).
3273* Cursor will now blink if **either** `CSI ? 12 h` or `CSI Ps SP q`
3274 has been used to enable blinking. **cursor.blink** in `foot.ini`
3275 controls the default state of `CSI Ps SP q`
3276 ([#218](https://codeberg.org/dnkl/foot/issues/218)).
3277* The sub-parameter versions of the SGR RGB color escapes (e.g
3278 `\E[38:2...m`) can now be used _without_ the color space ID
3279 parameter.
3280* SGR 21 no longer disables **bold**. According to ECMA-48, SGR 21 is
3281 _"double underline_". Foot does not (yet) implement that, but that's
3282 no reason to implement a non-standard behavior.
3283* `DECRQM` now returns actual state of the requested mode, instead of
3284 always returning `2`.
3287### Removed
3289* Support for loading configuration from `$XDG_CONFIG_HOME/footrc`.
3290* `scrollback` option from `foot.ini`.
3291* `geometry` from `foot.ini`.
3292* Key binding action `scrollback-up` and `scrollback-down`.
3295### Fixed
3297* Error when re-assigning a default key binding
3298 ([#233](https://codeberg.org/dnkl/foot/issues/233)).
3299* `\E[s`+`\E[u` (save/restore cursor) now saves and restores
3300 attributes and charset configuration, just like `\E7`+`\E8`.
3301* Report mouse motion events to the client application also while
3302 dragging the cursor outside the grid.
3303* Parsing of the sub-parameter versions of indexed SGR color escapes
3304 (e.g. `\E[38:5...m`)
3305* Frames occasionally being rendered while application synchronized
3306 updates is in effect.
3307* Handling of failures to parse the font specification string.
3308* Extra private/intermediate characters in escape sequences not being
3309 ignored.
3312### Contributors
3314* [kennylevinsen](https://codeberg.org/kennylevinsen)
3315* [craigbarnes](https://codeberg.org/craigbarnes)
3318## 1.5.4
3320### Changed
3323* Num Lock by default overrides the keypad mode. See
3324 **foot.ini**(5)::KEYPAD, or
3325 [README.md](README.md#user-content-keypad) for details
3326 ([#194](https://codeberg.org/dnkl/foot/issues/194)).
3327* Single-width characters with double-width glyphs are now allowed to
3328 overflow into neighboring cells by default. Set
3329 **tweak.allow-overflowing-double-width-glyphs** to 'no' to disable
3330 this.
3332### Fixed
3334* Resize very slow when window is hidden
3335 ([#190](https://codeberg.org/dnkl/foot/issues/190)).
3336* Key mappings for key combinations with `shift`+`tab`
3337 ([#210](https://codeberg.org/dnkl/foot/issues/210)).
3338* Key mappings for key combinations with `alt`+`return`.
3339* `footclient` `-m` (`--maximized`) flag being ignored.
3340* Crash with explicitly sized sixels with a height less than 6 pixels.
3341* Key mappings for `esc` with modifiers.
3344### Contributors
3346* [craigbarnes](https://codeberg.org/craigbarnes)
3349## 1.5.3
3351### Fixed
3353* Crash when libxkbcommon cannot find a suitable libX11 _compose_
3354 file. Note that foot will run, but without support for dead keys.
3355 ([#170](https://codeberg.org/dnkl/foot/issues/170)).
3356* Restored window size when window is un-tiled.
3357* XCursor shape in CSD corners when window is tiled.
3358* Error handling when processing keyboard input (maybe
3359 [#171](https://codeberg.org/dnkl/foot/issues/171)).
3360* Compilation error _"overflow in conversion from long 'unsigned int'
3361 to 'int' changes value... "_ seen on platforms where the `request`
3362 argument in `ioctl(3)` is an `int` (for example: linux/ppc64).
3363* Crash when using the mouse in alternate scroll mode in an unfocused
3364 window ([#179](https://codeberg.org/dnkl/foot/issues/179)).
3365* Character dropped from selection when "right-click-hold"-extending a
3366 selection ([#180](https://codeberg.org/dnkl/foot/issues/180)).
3369## 1.5.2
3371### Fixed
3373* Regression: middle clicking double pastes in e.g. vim
3374 ([#168](https://codeberg.org/dnkl/foot/issues/168))
3377## 1.5.1
3379### Changed
3381* Default value of the **scrollback.multiplier** option in `foot.ini`
3382 from `1.0` to `3.0`.
3383* `shift`+`insert` now pastes from the primary selection by
3384 default. This is in addition to middle-clicking with the mouse.
3387### Fixed
3389* Mouse bindings now match even if the actual click count is larger
3390 than specified in the binding. This allows you to, for example,
3391 quickly press the middle-button to paste multiple times
3392 ([#146](https://codeberg.org/dnkl/foot/issues/146)).
3393* Color flashes when changing the color palette with OSC 4,10,11
3394 ([#141](https://codeberg.org/dnkl/foot/issues/141)).
3395* Scrollback position is now retained when resizing the window
3396 ([#142](https://codeberg.org/dnkl/foot/issues/142)).
3397* Trackpad scrolling speed to better match the mouse scrolling speed,
3398 and to be consistent with other (Wayland) terminal emulators. Note
3399 that it is (much) slower compared to previous foot versions. Use the
3400 **scrollback.multiplier** option in `foot.ini` if you find the new
3401 speed too slow ([#144](https://codeberg.org/dnkl/foot/issues/144)).
3402* Crash when `foot.ini` contains an invalid section name
3403 ([#159](https://codeberg.org/dnkl/foot/issues/159)).
3404* Background opacity when in _reverse video_ mode.
3405* Crash when writing a sixel image that extends outside the terminal's
3406 right margin ([#151](https://codeberg.org/dnkl/foot/issues/151)).
3407* Sixel image at non-zero column positions getting sheared at
3408 seemingly random occasions
3409 ([#151](https://codeberg.org/dnkl/foot/issues/151)).
3410* Crash after either resizing a window or changing the font size if
3411 there were sixels present in the scrollback while doing so.
3412* _Send Device Attributes_ to only send a response if `Ps == 0`.
3413* Paste from primary when clipboard is empty.
3416### Contributors
3418* [craigbarnes](https://codeberg.org/craigbarnes)
3419* [zar](https://codeberg.org/zar)
3422## 1.5.0
3424### Deprecated
3426* `$XDG_CONFIG_HOME/footrc`/`~/.config/footrc`. Use
3427 `$XDG_CONFIG_HOME/foot/foot.ini`/`~/.config/foot/foot.ini` instead.
3428* **scrollback** option in `foot.ini`. Use **scrollback.lines**
3429 instead.
3430* **scrollback-up** key binding. Use **scrollback-up-page** instead.
3431* **scrollback-down** key binding. Use **scrollback-down-page**
3432 instead.
3435### Added
3437* Scrollback position indicator. This feature is optional and
3438 controlled by the **scrollback.indicator-position** and
3439 **scrollback.indicator-format** options in `foot.ini`
3440 ([#42](https://codeberg.org/dnkl/foot/issues/42)).
3441* Key bindings in _scrollback search_ mode are now configurable.
3442* `--check-config` command line option.
3443* **pipe-selected** key binding. Works like **pipe-visible** and
3444 **pipe-scrollback**, but only pipes the currently selected text, if
3445 any ([#51](https://codeberg.org/dnkl/foot/issues/51)).
3446* **mouse.hide-when-typing** option to `foot.ini`.
3447* **scrollback.multiplier** option to `foot.ini`
3448 ([#54](https://codeberg.org/dnkl/foot/issues/54)).
3449* **colors.selection-foreground** and **colors.selection-background**
3450 options to `foot.ini`.
3451* **tweak.render-timer** option to `foot.ini`.
3452* Modifier support in mouse bindings
3453 ([#77](https://codeberg.org/dnkl/foot/issues/77)).
3454* Click count support in mouse bindings, i.e double- and triple-click
3455 ([#78](https://codeberg.org/dnkl/foot/issues/78)).
3456* All mouse actions (begin selection, select word, select row etc) are
3457 now configurable, via the new **select-begin**,
3458 **select-begin-block**, **select-extend**, **select-word**,
3459 **select-word-whitespace** and **select-row** options in the
3460 **mouse-bindings** section in `foot.ini`
3461 ([#79](https://codeberg.org/dnkl/foot/issues/79)).
3462* Implement XTSAVE/XTRESTORE escape sequences, `CSI ? Ps s` and `CSI ?
3463 Ps r` ([#91](https://codeberg.org/dnkl/foot/issues/91)).
3464* `$COLORTERM` is now set to `truecolor` at startup, to indicate
3465 support for 24-bit RGB colors.
3466* Experimental support for rendering double-width glyphs with a
3467 character width of 1. Must be explicitly enabled with
3468 `tweak.allow-overflowing-double-width-glyphs`
3469 ([#116](https://codeberg.org/dnkl/foot/issues/116)).
3470* **initial-window-size-pixels** options to `foot.ini` and
3471 `-w,--window-size-pixels` command line option to `foot`. This option
3472 replaces the now deprecated **geometry** and `-g,--geometry`
3473 options.
3474* **initial-window-size-chars** option to `foot.ini` and
3475 `-W,--window-size-chars` command line option to `foot`. This option
3476 configures the initial window size in **characters**, and is an
3477 alternative to **initial-window-size-pixels**.
3478* **scrollback-up-half-page** and **scrollback-down-half-page** key
3479 bindings. They scroll up/down half of a page in the scrollback
3480 ([#128](https://codeberg.org/dnkl/foot/issues/128)).
3481* **scrollback-up-line** and **scrollback-down-line** key
3482 bindings. They scroll up/down a single line in the scrollback.
3483* **mouse.alternate-scroll-mode** option to `foot.ini`. This option
3484 controls the initial state of the _Alternate Scroll Mode_, and
3485 defaults to `yes`. When enabled, mouse scroll events are translated
3486 to up/down key events in the alternate screen, letting you scroll in
3487 e.g. `less` and other applications without enabling native mouse
3488 support in them ([#135](https://codeberg.org/dnkl/foot/issues/135)).
3491### Changed
3493* Renamed man page for `foot.ini` from **foot**(5) to **foot.ini**(5).
3494* Configuration errors are no longer fatal; foot will start and print
3495 an error inside the terminal (and of course still log errors on
3496 stderr).
3497* Default `--server` socket path to use `$WAYLAND_DISPLAY` instead of
3498 `$XDG_SESSION_ID` ([#55](https://codeberg.org/dnkl/foot/issues/55)).
3499* Trailing empty cells are no longer highlighted in mouse selections.
3500* Foot now searches for its configuration in
3501 `$XDG_DATA_DIRS/foot/foot.ini`, if no configuration is found in
3502 `$XDG_CONFIG_HOME/foot/foot.ini` or in `$XDG_CONFIG_HOME/footrc`.
3503* Minimum window size changed from four rows and 20 columns, to 1 row
3504 and 2 columns.
3505* **scrollback-up/down** renamed to **scrollback-up/down-page**.
3506* fcft >= 2.3.0 is now required.
3509### Fixed
3511* Command lines for **pipe-visible** and **pipe-scrollback** are now
3512 tokenized (i.e. syntax checked) when the configuration is loaded,
3513 instead of every time the key binding is executed.
3514* Incorrect multi-column character spacer insertion when reflowing
3515 text.
3516* Compilation errors in 32-bit builds.
3517* Mouse cursor style in top and left margins.
3518* Selection is now **updated** when the cursor moves outside the grid
3519 ([#70](https://codeberg.org/dnkl/foot/issues/70)).
3520* Viewport sometimes not moving when doing a scrollback search.
3521* Crash when canceling a scrollback search and the window had been
3522 resized while searching.
3523* Selection start point not moving when the selection changes
3524 direction.
3525* OSC 10/11/104/110/111 (modify colors) did not update existing screen
3526 content ([#94](https://codeberg.org/dnkl/foot/issues/94)).
3527* Extra newlines when copying empty cells
3528 ([#97](https://codeberg.org/dnkl/foot/issues/97)).
3529* Mouse events from being sent to client application when a mouse
3530 binding has consumed it.
3531* Input events from getting mixed with paste data
3532 ([#101](https://codeberg.org/dnkl/foot/issues/101)).
3533* Missing DPI values for "some" monitors on Gnome
3534 ([#118](https://codeberg.org/dnkl/foot/issues/118)).
3535* Handling of multi-column composed characters while reflowing.
3536* Escape sequences sent for key combinations with `Return`, that did
3537 **not** include `Alt`.
3538* Clipboard (or primary selection) is now cleared when receiving an
3539 OSC-52 command with an invalid base64 encoded payload.
3540* Cursor position being set outside the grid when reflowing text.
3541* CSD buttons to be hidden when window size becomes so small that they
3542 no longer fit.
3545### Contributors
3547* [craigbarnes](https://codeberg.org/craigbarnes)
3548* [birger](https://codeberg.org/birger)
3549* [Ordoviz](https://codeberg.org/Ordoviz)
3550* [cherti](https://codeberg.org/cherti)
3553## 1.4.4
3554### Changed
3556* Mouse cursor is now always a `left_ptr` when inside the margins, to
3557 indicate it is not possible to start a selection.
3560### Fixed
3562* Crash when starting a selection inside the margins.
3563* Improved font size consistency across multiple monitors with
3564 different DPI ([#47](https://codeberg.org/dnkl/foot/issues/47)).
3565* Handle trailing comments in `footrc`
3568## 1.4.3
3569### Added
3571* Section to [README.md](README.md) describing how to programmatically
3572 identify foot.
3573* [LICENSE](LICENSE), [README.md](README.md) and
3574 [CHANGELOG.md](CHANGELOG.md) are now installed to
3575 `${datadir}/doc/foot`.
3576* Support for escaping quotes in **pipe-visible** and
3577 **pipe-scrollback** commands.
3580### Changed
3582* Primary DA to no longer indicate support for _Selective Erase_,
3583 _Technical Characters_ and _Terminal State Interrogation_.
3584* Secondary DA to report foot as a VT220 instead of a VT420.
3585* Secondary DA to report foot's version number in parameter 2, the
3586 _Firmware Version_. The string is made up of foot's major, minor and
3587 patch version numbers, always using two digits for each version
3588 number and without any other separating characters. Thus, _1.4.2_
3589 would be reported as `010402` (i.e. the full response would be
3590 `\E[>1;010402;0c`).
3591* Scrollback search to only move the viewport if the match lies
3592 outside it.
3593* Scrollback search to focus match, that requires a viewport change,
3594 roughly in the center of the screen.
3595* Extending a selection with the right mouse button now works while
3596 dragging the mouse.
3599### Fixed
3601* Crash in scrollback search.
3602* Crash when a **pipe-visible** or **pipe-scrollback** command
3603 contained an unclosed quote
3604 ([#49](https://codeberg.org/dnkl/foot/issues/49)).
3607### Contributors
3609* [birger](https://codeberg.org/birger)
3610* [cherti](https://codeberg.org/cherti)
3613## 1.4.2
3615### Changed
3617* Maximum window title length from 100 to 2048.
3620### Fixed
3622* Crash when overwriting a sixel and the row being overwritten did not
3623 cover an entire cell.
3624* Assertion failure in debug builds when overwriting a sixel image.
3627## 1.4.1
3629### Fixed
3631* Compilation errors in release builds with some combinations of
3632 compilers and compiler flags.
3635## 1.4.0
3637### Added
3639* `Sync` to terminfo. This is a tmux extension that indicates
3640 _"Synchronized Updates"_ are supported.
3641* `--hold` command line option to `footclient`.
3642* Key mapping for `KP_Decimal`.
3643* Terminfo entries for keypad keys: `ka1`, `ka2`, `ka3`, `kb1`, `kb3`,
3644 `kc1`, `kc2`, `kc3`, `kp5`, `kpADD`, `kpCMA`, `kpDIV`, `kpDOT`,
3645 `kpMUL`, `kpSUB` and `kpZRO`.
3646* **blink** option to `footrc`; a boolean that lets you control
3647 whether the cursor should blink or not by default. Note that
3648 applications can override this.
3649* Multi-seat support
3650* Implemented `C0::FF` (form feed)
3651* **pipe-visible** and **pipe-scrollback** key bindings. These let you
3652 pipe either the currently visible text, or the entire scrollback to
3653 external tools ([#29](https://codeberg.org/dnkl/foot/issues/29)). Example:
3654 `pipe-visible=[sh -c "xurls | bemenu | xargs -r firefox] Control+Print`
3657### Changed
3659* Background transparency to only be used with the default background
3660 color.
3661* Copy-to-clipboard/primary-selection to insert a line break if either
3662 the last cell on the previous line or the first cell on the next
3663 line is empty.
3664* Number of lines to scroll is now always clamped to the number of
3665 lines in the scrolling region..
3666* New terminal windows spawned with `ctrl`+`shift`+`n` are no longer
3667 double forked.
3668* Unicode combining character overflow errors are only logged when
3669 debug logging has been enabled.
3670* OSC 4 (_Set Color_) now updates already rendered cells, excluding
3671 scrollback.
3672* Mouse cursor from `hand2` to `left_ptr` when client is capturing the
3673 mouse.
3674* Sixel images are now removed when the font size is **decreased**.
3675* `DECSCUSR` (_Set Cursor Style_, `CSI Ps SP q`) now uses `Ps=0`
3676 instead of `Ps=2` to reset the style to the user configured default
3677 style. `Ps=2` now always configures a _Steady Block_ cursor.
3678* `Se` terminfo capability from `\E[2 q` to `\E[ q`.
3679* Hollow cursor to be drawn when window has lost _keyboard_ focus
3680 rather than _visual_ focus.
3683### Fixed
3685* Do not stop an ongoing selection when `shift` is released. When the
3686 client application is capturing the mouse, one must hold down
3687 `shift` to start a selection. This selection is now finalized only
3688 when the mouse button is released - not as soon as `shift` is
3689 released.
3690* Selected cells did not appear selected if programmatically modified.
3691* Rare crash when scrolling and the new viewport ended up **exactly**
3692 on the wrap around.
3693* Selection handling when viewport wrapped around.
3694* Restore signal mask in the client process.
3695* Set `IUTF8`.
3696* Selection of double-width characters. It is no longer possible to
3697 select half of a double-width character.
3698* Draw hollow block cursor on top of character.
3699* Set an initial `TIOCSWINSZ`. This ensures clients never read a
3700 `0x0` terminal size ([#20](https://codeberg.org/dnkl/foot/issues/20)).
3701* Glyphs overflowing into surrounding cells
3702 ([#21](https://codeberg.org/dnkl/foot/issues/21)).
3703* Crash when last rendered cursor cell had scrolled off screen and
3704 `\E[J3` was executed.
3705* Assert (debug builds) when an `\e]4` OSC escape was not followed by
3706 a `;`.
3707* Window title always being set to "foot" on reset.
3708* Terminfo entry `kb2` (center keypad key); it is now set to `\EOu`
3709 (which is what foot emits) instead of the incorrect value `\EOE`.
3710* Palette reuse in sixel images. Previously, the palette was reset
3711 after each image.
3712* Do not auto-resize a sixel image for which the client has specified
3713 a size. This fixes an issue where an image would incorrectly
3714 overflow into the cell row beneath.
3715* Text printed, or other sixel images drawn, on top of a sixel image
3716 no longer erases the entire image, only the part(s) covered by the
3717 new text or image.
3718* Sixel images being erased when printing text next to them.
3719* Sixel handling when resizing window.
3720* Sixel handling when scrollback wraps around.
3721* Foot now issues much fewer `wl_surface_damage_buffer()` calls
3722 ([#35](https://codeberg.org/dnkl/foot/issues/35)).
3723* `C0::VT` to be processed as `C0::LF`. Previously, `C0::VT` would
3724 only move the cursor down, but never scroll.
3725* `C0::HT` (_Horizontal Tab_, or `\t`) no longer clears `LCF` (_Last
3726 Column Flag_).
3727* `C0::LF` now always clears `LCF`. Previously, it only cleared it
3728 when the cursor was **not** at the bottom of the scrolling region.
3729* `IND` and `RI` now clears `LCF`.
3730* `DECAWM` now clears `LCF`.
3731* A multi-column character that does not fit on the current line is
3732 now printed on the next line, instead of only printing half the
3733 character.
3734* Font size can no longer be reduced to negative values
3735 ([#38](https://codeberg.org/dnkl/foot/issues/38)).
3738## 1.3.0
3740### Added
3742* User configurable key- and mouse bindings. See `man 5 foot` and the
3743 example `footrc` ([#1](https://codeberg.org/dnkl/foot/issues/1))
3744* **initial-window-mode** option to `footrc`, that lets you control
3745 the initial mode for each newly spawned window: _windowed_,
3746 _maximized_ or _fullscreen_.
3747* **app-id** option to `footrc` and `--app-id` command line option,
3748 that sets the _app-id_ property on the Wayland window.
3749* **title** option to `footrc` and `--title` command line option, that
3750 sets the initial window title.
3751* Right mouse button extends the current selection.
3752* `CSI Ps ; Ps ; Ps t` escape sequences for the following parameters:
3753 `11t`, `13t`, `13;2t`, `14t`, `14;2t`, `15t`, `19t`.
3754* Unicode combining characters.
3757### Changed
3759* Spaces no longer removed from zsh font name completions.
3760* Default key binding for _spawn-terminal_ to ctrl+shift+n.
3761* Renderer is now much faster with interactive scrolling
3762 ([#4](https://codeberg.org/dnkl/foot/issues/4))
3763* memfd sealing failures are no longer fatal errors.
3764* Selection to no longer be cleared on resize.
3765* The current monitor's subpixel order (RGB/BGR/V-RGB/V-BGR) is
3766 preferred over FontConfig's `rgba` property. Only if the monitor's
3767 subpixel order is `unknown` is FontConfig's `rgba` property used. If
3768 the subpixel order is `none`, then grayscale antialiasing is
3769 used. The subpixel order is ignored if antialiasing has been
3770 disabled.
3771* The four primary font variants (normal, bold, italic, bold italic)
3772 are now loaded in parallel. This speeds up both the initial startup
3773 time, as well as DPI changes.
3774* Command line parsing no longer tries to parse arguments following
3775 the command-to-execute. This means one can now write `foot sh -c
3776 true` instead of `foot -- sh -c true`.
3779### Removed
3781* Keyboard/pointer handler workarounds for Sway 1.2.
3784### Fixed
3786* Sixel images moved or deleted on window resize.
3787* Cursor sometimes incorrectly restored on exit from alternate screen.
3788* 'Underline' cursor being invisible on underlined text.
3789* Restored cursor position in 'normal' screen when window was resized
3790 while in 'alt' screen.
3791* Hostname in OSC 7 URI not being validated.
3792* OSC 4 with multiple `c;spec` pairs.
3793* Alt+Return to emit "ESC \r".
3794* Trackpad sloooow scrolling to eventually scroll a line.
3795* Memory leak in terminal reset.
3796* Translation of cursor coordinates on resize
3797* Scaling color specifiers in OSC sequences.
3798* `OSC 12 ?` to return the cursor color, not the cursor's text color.
3799* `OSC 12;#000000` to configure the cursor to use inverted
3800 foreground/background colors.
3801* Call `ioctl(TIOCSCTTY)` on the pts fd in the slave process.
3804## 1.2.3
3806### Fixed
3807* Forgot to version bump 1.2.2
3810## 1.2.2
3812### Changed
3814* Changed icon name in `foot.desktop` and `foot-server.desktop` from
3815 _terminal_ to _utilities-terminal_.
3816* `XDG_SESSION_ID` is now included in the server/daemon default socket
3817 path.
3820### Fixed
3822* Window size doubling when moving window between outputs with
3823 different scaling factors ([#3](https://codeberg.org/dnkl/foot/issues/3)).
3824* Font being too small on monitors with fractional scaling
3825 ([#5](https://codeberg.org/dnkl/foot/issues/5)).
3828## 1.2.1
3830### Fixed
3832* Building AUR package
3835## 1.2.0
3837### Added
3839* Run-time text resize using ctrl-+, ctrl+- and ctrl+0
3840* Font size adjusts dynamically to outputs' DPI
3841* Reflow text when resizing window
3842* **pad** option to `footrc`
3843* **login-shell** option to `footrc` and `--login-shell` command line
3844 option
3845* Client side decorations (CSDs). This finally makes foot usable on
3846 GNOME.
3847* Sixel graphics support
3848* OSC 12 and 112 escape sequences (set/reset text cursor color)
3849* REP CSI escape sequence
3850* `oc` to terminfo
3851* foot-server.desktop file
3852* Window and cell size reporting escape sequences
3853* `--hold` command line option
3854* `--print-pid=FILE|FD` command line option
3857### Changed
3859* Subpixel antialiasing is only enabled when background is opaque
3860* Meta/alt ESC prefix can now be disabled with `\E[?1036l`. In this
3861 mode, the 8:th bit is set and the result is UTF-8 encoded. This can
3862 also be disabled with `\E[1024l` (in which case the Alt key is
3863 effectively being ignored).
3864* terminfo now uses ST instead of BEL as OSC terminator
3865* Logging to print to stderr, not stdout
3866* Backspace now emits DEL (^?), and ctrl+backspace emits BS (^H)
3869### Removed
3871* '28' from DA response
Diagnostics6 git calls · 1.4 s
CallStatusSizeTime01.4 s
discover200178 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=178
git.server.agent=git/2.56.1-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=178
git.pkt.payload.max=35
ls-refs20010 KiB460 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=390
git.response.bytes=10322
git.response.cache=EXPIRED
git.response.duration_ms=460
git.protocol.version=2
git.pkt.frames=108
git.pkt.data=107
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=10322
git.pkt.payload.max=106
git.ls_refs.count=107
git.ls_refs.head=refs/heads/master
fetchtree:0 · deepen 12001.1 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=1154
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=c0d2c3e95d74cb60526ff28aec9f34ee3df545e0
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=1154
git.pkt.payload.max=1054
git.sideband.band1.bytes=1054
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=1054
git.pack.trailer=f9afe4130b8e969286b1fa36663bbb8999db09ea
Open pack map
fetchtree:0 · deepen 102009.3 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=9489
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=c0d2c3e95d74cb60526ff28aec9f34ee3df545e0
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=9489
git.pkt.payload.max=9389
git.sideband.band1.bytes=9389
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=10
git.pack.bytes=9389
git.pack.ofs_delta=0
git.pack.ref_delta=0
git.pack.chain.max=0
git.pack.trailer=de930681b6073ba5b599a0f956bfbd114762ad5a
git.pack.full=10
Open pack map
fetchcombine:blob:none+tree:2 · deepen 12008.6 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=8830
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=c0d2c3e95d74cb60526ff28aec9f34ee3df545e0
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=8830
git.pkt.payload.max=8730
git.sideband.band1.bytes=8730
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=14
git.pack.bytes=8730
git.fetch.wide.objects=14
git.fetch.wide.extra_bytes=9909
git.fetch.wide.blobs=0
fetch20046 KiB936 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=936
git.response.bytes=46828
git.response.cache=MISS
git.response.duration_ms=936
git.fetch.wants=f5b3aa60c318bde1aa4a2d24ceae82d4d6ffa6c5
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=5
git.pkt.data=4
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=46828
git.pkt.payload.max=46776
git.sideband.band1.bytes=46796
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://codeberg.org/dnkl/foot
Ref
refs/heads/master
Commit
c0d2c3e95d74cb60526ff28aec9f34ee3df545e0
cf-ray
a5e13b29bd851293
Request
cf17111e…
Protocol
v2 · sha1
Agent
git/2.56.1-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format