Go to file
Michael Grant 54634fad24 image: fix scroll-triggered erasure and Kitty placement leaks
The scroll-damage redraw path (redraw_draw_damage_rect()) always ran
its text-only pass even when imagescroll's trust skipped recompositing
the image on top, painting blank cells directly over image content
with nothing left to correct it. redraw_draw_pane_span() now consults
a new image_grid_next_span() to exclude any column range an image
occupies from that text pass.

The same path also never called the existing image_redraw_start()/
kitty_redraw_start() placement cleanup that the full-pane redraw path
already had, so every scroll of a Kitty-protocol image added a new set
of placements without deleting the stale ones, which the terminal then
rendered as an overlapping smudge. Added the missing call, skipped
when imagescroll is trusting the terminal not to need replacing.
2026-09-23 16:12:05 +01:00
2026-09-21 22:34:05 +01:00
2026-03-01 17:01:08 +00:00
2020-05-19 12:34:34 +01:00
2026-09-11 09:05:06 +01:00
2026-03-25 10:38:03 +00:00
2026-08-25 11:23:52 +01:00
2026-07-13 10:29:28 +01:00
2026-08-25 11:53:39 +01:00

Welcome to tmux!

tmux is a terminal multiplexer: it enables a number of terminals to be created,
accessed, and controlled from a single screen. tmux may be detached from a
screen and continue running in the background, then later reattached.

This release runs on OpenBSD, FreeBSD, NetBSD, Linux, macOS and Solaris.

* Dependencies

tmux depends on libevent 2.x, available from:

	https://github.com/libevent/libevent/releases/latest

It also depends on ncurses, available from:

	https://invisible-mirror.net/archives/ncurses/

To build tmux, a C compiler (for example gcc or clang), make, pkg-config and a
suitable yacc (yacc or bison) are needed.

* Installation

To build and install tmux from a release tarball, use:

	$ ./configure && make
	$ sudo make install

tmux can use the utempter library to update utmp(5), if it is installed - run
configure with --enable-utempter to enable this.

To get and build the latest from version control - note that this requires
autoconf, automake and pkg-config:

	$ git clone https://github.com/tmux/tmux.git
	$ cd tmux
	$ sh autogen.sh
	$ ./configure && make
	$ sudo make install

* Contributing

Bug reports, feature suggestions and especially code contributions are most
welcome. Please send by email to:

	tmux-users@googlegroups.com

Or open a GitHub issue or pull request.

* Documentation

For documentation on using tmux, see the tmux.1 manpage. View it from the
source tree with:

	$ nroff -mdoc tmux.1|less

A small example configuration is in example_tmux.conf.

Other documentation is available in the wiki:

	https://github.com/tmux/tmux/wiki

Also see the tmux FAQ at:

	https://github.com/tmux/tmux/wiki/FAQ

A bash(1) completion file is at:

	https://github.com/scop/bash-completion/blob/main/completions/tmux

For debugging, run tmux with -v and -vv to generate server and client log files
in the current directory.

* Support

The tmux mailing list for general discussion and bug reports is:

	https://groups.google.com/forum/#!forum/tmux-users

Subscribe by sending an email to:

	tmux-users+subscribe@googlegroups.com

* License

This file and the CHANGES files are licensed under the ISC license. All other
files have a license and copyright notice at their start.
Description
tmux source code
Readme 155 MiB
Languages
C 72.9%
Shell 19.4%
Roff 5.6%
Yacc 0.9%
M4 0.7%
Other 0.4%