id       = "byobu"
name     = "Byobu"
homepage = "https://www.byobu.org"
description = "A text-based window manager and terminal multiplexer."
# The folding screen, from the logo byobu.org publishes.
icon     = "https://byobu.org/byobu.svg"
executables   = ["byobu", "byobu-tmux", "byobu-screen"]
platforms = ["linux", "macos"]

[dotfiles]

# byobu(1), the SESSIONS section: "Note that BYOBU_CONFIG_DIR=$XDG_CONFIG_HOME/
# byobu if defined, and $HOME/.byobu otherwise."
# (https://manpages.ubuntu.com/manpages/noble/en/man1/byobu.1.html)
#
# That is two locations rather than one base directory: byobu reads
# $XDG_CONFIG_HOME when it is set, but falls back to ~/.byobu — not to
# ~/.config/byobu — when it is not, so [configHome] alone would miss the
# default installation and ~/.byobu alone would miss an XDG one. Both are
# listed; a consumer skips whichever is absent.
#
# The same man page names the files that live there: `color` and `color.tmux`
# (background colours), `statusrc` (which status notifications are on),
# `datetime` (custom date/time format), `windows`, `windows.tmux` and
# `windows.[NAME]` (window sets to open at launch), and `bin/`, where a user
# drops their own status scripts named `N_NAME`.
paths = [
  "~/.byobu/",
  "[configHome]/byobu/",
]

# Nothing is carved out: the directory holds the user's own colours, status
# selection, window sets and custom status scripts, which is the whole reason
# to carry it.

# byobu stores no credential of its own; the status scripts it ships read
# system state.
secret = []

# No machine_lines. `statusrc` can name a network interface or a disk to watch,
# which would be machine-local, but the man page documents the notifications by
# name rather than the keys the file spells them with, and inventing key names
# would strand the colour and window-set preferences that are the point of
# carrying this directory.