<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/doc, branch 1.20.0</title>
<subtitle>A fast, lightweight and minimalistic Wayland terminal emulator</subtitle>
<id>https://git.0x0f.dev/mirrors/foot.git/atom?h=1.20.0</id>
<link rel='self' href='https://git.0x0f.dev/mirrors/foot.git/atom?h=1.20.0'/>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/'/>
<updated>2024-12-22T06:16:12Z</updated>
<entry>
<title>osc: add option to disable OSC-52, partially or fully</title>
<updated>2024-12-22T06:16:12Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-12-21T05:52:00Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=e38ec79be15fe355bf50670bc9066210ae0ed211'/>
<id>urn:sha1:e38ec79be15fe355bf50670bc9066210ae0ed211</id>
<content type='text'>
Closes #1867
</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>config: add color.sixelN options</title>
<updated>2024-10-23T06:35:30Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-10-23T06:35:30Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=511aad419b9c869972902fe88b4f593b0faa6719'/>
<id>urn:sha1:511aad419b9c869972902fe88b4f593b0faa6719</id>
<content type='text'>
These options allows you to configure the default sixel color palette.
</content>
</entry>
<entry>
<title>toplevel-icon: implement OSC-1, CSI 20/21/22/23 t</title>
<updated>2024-09-13T07:04:17Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-09-10T16:53:38Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=97ec375c67cc7b071b0478b6c887057008dc469e'/>
<id>urn:sha1:97ec375c67cc7b071b0478b6c887057008dc469e</id>
<content type='text'>
* The toplevel icon is now set to the app-id, unless "overridden" by
  OSC-1 or OSC-0.
* Implemented OSC-1
* OSC-0 extended to also set the icon
* Implemented CSI 20 t - report window icon
* Implemented CSI 21 t - report window title
* Implemented CSI 22 ; 1 t - push window icon
* Implemented CS 23 ; 1 t - pop window icon
* Extended CSI 22/23 ; 0 t to also push/pop the icon
* Verify app-id set by OSC-176 is valid UTF-8
* Verify icon set by OSC-0/1 is valid UTF-8
</content>
</entry>
<entry>
<title>add setting for strikeout thickness</title>
<updated>2024-08-26T17:34:47Z</updated>
<author>
<name>Oleh Hushchenkov</name>
<email>o.hushchenkov@gmail.com</email>
</author>
<published>2024-08-25T08:28:21Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=b47a4dd2553b7f4db5a385b15bc7cb559c9932db'/>
<id>urn:sha1:b47a4dd2553b7f4db5a385b15bc7cb559c9932db</id>
<content type='text'>
</content>
</entry>
<entry>
<title>feature: add resize-keep-grid to allow text reflow on font changes</title>
<updated>2024-08-20T05:07:29Z</updated>
<author>
<name>Andrew J. Hesford</name>
<email>ajh@sideband.org</email>
</author>
<published>2024-08-14T14:35:58Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=1969717527a956483ba1c37aab3fcf7e8560e26a'/>
<id>urn:sha1:1969717527a956483ba1c37aab3fcf7e8560e26a</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: document the Unicode ranges covered by the builtin glyphs</title>
<updated>2024-08-09T06:24:53Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-08-09T06:24:53Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=481ce82d661e1f3f4a05813bb209f2184b1f61c9'/>
<id>urn:sha1:481ce82d661e1f3f4a05813bb209f2184b1f61c9</id>
<content type='text'>
</content>
</entry>
<entry>
<title>osc: kitty notifications: add support for XDG sound names</title>
<updated>2024-08-04T13:23:31Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-08-04T13:21:06Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=84d36606cbd3e35aae6a68e69101b22da60dbe99'/>
<id>urn:sha1:84d36606cbd3e35aae6a68e69101b22da60dbe99</id>
<content type='text'>
</content>
</entry>
<entry>
<title>osc: kitty notifications: implement s=silent</title>
<updated>2024-08-04T12:20:35Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-08-04T12:16:56Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=63492624918cd23a5efdd9b8a8b4f057da66d961'/>
<id>urn:sha1:63492624918cd23a5efdd9b8a8b4f057da66d961</id>
<content type='text'>
This implements part of the new 's' (sound) parameter; the 'silent'
value. When s=silent, we set the ${muted} template argument to
"true". It is intended to set the 'suppress-sound' hint:

    notify-send --hint BOOLEAN:suppress-sound:${muted}
</content>
</entry>
<entry>
<title>doc: foot.ini: codespell: furhermore -&gt; furthermore</title>
<updated>2024-08-02T06:24:03Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-08-02T06:22:37Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ebd8ad893710d87f5275e98127f1e70eb9338ea5'/>
<id>urn:sha1:ebd8ad893710d87f5275e98127f1e70eb9338ea5</id>
<content type='text'>
</content>
</entry>
<entry>
<title>osc: kitty notifications: cleanup and update to latest version of spec</title>
<updated>2024-08-02T06:07:13Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-08-02T06:07:13Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ea2f0e7c3f29f2ba83ad71e36c6751bb571f826f'/>
<id>urn:sha1:ea2f0e7c3f29f2ba83ad71e36c6751bb571f826f</id>
<content type='text'>
* Don't store a list of unfinished notifications. Use a single one. If
  the notification ID of the 'current' notification doesn't match the
  previous, unfinished one, the 'current' notification replaces the
  previous one, instead of updating it.

* Update xstrjoin() to take an optional delimiter (for example ','),
  and use that when joining categories and 'alive IDs'.

* Rename ${action-arg} to ${action-argument}

* Update handling of the 'n' parameter (symbolic icon name); the spec
  allows it to be used multiple times, and the terminal is supposed to
  pick the first one it can resolve. Foot can't resolve icons at all,
  neither can 'notify-send' or 'fyi' (which is what foot typically
  executes to display a notification); it's the notification daemon that
  resolves icons.

  The spec _could_ be interpreted to mean the terminal should lookup
  .desktop files, and use the value of the 'Icon' key from the first
  matching .desktop files. But foot doesn't read .desktop files, and I
  don't intend to implement XDG directory scanning and parsing of
  .desktop files just to figure out which icon to use.

  Instead, use a simple heuristics; use the *shortest* symbolic
  names. The idea is pretty simple: plain icon names are typically
  shorter than .desktop file IDs.
</content>
</entry>
<entry>
<title>osc: kitty notifications: buttons, icons, app-name, categories etc</title>
<updated>2024-07-31T14:22:17Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-31T14:22:17Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=76ac910b118147beba276748d2e2aaca0ee066de'/>
<id>urn:sha1:76ac910b118147beba276748d2e2aaca0ee066de</id>
<content type='text'>
First, icons have been finalized in the specification. There were only
three things we needed to adjust:

* symbolic names are base64 encoded
* there are a couple of OSC-99 defined symbolic names that need to be
  translated to the corresponding XDG icon name.
* allow in-band icons without a cache ID (that is, allow applications
  to use p=icon without having to cache the icon first).

Second, add support for the following new additions to the protocol:

* 'f': custom app-name, overrides the terminal's app-id
* 't': categories
* 'p=alive': lets applications poll for currently active notifications
* 'id' is now 'unset' by default, rather than "0"
* 'w': expire time (i.e. notification timeout)
* "buttons": aka actions. This lets applications add additional (to
  the terminal defined "default" action) actions. The 'activated' event
  has been updated to report which button/action was used to activate
  the notification.

To support button/actions, desktop-notifications.command had to be
reworked a bit.

There's now a new config option:
desktop-notifications.command-action-arg. It has two template
arguments ${action-name} and ${action-label}.

command-action-arg gets expanded for *each* action.

${action-name} and ${action-label} has been replaced by ${action-arg}
in command. This is a somewhat special template, in that it gets
replaced by *all* instances of the expanded actions.
</content>
</entry>
<entry>
<title>notify: ${icon}: don't fallback to app-id</title>
<updated>2024-07-30T15:16:02Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-30T15:16:02Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ba79bf1602c93ebf357f1b9c95f42b2fc0372fc8'/>
<id>urn:sha1:ba79bf1602c93ebf357f1b9c95f42b2fc0372fc8</id>
<content type='text'>
* Revert --icon to ${app-id}
* Use --hint STRING:image-path:${icon} instead
* ${icon} no longer expands to ${app-id} if notification has no icon
</content>
</entry>
<entry>
<title>notify: close notification by sending SIGINT to helper</title>
<updated>2024-07-26T14:28:47Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-26T14:23:17Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9cf99ea4bffd667ae59e4328a28b86dcefacb3f4'/>
<id>urn:sha1:9cf99ea4bffd667ae59e4328a28b86dcefacb3f4</id>
<content type='text'>
If the user hasn't configured a custom 'desktop-notifications.close'
command, try to close the notification by sending SIGINT to the
notification helper.

This is best-effort:

* If there's no helper running, we do nothing (except warn)
* We don't verify, in any way, the notification is actually closed
* We don't send any other signals, under any circumstances. That is,
  no SIGTERM, no SIGKILL. Ever.
</content>
</entry>
<entry>
<title>osc: kitty notifications: implement the 'close' request</title>
<updated>2024-07-25T17:24:28Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-25T17:24:28Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=c4d9f8a8ff4d65b43defb8d63e775e8b91f82bed'/>
<id>urn:sha1:c4d9f8a8ff4d65b43defb8d63e775e8b91f82bed</id>
<content type='text'>
Add a new config option, desktop-notifications.close, defining what to
execute to close a notification. It has a single template parameter,
${id}, that is expanded to the external notification ID foot may have
picked up from the notification helper.

notify-send does not support closing notifications, and it appears
impossible to pass an *unsigned* integer as argument to gdbus. Hence
no default value for the new 'close' option.

Example:

    printf '\e]99;i=123;this is a notification\e\\'
    printf '\e]99;i=123:p=close;\e\\'
</content>
</entry>
<entry>
<title>notify: try to read the daemon assigned notification ID from stdout</title>
<updated>2024-07-24T14:02:19Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-24T14:02:19Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f56da385fe4c4434bfc10c362cbdda58c63d238f'/>
<id>urn:sha1:f56da385fe4c4434bfc10c362cbdda58c63d238f</id>
<content type='text'>
And document the things we recognize in the notification helper's
stdout.
</content>
</entry>
<entry>
<title>config: notify-send: it's "action=label", not "action,label"</title>
<updated>2024-07-24T14:01:42Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-24T14:01:42Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=e271027c0c5166994f4f698befefe0b6a5c382f5'/>
<id>urn:sha1:e271027c0c5166994f4f698befefe0b6a5c382f5</id>
<content type='text'>
</content>
</entry>
<entry>
<title>notify: split up the ${action} template parameter</title>
<updated>2024-07-23T17:08:21Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-23T17:08:21Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ecbec57a4749cc4162d2bb55dd14e1890b6dff31'/>
<id>urn:sha1:ecbec57a4749cc4162d2bb55dd14e1890b6dff31</id>
<content type='text'>
Split it up into two, ${action-name} and ${action-label}.

Dunstify, for example, has a different syntax compared to notify-send:

notify-send: default=foobar
dunstify: default,foobar
</content>
</entry>
<entry>
<title>doc: foot.ini: desktop-notification: remove 'notification dismissal'</title>
<updated>2024-07-23T14:52:18Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-23T14:52:18Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=511d4817d307f75ba68640ab1f394bafaae02844'/>
<id>urn:sha1:511d4817d307f75ba68640ab1f394bafaae02844</id>
<content type='text'>
</content>
</entry>
<entry>
<title>notify: don't focus/report on notification dismissal</title>
<updated>2024-07-23T14:41:52Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2024-07-23T14:41:52Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=045ead985c1e320f289704b6a995d48a5eccf59e'/>
<id>urn:sha1:045ead985c1e320f289704b6a995d48a5eccf59e</id>
<content type='text'>
Only do it when the notification was activated.

Here, activated means the 'click to activate' notification action was
triggered.

How do we tie everything together?

First, we add a new template parameter, ${action}. It's intended to be
used with e.g. notify-send's --action option.

When the action is triggered, notify-send prints its name on stdout,
on a separate line. Look for this in stdout. Only if we've seen it do
we focus/report the notification.
</content>
</entry>
</feed>
