51

I'm new to tmux and trying to understand it's configuration. I've started with looking at some pre-existing .tmux.conf files and whatever documentation I can find but it still leaves me wondering about the flags. I've seen the following so far:

A few examples from the ArchWiki entry on tmux

set -g prefix C-a  
set -ga terminal-overrides ",xterm-termite:Tc"
set-option -g xterm-keys on

And one line from a .tmux.conf file

set-window-option -g

What do the flags mean and are there any particular cases when one flag is preferable over another?

1 Answer 1

72

set is the alias of set-option.

set -g is used to set global options and -ga appends values to existing settings.

From Tmux's man page:

With -a, and if the option expects a string or a style, value is appended to the existing setting. For example:

   set -g status-left "foo"
   set -ag status-left "bar"

Will result in ‘foobar’. And:

   set -g status-style "bg=red"
   set -ag status-style "fg=blue"

Will result in a red background and blue foreground. Without -a, the result would be the default background and a blue foreground.

set-window-option (alias setw) is used to configure window options (allow-rename, mode-keys, synchronize-panes, etc.) and the same flag options are available.

See:

3
  • 8
    Hm, the tmux 3.0a man page doesn't explain setw nor set-window-option. Also, set-option has a -w for window options, as well. Commented Aug 30, 2020 at 7:18
  • @maxschlepzig - ever figured out what happened? Are they deprecating set-window-option? I still don't see an entry for set-window-option on tmux manual.
    – rgin
    Commented Jul 4, 2023 at 7:52
  • 4
    @rgin Yes, a 2008 entry in the tmux CHANGES files documents setw as an alias to set-window-option, a 2010 entry documents set-window-option as a new alias to set-option -w and the tmux 3.0 entry announces the de-documentation of set-window-option. Commented Jul 4, 2023 at 21:03

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.