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).

Selection Mode
has a selection by keyboard mode. In this mode it is possible to move around the scrollback and select text without the mouse.
Enter and leave this mode by using the keyboard shortcut (D by default).
Moving the cursor: Arrows, PageUp, PageDown, Home, End.
Moving the cursor vi style: h,j,k,l, to move one character, Ctrl+b,f,u,d for page up/down or half page up/down.
Select text by using Ctrl or Shift with arrows, or by using V to start selection, moving the cursor and then V again to end selection. V selects whole lines, instead of characters.

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...
Switch to the Profiles page.
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.

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.

Semantic Shell Integration
A shell program running in Konsole may emit escape sequences that partition the text displayed into three types: shell prompt, user input and command output. Using this semantic information enables various enhancements in Konsole.
PgUp and PgDown scroll up/down to previous/next command prompt.
Visual hints:
A line is displayed above each prompt, prompt colors are less intense, and output colors are more intense.
A red bar is displayed to the left of input and output lines of commands that resulted in error
A red background for input and output lines of commands that resulted in error
A gray bar is displayed to the left of the input and output lines of every other command.
A gray background for the input and output lines of every other command.
Each of those may be configured to never show, always show, or only when URL hints are shown. The configuration is in the Semantic Integration tab of the General page of the profile configuration window.
Context menu options Copy user input Copy command output Copy except prompt may be used to filter selection when it is copied to the clipboard.
When selection is empty, copy to clipboard action copies the current input line if it is not empty, or the last output if there is no current input.
Pressing Up/Down arrow when editing a long input, will instead place the cursor one line up/down by sending the appropriate number of Left/Right key events to the shell. Configurable in the profile settings.
Clicking the mouse on text input will place the cursor in the clicked location. Configurable in the profile settings.
Semantic shell integration needs to be setup in the shell. Pressing ] will paste the necessary commands needed in bash. For other shells, such as fish, zsh, python, etc. consult the relevant program's documentation.

Complex Text Layout
In the Complex Text Layout page of the Edit Profile dialog, you will find options that control the rendering of text.
Word mode - in this mode (some) strings are displayed in the screen as a whole, instead of a character at a time. This allows Qt to render text correctly when the shape of a character depends on the characters before or after it. This might result in incorrect position of some characters.
Spaces always break strings, so they are always in the correct positions. This ensures that characters are never too far from their correct position.
Use the same attributes for each whole word - When this is enabled, words are rendered with the same attributes (text color, bold, italic, etc.). If an attribute changes mid-word, it will only take effect after the end of the word. When this is disabled, a new word starts when attributes change. This results in characters changing shape and position when moving the cursor or selecting text.
ASCII characters - Group ASCII characters into words as described above. The most noticeable effect of this option is that enabling this shows programming ligatures (for fonts that support them). E.g. the string <= may be displayed as ⩽.
Brahmic scripts characters - Group Brahmic characters as described above. Without this option (depending on the font) some words may not be connected as they should. With this enabled Brahmic characters may appear out of position. E.g. the third character in the second line might not appear directly under the third character in the first line.
Emoji Font: - This allows specifying the font to use for Unicode Emoji characters. If not set, the default profile font will be used, or some fallback font may be used by the system if the glyphs are missing from this font.
Bi-Directional text rendering - Reorder right to left characters so Arabic and Hebrew texts appear correctly.
force LTR line direction - Lines are always Left to right. Without this, each line's direction is determined by the first character with strong directionality.
Table characters BiDi mode override - Consider graphic table characters as strong LTR characters. This allows table containing RTL characters to display correctly, but might cause incorrect order if those characters are used in RTL texts.