Site Tools


This is an old revision of the document!


FAQ

How do I get screen to put things into my terminal's scrollback?

First off, it's recommended that you use screen's scrollback buffer instead. Since you can have multiple windows in a screen session, if you switch between those windows, your terminal scrollback will mix lines from all of those windows, but screen keeps separate scrollback buffers for each one. Just use C-a ESC or C-a [ to enter copy mode. But if you do want scrollback in your terminal window (usually xterm), read on.

Some background: One capability that a terminal may have is an “alternate screen”. xterm has it, and you may have seen its effects–a program will request the alternate screen, the terminal switches there, and when the program exits the terminal goes back to the normal screen, leaving all the text there intact. It is recommended that all full-screen apps use this, so as to minimize their impact on any purely command-line stuff. It makes sense, for instance, for vi to use the alternate screen. The drawback to the alternate screen is that only the main screen accumulates scrollback.

As you might have guessed, screen uses the alternate screen, if it's available. There's no real way to turn off use of the alternate screen, but you can make screen think that the terminal doesn't have an alternate screen with the termcapinfo command:

termcapinfo xterm* ti@:te@

How can screen use xterm's title bar?

in your .screenrc:

termcapinfo xterm*|rxvt*|kterm*|Eterm* 'hs:ts=\E]0;:fs=\007:ds=\E]0;\007'
defhstatus "screen ^E (^Et) | $USER@^EH"
hardstatus off

Some terminals have a “hardstatus” line–a region that is separate from the main block of text but that programs can use to show status messages. The termcap entry hs indicates that a terminal has a hardstatus line. ts gives the escape sequence for entering the hardstatus line, fs gives the escape sequence for leaving it, and ds gives the escape sequence for clearing it. The above hack treats xterm's titlebar as a hardstatus line and defines a default status string. (The status string understands the normal string escapes, but uses '^E' in place of '%'.) The hardstatus off line tells screen not to print status messages (such as “Bell in window 0” and so on) via the hardstatus line, useful since it isn't a real hardstatus line.

As mentioned in the virtual terminal, programs in screen can use the escape sequence ESC_<message>ESC\ to change the hardstatus message for a particular window. The sequence ESC]0;<message>^G also works, so with the above hardstatus hack in place, programs' changes to the xterm titlebar will be passed through screen.

How do I set my window titles automatically?

See the page on titles.

How do I set and use session names

See the page on sessionnames.

When I split the display and then detach, screen forgets the split.

(The implied question being, “How do I keep my split windows over a detach?”)

The short is answer is that you can't. The longer answer is that you can fake it.

Splits are a property of your display. The process managing your screen session doesn't really know about them; only the single process that's displaying the session does. Thus, the screen session can't remember the splits because it doesn't know about them, and once you detach, the process that did know about them has exited.

The hack is to use nested screen sessions. Start one session and give it some escape sequence that you won't use much (or just disable its escape character completely). Bind your usual detach key sequence to this screen session. Now, start or attach to your main screen session. All of your work will be done in the inner session, and you can split your display. When you detach, however, it will be the outer session that detaches, so your splits in the inner session will be preserved.

Assuming you use the default escape character, C-a, your alternate screenrc should contain:

escape ""
bindkey ^ad detach

How to send a command to a window in a running screen session from the commandline?

(We assume that we have a screen session with the name test running with a window 0.)

screen -S test -p 0 -X stuff 'top^M'

The '^M' needs to be literal so precede it with '^V' in bash, for example. Or you can use the (four characters) '\012' (which works for bash only in a script).

How do I start a new window in the background during a current session?

One can launch a program in a new window easily by simply typing the following at a commandline:

screen top 

The window will appear with the application (in this case, “top”) running. The following will open it, and switch back to your current window, in effect “launching” the command in the background:

screen -X eval 'screen top' 'other'

How do I start two programs in a detached, named session?

Example: You want to run HellaNZB and HellaHella at the same time, in one session, with useful window names. Create a custom screenrc (e.g. $HOME/.screenrc_hellanzb):

hella_ini=/mnt/usenet/nzbs/hella.ini
cat > ~/.screenrc_hellanzb <<_EOF
sessionname hellanzb
screen -t hellanzb hellanzb.py
screen -t hellahella paster serve $hella_ini
_EOF

Now you can run screen.

screen -dm -c ~/.screenrc_hellanzb

Reattaching is easy.

screen -r hellanzb

How do I have screen windows appear in my terminal as tabs?

You can patch gnome-terminal to become screen-aware, after which screen windows appear as tabs in the terminal, and you can still attach and detach from the screen.

Tutorial here: http://monia.wordpress.com/2006/08/31/integrating-gnome-terminal-and-screen/

I have a nested screen session - how do I send screen commands to the inner screen?

When your outer/local screen appears to catch your escape character, you have two options to send the escape to the inner screen:

  1. (The quick-and-dirty method) When needed, tell the “outer” screen session to send a <C-a> to the inner session, with “<C-a> a”. For example, if you want to send “<C-a> c” to the inner session, you would type “<C-a> a c” to the outer session.
  2. (The sticky method) Change the “escape” keystroke in one of the sessions, so they do not interfere. For instance, to change the inner session's meta character to, say, <C-s> (instead of <C-a>), use “<C-a> a : escape ^ss<Enter>”. Thereafter, use <C-s> for the inner screen session, instead of <C-a>.

User Tools