I know how to scroll in tmux using the keyboard, but I noticed that it looks like there's a way to use the terminal scrollbar with GNU Screen. Can this be done with tmux?

  • 7
    You can't really use the terminal scrollbar with GNU Screen. The scrollbar won't actually access Screen's scrollback buffer, but the terminal's, which means that scrolled-off lines from different Screen sessions get mixed up.
    – ak2
    Jul 14 '11 at 11:18
  • 3
    iTerm2 has some future plans to [integrate with tmux ](code.google.com/p/iterm2/wiki/TmuxIntegration). Such integration seems likely to include using a native scroll bar to view the tmux history buffer. Jul 25 '11 at 5:16

This is possible in both GNU screen and in tmux and the workaround is similar: to fool the multiplexers into thinking that the terminal has no "alternate screen" mode (such as that used by pico, mutt, etc). This is accomplished by setting termcap commands for the session.

For GNU screen, put this in your .screenrc:

termcapinfo xterm*|xs|rxvt|terminal ti@:te@

and for tmux, add this to your .tmux.conf:

set -ga terminal-overrides ',xterm*:smcup@:rmcup@'

The 'xterm*' part of the command should be set to whatever your terminal-emulator is declared as. Some form of xterm is a good guess, but you can check yours on most sane *nix systems with:

echo $TERM

and this can usually be set in the preferences of your terminal program (ie: For Apple's Terminal.app, it's in Settings->Profile->Advanced (or Settings->Advanced->Emulation pre-yosemite) "Declare terminal as".

The end result is that the overflow ends up in the terminal's scrollback buffer instead of disappearing. Of course, since this is one static buffer, things will get messy as you switch between screen or tmux windows, but this is handy for quickly flicking up to see the output of an ls command or the such.

  • 3
    also, just saw superuser.com/questions/253414/… , which works as described as another alternative.
    – Doug J
    Jul 25 '11 at 2:55
  • 2
    Solution: gist.github.com/1297707
    – Nick
    Apr 17 '12 at 15:24
  • 1
    @Nick - Note that you're solving a different problem : adding mouse support to tmux. Might be a better solution for you, but it's different from using the native scrollback buffer. As long as your terminal emulator is properly defined the above will work on an y*nix, including OSX
    – Doug J
    Apr 17 '12 at 17:40
  • 1
    looks like that was a tcsh built-in. On bash you can use echo $TERM
    – Doug J
    Aug 8 '13 at 20:56
  • 2
    this "overflow" works but shows up some odd unicode characters upon exiting tmux: stackoverflow.com/q/31790939/2668831 Aug 3 '15 at 15:18

To enable scrolling, you can enable the built-in mouse mode in your ~/.tmux.conf as follow:

set -g mode-mouse on

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

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