The Handbook
is 's terminal emulator.

Introduction

What is a terminal?
is an X terminal emulator, often referred to as a terminal or a shell. It emulates a command line interface in a text only window.
typically runs a command shell, an application that executes commands that you type. The shell the runs depends on your account settings. Consult your operating system documentation to know what the shell is, how to configure it and how to use it.

Scrollback
uses the notion of scrollback to allow users to view previously displayed output. By default, scrollback is on and set to save 1000 lines of output in addition to what is currently displayed on the screen.
As lines of text scroll off the top of the screen, they can be reviewed by moving the scroll bar upwards, scrolling with a mouse wheel or through the use of the Page Up (to move back), Page Down (to move forward), Up Arrow (to move up a line) and Down Arrow (to move down a line) keys.
The amount of scrolling using Page Up/Down can be switched between half and full page in the Scrolling tab of the profile configuration window (use Settings Edit Current Profile... to open this window).

Profiles
Profiles allow the user to quickly and easily automate the running of common commands. Examples could include:
ssh into another machine
starting an irc session
use tail to watch a file
All new and changed profiles are saved in the user's local home folder in $XDG_DATA_HOME/konsole.
Procedure to create a new profile:
Click on the menu entry Settings Manage Profiles...
Click on the button New Profile....
Fill in the first entry with a name. This is the name that will show in the menu, and will be the default label instead of Shell when you start a session of this type.
Enter a command just as you normally would if you opened a new shell and were going to issue that command. For our first example above, you might type ssh administration.
On the other tabs of the dialog, configure this session's appearance. You can configure a different font, color scheme, $TERM type and many other settings for each session.
Press the OK button. The new session is now available in the Manage Profiles... dialog.
Any profiles which have Show in Menu checked will be listed by their name in the File New Tab menu. There will be no submenu if only the default profile is to be shown.

Mouse Buttons
This section details the use of the mouse buttons for the common right handed mouse button order. For the left handed mouse button order, swap left and right in the text below.
Left 	 All clicks will be sent to a mouse-aware application running in . If an application will react on mouse clicks, indicates this by showing an arrow cursor. If not, an I-beam (bar) cursor is shown.
Holding the down and dragging the mouse over the screen with a mouse-unaware application running will mark a region of the text. While dragging the mouse, the marked text is displayed in reversed color for visual feedback. Select Copy from the Edit menu to copy the marked text to the clipboard for further use within or another application. The selected text can also be dragged and dropped into compatible applications. Hold the key and drag the selected text to the desired location.
Normally, new-line characters are inserted at the end of each line selected. This is best for cut and paste of source code, or the output of a particular command. For ordinary text, the line breaks are often not important. One might prefer, however, for the text to be a stream of characters that will be automatically re-formatted when pasted into another application. To select in text-stream mode, hold down the key while selecting normally.
Pressing the and keys along with the will select text in columns.
Double-click with the to select a word; triple-click to select an entire line.
If the upper or lower edge of the text area is touched while marking, scrolls up or down, eventually exposing text within the history buffer. The scrolling stops when the mouse stops moving.
After the mouse is released, attempts to keep the text in the clipboard visible by holding the marked area reversed. The marked area reverts back to normal as soon as the contents of the clipboard change, the text within the marked area is altered or the is clicked.
To mark text in a mouse-aware application (Midnight Commander, for example) the key has to be pressed when clicking.
Middle 	Pressing the pastes text currently in the clipboard. Holding down the key as you press the pastes the text and appends a new-line. That is convenient for executing pasted command quickly, but it can be dangerous so use it with caution.
If you have a mouse with only two buttons, pressing both the and together emulates the of a three button mouse.
If you have a wheel as the middle button, rolling it in a mouse-unaware program will move 's scrollbar.
Right 	 These items appear in the menu when the is pressed:
Copy
Paste
With a text selection a submenu Search for with a list of the preferred Web Shortcuts and an option to configure web shortcuts.
Open File Manager
Set Encoding
Clear Scrollback
Adjust Scrollback...
Show Menu Bar, only when the menubar is hidden
Switch Profile
Edit Current Profile...
Close Tab
In a mouse aware application, press the key along with the to get the popup menu.

Drag and Drop
If you drop a file, folder or on a window, a context menu appears with these actions:
Drag and Drop Context Menu
Drag and Drop Context Menu
Move Here 	 Move the dropped item into the current folder. This item only appears in the context menu, if you have the rights to delete the dropped file or folder.
Copy Here 	 Copy the dropped item into the current folder.
Link Here 	 Insert a symbolic link to the dropped item.
Paste Location 	 Insert the full file path of the dropped item at the cursor.
Change Directory To 	 If a folder is dropped, this action appears in the context menu and allows you to change the working folder of the session.
Cancel 	 Break the drag and drop action.
If you press the shortcuts before releasing the during drag and drop, no context menu appears and the actions will be executed immediately.
If you want to use the key for drag and drop or disable the context menu to insert s as text by default, enable the corresponding options on the Mouse tab in the profile settings dialog.