<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/doc/foot.1.scd, branch spawn-terminal-cmdline-arguments</title>
<subtitle>A fast, lightweight and minimalistic Wayland terminal emulator</subtitle>
<id>https://git.0x0f.dev/mirrors/foot.git/atom?h=spawn-terminal-cmdline-arguments</id>
<link rel='self' href='https://git.0x0f.dev/mirrors/foot.git/atom?h=spawn-terminal-cmdline-arguments'/>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/'/>
<updated>2026-06-20T16:13:13Z</updated>
<entry>
<title>main/client: add --class, an alias for --app-id</title>
<updated>2026-06-20T16:13:13Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2026-06-20T16:13:13Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=73e6d21000460cba7b511d984d34112f512a7f29'/>
<id>urn:sha1:73e6d21000460cba7b511d984d34112f512a7f29</id>
<content type='text'>
This is to help e.g. scripts that wants to launch terminal instances
in a terminal agnostic way.

Many terminals were originally for X11, where the '--class' choice was
obvious. When they were ported to Wayland, it made sense for them to
keep the '--class' command line option, but have it set the
application ID instead (since "class" is not a thing on Wayland).

Let's add the alias, but minimally documented. We don't want to
_encourage_ its use after all.

Closes #2368
</content>
</entry>
<entry>
<title>Spawning new terminal with --config from parent instance</title>
<updated>2026-03-02T08:16:36Z</updated>
<author>
<name>Stéphane Klein</name>
<email>contact@stephane-klein.info</email>
</author>
<published>2026-01-08T23:31:04Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=dc0c8550c38ffd0983789573a1a0d4417016c2c7'/>
<id>urn:sha1:dc0c8550c38ffd0983789573a1a0d4417016c2c7</id>
<content type='text'>
Reference: https://codeberg.org/dnkl/foot/issues/1622
Signed-off-by: Stéphane Klein &lt;contact@stephane-klein.info&gt;
</content>
</entry>
<entry>
<title>config: add [colors-dark] and [colors-light], replacing [colors] and [colors2]</title>
<updated>2025-12-20T14:51:30Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2025-12-19T08:29:06Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=cf2b390f6e096e7a2ca93d4dece153eb13261a2e'/>
<id>urn:sha1:cf2b390f6e096e7a2ca93d4dece153eb13261a2e</id>
<content type='text'>
The main reason for having two color sections is to be able to switch
between dark and light. Thus, it's better if the section names reflect
this, rather than the more generic 'colors' and 'colors2' (which was
the dark one and which was the light one, now again?)

When the second color section was added, we kept the original name,
colors, to make sure we didn't break existing configurations, and
third-party themes.

However, in the long run, it's probably better to be specific in the
section naming, to avoid confusion.

So, add 'colors-dark', and 'colors-light'. Keep 'colors' and 'colors2'
as aliases for now, but mark them as deprecated. They WILL be removed
in a future release.

Also rename the option values for initial-color-theme, from 1/2, to
dark/light. Keep the old ones for now, marked as deprecated.

Update all bundled themes to use the new names. In the light-only
themes (i.e. themes that define a single, light, theme), use
colors-light, and set initial-color-theme=light.

Possible improvements: disable color switching if only one color
section has been explicitly configured (todo: figure out how to handle
the default color theme values...)
</content>
</entry>
<entry>
<title>doc: remove duplicated ctrl+shift+w in foot(1)</title>
<updated>2025-12-01T10:38:58Z</updated>
<author>
<name>Whyme Lyu</name>
<email>callme5long@gmail.com</email>
</author>
<published>2025-12-01T10:38:58Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=55f838869443bb34a502c238301e22b4d6f52073'/>
<id>urn:sha1:55f838869443bb34a502c238301e22b4d6f52073</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: add toplevel-tag=TAG</title>
<updated>2025-11-12T10:04:25Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2025-11-12T10:04:25Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=fc9625678fc7e295e7a7e03a5d47db21d4be3010'/>
<id>urn:sha1:fc9625678fc7e295e7a7e03a5d47db21d4be3010</id>
<content type='text'>
Add support for the new xdg-toplevel-tag-v1 Wayland protocol, by
exposing a new config option, `toplevel-tag`, and a corresponding
command option, `--toplevel-tag` (in both `foot` and `footclient`).

This can help the compositor with session management, or custom window
rules.

Closes #2212
</content>
</entry>
<entry>
<title>server/client: add support for sending SIGUSR to footclient</title>
<updated>2025-08-01T07:38:05Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2025-07-31T15:37:19Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=b13a8f12d2d360e0923ee30ff40f25b245576bb5'/>
<id>urn:sha1:b13a8f12d2d360e0923ee30ff40f25b245576bb5</id>
<content type='text'>
This patch adds the IPC infrastructure necessary to propagate
SIGUSR1/SIGUSR2 from a footclient process to the server process.

By targeting a particular footclient instance, only that particular
instance changes theme. This is different from when targeting the
server process, where all instances change theme.

Closes #2156
</content>
</entry>
<entry>
<title>doc: foot: document SIGUSR1/SIGUSR2</title>
<updated>2025-07-30T10:36:32Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2025-07-30T10:25:13Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=3b8d59f4760070801e197aea1c7d6dc6392aafdf'/>
<id>urn:sha1:3b8d59f4760070801e197aea1c7d6dc6392aafdf</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: add search-bindings.delete-to-{start,end} key bindings</title>
<updated>2025-03-05T07:48:23Z</updated>
<author>
<name>Adrian fxj9a</name>
<email>af24@tuta.io</email>
</author>
<published>2025-03-03T13:27:30Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=6d39f66eb7c0cafb9e12be7da6831598c6dd4afb'/>
<id>urn:sha1:6d39f66eb7c0cafb9e12be7da6831598c6dd4afb</id>
<content type='text'>
Defaults to ctrl+u and ctrl+k respectively.

Closes #1972
</content>
</entry>
<entry>
<title>docs: document more default bindings in search scrollback mode.</title>
<updated>2024-10-25T12:58:40Z</updated>
<author>
<name>Mark Stosberg</name>
<email>mark@stosberg.com</email>
</author>
<published>2024-10-25T12:58:40Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=813b514f63e7e36b6c187b3d6062048c8f8bad63'/>
<id>urn:sha1:813b514f63e7e36b6c187b3d6062048c8f8bad63</id>
<content type='text'>
These were introduced by #1496 but not fully documented then.
</content>
</entry>
<entry>
<title>doc: foot: simplify example where we run a non-default command</title>
<updated>2024-04-20T06:17:02Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-04-20T06:17:02Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=edb28479cc1f0b72335f309bf87e2522b6751d9d'/>
<id>urn:sha1:edb28479cc1f0b72335f309bf87e2522b6751d9d</id>
<content type='text'>
To reduce the risk of people mistakenly believing you have to/should
use "sh -c".
</content>
</entry>
<entry>
<title>Add support for opening an existing PTY</title>
<updated>2024-03-14T06:31:03Z</updated>
<author>
<name>Alyssa Ross</name>
<email>hi@alyssa.is</email>
</author>
<published>2021-12-10T17:40:59Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=86894a1cd29f8fb3e5a8487b4ce2d2c1b4cf57a9'/>
<id>urn:sha1:86894a1cd29f8fb3e5a8487b4ce2d2c1b4cf57a9</id>
<content type='text'>
Virtual machine monitor programs (e.g. QEMU, Cloud Hypervisor) expose
guest consoles as PTYs.  With this patch, foot can access these guest
consoles.

Usually, the program used for accessing these PTYs is screen, but
screen is barely developed, doesn't support resizing, and has a bunch
of other unrelated stuff going on.  It would be nice to have a
terminal emulator that properly supported opening an existing PTY.
The VMM controls the master end of the PTY, so to the other end (in
this case foot), it just behaves like any application running in a
directly-opened PTY, and all that's needed is to change foot's code to
support opening an existing PTY rather than creating one.

Co-authored-by: tanto &lt;tanto@ccc.ac&gt;
</content>
</entry>
<entry>
<title>config: map Control+wheel to font increase/decrease</title>
<updated>2024-02-15T15:55:40Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-02-15T15:41:16Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9ca84e6b48dff28aef557b795dd03b1935a1bb14'/>
<id>urn:sha1:9ca84e6b48dff28aef557b795dd03b1935a1bb14</id>
<content type='text'>
This is in addition to the already existing keyboard shortcuts.

Also add missing default keyboard/mouse bindings to readme + foot(1).
</content>
</entry>
<entry>
<title>Don't use fancy Unicode quotes, stick to ASCII</title>
<updated>2024-02-06T11:36:45Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-02-06T11:36:45Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=7999975016a57cc0a2c2e20bc55f29de32df7044'/>
<id>urn:sha1:7999975016a57cc0a2c2e20bc55f29de32df7044</id>
<content type='text'>
</content>
</entry>
<entry>
<title>readme, doc/foot.1: document shell-integration:command-output tracking</title>
<updated>2024-02-06T11:13:09Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-08T11:17:55Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=1393942de38fa6ece726fd861cc15e2a5a369fbd'/>
<id>urn:sha1:1393942de38fa6ece726fd861cc15e2a5a369fbd</id>
<content type='text'>
</content>
</entry>
<entry>
<title>slave: don't skip setting environment variables when using a custom environment</title>
<updated>2024-01-11T15:37:17Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-01-09T15:50:47Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9da7152f834384a354710fcc8f99a6f83e5dfc12'/>
<id>urn:sha1:9da7152f834384a354710fcc8f99a6f83e5dfc12</id>
<content type='text'>
When launching footclient with -E,--client-environment the environment
variables that should be set by foot, wasn't.

Those variables are:

* TERM
* COLORTERM
* PWD
* SHELL

and all variables defined by the user in the [environment] section in
foot.ini.

In the same way, we did not *unset* TERM_PROGRAM and
TERM_PROGRAM_VERSION.

This patch fixes it by "cloning" the custom environment, making it
mutable, and then adding/removing the variables above from it.

Instead of calling setenv()/unsetenv() directly, we add the wrapper
functions add_to_env() and del_from_env().

When *not* using a custom environment, they simply call
setenv()/unsetenv().

When we *are* using a custom environment, add_to_env() first loops all
existing variables, looking for a match. If a match is found, it's
updated with the new value. If it's not found, a new entry is added.

del_from_env() loops all entries, and removes it when a match is
found. If no match is found, nothing is done.

The mutable environment is allocated on the heap, but never free:d. We
don't need to free it, since it's only allocated after forking, in the
child process.

Closes #1568
</content>
</entry>
<entry>
<title>Update documentation regarding systemd units</title>
<updated>2023-07-21T06:12:55Z</updated>
<author>
<name>Max Gautier</name>
<email>mg@max.gautier.name</email>
</author>
<published>2023-02-14T11:11:40Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=555edd60d45b987fb77792356fc2cfdd00a52ce7'/>
<id>urn:sha1:555edd60d45b987fb77792356fc2cfdd00a52ce7</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot: add default key binding for unicode input</title>
<updated>2023-07-10T10:37:10Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-07-10T10:37:10Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=0e1dbbbd06caf9bcf978e9ca2cca3359e77b54df'/>
<id>urn:sha1:0e1dbbbd06caf9bcf978e9ca2cca3359e77b54df</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot: update default key binding for URL mode</title>
<updated>2023-07-10T10:36:55Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-07-10T10:36:55Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=5b74808ed0d60241417a040e4b82514cbfebeb2b'/>
<id>urn:sha1:5b74808ed0d60241417a040e4b82514cbfebeb2b</id>
<content type='text'>
</content>
</entry>
<entry>
<title>bind control-shift-u to unicode-input, move urls to o</title>
<updated>2023-07-10T10:31:51Z</updated>
<author>
<name>Antoine Beaupré</name>
<email>anarcat@debian.org</email>
</author>
<published>2022-12-15T16:49:51Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=080a11eb7374af3335bde3841789bd2b659237c8'/>
<id>urn:sha1:080a11eb7374af3335bde3841789bd2b659237c8</id>
<content type='text'>
Having a keybinding to invoke arbitrary unicode characters is very
useful. It's often used as a method of last resort to communicate with
people outside of your main language. For example, if you want to type
the last letter of my real name, you can invoke the latin-1 character
0xe9 or unicode 0x00e9.

You can also use this to type special characters, for example, unicode
U+1F4A9 is of course, the infamous PILE OF POO, which is sure to
produce million laughs everywhere you go.

In foot, there's no keybinding by default to invoke the very useful
unicode-input command. There is no "standard" (as in "ISO") keybinding
this either. But there *is* a de-facto standard currently deployed
by *both* GTK and Qt (a rare feat) *and* Chrome OS (an even rarer
feat) and it's control-shift-u.

Alternatives include Control-x 8 (emacs), Control V u (vim),
Alt (Windows, LibreOffice), or Option (Mac). I doubt we want to adopt
any of those.

So let's use control-shift-u for this. Unfortunately, it's currently
assigned to show-urls-launch, which is unfortunate, but
insurmountable. We can reassign this keybinding elsewhere. I have
picked control-shift-o in my configuration, because "o" is a good
mnemonic for "open URLs". Others have suggested "m" instead.

Closes: #1183
</content>
</entry>
<entry>
<title>input: add basic support for touchscreen input</title>
<updated>2023-07-05T14:22:28Z</updated>
<author>
<name>CismonX</name>
<email>admin@cismon.net</email>
</author>
<published>2023-07-04T16:19:21Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=d2fcb5343f57c132abec9a21ad89d1505a32c47c'/>
<id>urn:sha1:d2fcb5343f57c132abec9a21ad89d1505a32c47c</id>
<content type='text'>
Closes #517
</content>
</entry>
</feed>
