wlib.wrapperModules.tmux
addFlag
Wrapper for
–add-flag ARG
Prepend the single argument ARG to the invocation of the executable, before any command-line arguments.
This option takes a list. To group them more strongly, option may take a list of lists as well.
Any entry can instead be of type { data, name ? null, before ? [], after ? [] }
This will cause it to be added to the DAG.
If no name is provided, it cannot be targeted.
Type: DAG LIST of (str | path | v ? outPath) or list of (str | path | v ? outPath)
Default:
[ ]
Declared by:
aggressiveResize
Value for setw -g aggressive-resize.
Type: boolean
Default:
false
Declared by:
aliases
Aliases for the package to also be added to the PATH
Type: list of string
Default:
[ ]
Declared by:
allowPassthrough
Value for set -gq allow-passthrough.
Type: boolean
Default:
true
Declared by:
appendFlag
–append-flag ARG
Append the single argument ARG to the invocation of the executable, after any command-line arguments.
This option takes a list. To group them more strongly, option may take a list of lists as well.
Any entry can instead be of type { data, name ? null, before ? [], after ? [] }
This will cause it to be added to the DAG.
If no name is provided, it cannot be targeted.
Type: DAG LIST of (str | path | v ? outPath) or list of (str | path | v ? outPath)
Default:
[ ]
Declared by:
argv0
–argv0 NAME
Set the name of the executed process to NAME. If unset or empty, defaults to EXECUTABLE.
overrides the setting from argv0type if set.
Type: null or string
Default:
null
Declared by:
argv0type
argv0 overrides this option if not null or unset
"inherit":
--inherit-argv0
The executable inherits argv0 from the wrapper.
Use instead of --argv0 '$0'.
"resolve":
--resolve-argv0
If argv0 does not include a “/” character, resolve it against PATH.
Type: one of “resolve”, “inherit”
Default:
"inherit"
Declared by:
baseIndex
Value for set -g base-index.
Type: signed integer
Default:
1
Declared by:
chdir
–chdir DIR
Change working directory before running the executable.
Use instead of --run "cd DIR".
Type: DAG LIST of str | path | v ? outPath
Default:
[ ]
Declared by:
clock24
use 24 hour clock instead of 12 hour clock
Type: boolean
Default:
true
Declared by:
configAfter
configuration to run after all tmux plugins are sourced
Type: strings concatenated with “\n”
Default:
""
Declared by:
configBefore
configuration to run before all tmux plugins are sourced
Type: strings concatenated with “\n”
Default:
""
Declared by:
disableConfirmationPrompt
disable the confirmation prompt for kill-window and kill-pane keybindings.
Type: boolean
Default:
true
Declared by:
displayPanesColour
Value for set -g display-panes-colour.
Type: string
Default:
"default"
Declared by:
env
Environment variables to set in the wrapper.
This option takes a set.
Any entry can instead be of type { data, before ? [], after ? [] }
This will cause it to be added to the DAG, which will cause the resulting wrapper argument to be sorted accordingly
Type: DAG of str | path | v ? outPath
Default:
{ }
Declared by:
envDefault
Environment variables to set in the wrapper.
Like env, but only adds the variable if not already set in the environment.
This option takes a set.
Any entry can instead be of type { data, before ? [], after ? [] }
This will cause it to be added to the DAG, which will cause the resulting wrapper argument to be sorted accordingly
Type: DAG of str | path | v ? outPath
Default:
{ }
Declared by:
escapeTime
Value for set -s escape-time.
Type: signed integer
Default:
500
Declared by:
extraPackages
Additional packages to add to the wrapper’s runtime PATH. This is useful if the wrapped program needs additional libraries or tools to function correctly.
Adds all its entries to the DAG under the name NIX_PATH_ADDITIONS
Type: list of package
Default:
[ ]
Declared by:
filesToExclude
List of file paths (glob patterns) relative to package root to exclude from the wrapped package.
This allows filtering out unwanted binaries or files.
Example: [ "bin/unwanted-tool" "share/applications/*.desktop" ]
Type: list of string
Default:
[ ]
Declared by:
filesToPatch
List of file paths (glob patterns) relative to package root to patch for self-references. Desktop files are patched by default to update Exec= and Icon= paths.
Type: list of string
Default:
[
"share/applications/*.desktop"
]
Declared by:
flagSeparator
Separator between flag names and values when generating args from flags.
" " for --flag value or "=" for --flag=value
Type: string
Default:
" "
Declared by:
flags
Flags to pass to the wrapper. The key is the flag name, the value is the flag value. If the value is true, the flag will be passed without a value. If the value is false or null, the flag will not be passed. If the value is a list, the flag will be passed multiple times with each value.
This option takes a set.
Any entry can instead be of type { data, before ? [], after ? [] }
This will cause it to be added to the DAG, which will cause the resulting wrapper argument to be sorted accordingly
Type: DAG of null or boolean or (str | path | v ? outPath) or list of (str | path | v ? outPath)
Default:
{ }
Declared by:
historyLimit
Value for set -g history-limit.
Type: signed integer
Default:
2000
Declared by:
makeWrapper
makeWrapper implementation to use (default pkgs.makeWrapper)
prefer useBinaryWrapper boolean if using wlib.modules.makeWrapper
as doing so will disable fields it does not support as well.
Type: null or package
Default:
null
Declared by:
modeKeys
Value for set -g mode-keys.
Type: string
Default:
"emacs"
Declared by:
mouse
Enable mouse mode.
Type: boolean
Default:
true
Declared by:
paneBaseIndex
Value for setw -g pane-base-index.
Type: signed integer
Default:
1
Declared by:
plugins
List of tmux plugins to source.
Type: list of (package or (submodule))
Default:
[ ]
Declared by:
prefix
Set the prefix key for tmux.
Type: string
Default:
"C-b"
Declared by:
prefixContents
–prefix-contents ENV SEP FILES
Like --suffix-each, but contents of FILES are read first and used as VALS.
Type: DAG LIST of (List of length 3)
Default:
[ ]
Declared by:
prefixVar
–prefix ENV SEP VAL
Prefix ENV with VAL, separated by SEP.
Type: DAG LIST of (List of length 3)
Default:
[ ]
Declared by:
rawWrapperArgs
DAG list (DAL) or dependency list of wrapper arguments, escaped with lib.escapeShellArgs
wrapper arguments refers to this:
pkgs/build-support/setup-hooks/make-wrapper.sh
pkgs/by-name/ma/makeBinaryWrapper/make-binary-wrapper.sh
This option takes a list. To group them more strongly, option may take a list of lists as well.
Any entry can instead be of type { data, name ? null, before ? [], after ? [] }
This will cause it to be added to the DAG.
If no name is provided, it cannot be targeted.
Type: DAG LIST of (str | path | v ? outPath) or list of (str | path | v ? outPath)
Default:
[ ]
Declared by:
runShell
–run COMMAND
Run COMMAND before executing the main program.
This option takes a list. To group them more strongly, option may take a list of lists as well.
Any entry can instead be of type { data, name ? null, before ? [], after ? [] }
This will cause it to be added to the DAG.
If no name is provided, it cannot be targeted.
Type: DAG LIST of str | path | v ? outPath
Default:
[ ]
Declared by:
runtimeLibraries
Additional libraries to add to the wrapper’s runtime LD_LIBRARY_PATH. This is useful if the wrapped program needs additional libraries or tools to function correctly.
Adds all its entries to the DAG under the name NIX_LIB_ADDITIONS
Type: list of package
Default:
[ ]
Declared by:
secureSocket
Store tmux socket under /run, which is more
secure than /tmp, but as a downside it doesn’t
survive user logout.
Type: boolean
Default:
false
Declared by:
setEnvironment
attrset of environment variables to set when the tmux session is created.
set-environment -g ${key} "${value}"
Type: attribute set of (string or package)
Default:
{ }
Declared by:
shell
set -g default-shell
Type: null or string
Default:
null
Declared by:
sourceSensible
Start with defaults from tmuxPlugins.sensible
Type: boolean
Default:
true
Declared by:
statusKeys
Value for set -g status-keys.
Type: string
Default:
"emacs"
Declared by:
suffixContents
–suffix-contents ENV SEP FILES
Like --prefix-each, but contents of FILES are read first and used as VALS.
Type: DAG LIST of (List of length 3)
Default:
[ ]
Declared by:
suffixVar
–suffix ENV SEP VAL
Suffix ENV with VAL, separated by SEP.
Type: DAG LIST of (List of length 3)
Default:
[ ]
Declared by:
terminal
Value for set -g default-terminal.
Type: string
Default:
"screen"
Declared by:
terminalOverrides
Value for set -ga terminal-overrides.
Type: null or string
Default:
null
Declared by:
unsafeWrapperArgs
DAG list (DAL) or dependency list of wrapper arguments, concatenated with spaces
wrapper arguments refers to this:
pkgs/build-support/setup-hooks/make-wrapper.sh
pkgs/by-name/ma/makeBinaryWrapper/make-binary-wrapper.sh
This option takes a list. To group them more strongly, option may take a list of lists as well.
Any entry can instead be of type { data, name ? null, before ? [], after ? [] }
This will cause it to be added to the DAG.
If no name is provided, it cannot be targeted.
Type: DAG LIST of (str | path | v ? outPath) or list of (str | path | v ? outPath)
Default:
[ ]
Declared by:
unsetVar
–unset VAR
Remove VAR from the environment.
Type: DAG LIST of string
Default:
[ ]
Declared by:
updateEnvironment
List of environment variables to update when the tmux session is created.
set-option -ga update-environment <your list of variables>
Type: list of string
Default:
[
"TERM"
"TERM_PROGRAM"
]
Declared by:
useBinaryWrapper
changes the makeWrapper implementation from pkgs.makeWrapper to pkgs.makeBinaryWrapper
also disables --run, --prefix-contents, and --suffix-contents,
as they are not supported by pkgs.makeBinaryWrapper
Type: boolean
Default:
false
Declared by:
vimVisualKeys
v and y keybindings for copy-mode-vi.
Type: boolean
Default:
false
Declared by:
visualActivity
Value for set -g visual-activity.
Type: boolean
Default:
false
Declared by:
wrapperArgEscaping
Controls which wlib.modules.makeWrapperBase option to pass the generated wrapper arguments to
if value is true then the wrapper arguments will be passed to config.rawWrapperArgs
if value is false then the wrapper arguments will be passed to config.unsafeWrapperArgs
WARNING: These arguments are passed to makeWrapper at build time! Not escaping may not do what you expect!
Type: boolean
Default:
true
Declared by: