Tell me more ×
Super User is a question and answer site for computer enthusiasts and power users. It's 100% free, no registration required.
up vote 134 down vote favorite
55

I just started using tmux, and I really like it, but I need to be able to scroll within the buffers/panes/windows I have open. I don't care if it works with the mouse or not. When I search the tmux man page, I find only two instances of the word "scroll" even showing up, and both have to do with copy mode. Is there a way to scroll without all the overhead of entering copy mode?

share|improve this question
2  
What overhead are you concerned with? copy-mode is the way to view history (and optionally copy stuff out of it). – Chris Johnsen Nov 11 '10 at 5:48

3 Answers

up vote 141 down vote accepted

Ctrl-b then [ then you can use your normal navigation keys to scroll around (eg. Up Arrow or PgDn). Press q to quit scroll mode.

Alternatively you can press Ctrl-b PgUp to go directly into copy mode and scroll one page up (which is what it sounds like you will want most of the time)

You can also scroll up/down line by line using Shift-k and Shift-j (if you're already in scroll mode).

share|improve this answer
7  
I think C-b = is choose-buffer by default. Did you mean C-b [ (which is copy-mode by default)? Also you can also use C-b PageUp to start copy-mode directly on the previous page (very handy when you know what you want to view/copy has already scrolled off the current page). – Chris Johnsen Nov 11 '10 at 5:55
1  
Ahh, that explains it. I think I started with 1.1 which was already after scroll-mode had been subsumed. The OP says ‘only two instances of the word "scroll" [in the man page]’, so the version is probably one without scroll-mode. – Chris Johnsen Nov 11 '10 at 12:22
2  
Correct, my tmux has no scroll-mode. You need to C-b [ to enter copy mode and then use either the emacs or vi key-bindings to scroll around. This seems like a lot of steps just to scroll, but the benefits of tmux still outweigh these annoyances. I'm on a macbook and there is no PageUp key :-\. (Also, how do I make keys with markdown like you did, Dennis?) – chadoh Nov 11 '10 at 17:11
7  
@chadoh: Try these on your Macbook: Home: fn-LeftArrow; End: fn-RightArrow; Page Up: fn-UpArrow; Page Down: fn-DownArrow. To make keycaps: <kbd>Ctrl</kbd> – Dennis Williamson Nov 11 '10 at 18:43
1  
on macbook, the fn+up goes straight to terminal app and never hits tmux – Tyler Apr 11 '11 at 17:57
show 2 more comments
up vote 27 down vote

From my .tmux.conf:

# Sane scrolling
set -g terminal-overrides 'xterm*:smcup@:rmcup@'

This enables native xterm scrolling.

share|improve this answer
7  
Can you explain what this does exactly? – Ivo Oct 31 '11 at 6:25
1  
I don't know what it does, but it is pure genius. Finally, tmux scrolling works, yay! – oneself Nov 28 '11 at 21:26
Maybe this helps to explain it? blogs.oracle.com/samf/entry/smcup_rmcup_hate – Denilson Sá Dec 26 '11 at 14:41
2  
This doesn't work for me on OS X... – Nick Apr 17 '12 at 13:56
6  
Solution: gist.github.com/1297707 – Nick Apr 17 '12 at 15:25
show 2 more comments
up vote 10 down vote

Well, you should consider the proper way to set scrolling: add in your tmux.conf

set -g mode-mouse on

It worked for me in windows and panes. Now tmux is just perfect.

Practical tmux has more info on tmux.conf files.

share|improve this answer

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

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