# Key Bindings

## Keyboard shortcuts¶

### Local¶

These shortcuts are available in GUI mode:

Keys Description
, , , Move selection 1px
Shift + , , , Resize selection 1px
Esc Quit capture
Ctrl + C Copy to clipboard
Ctrl + S Save selection as a file
Ctrl + Z Undo the last modification
Right Click Show color picker
Mouse Wheel Change the tool's thickness

Shift + drag a handler of the selection area: mirror redimension in the opposite handler.

### Global¶

If you want use Flameshot as a default screenshot utility, chances are you want to launch it using the Prt Sc key. Flameshot doesn't yet offer a fully-automated option to do so, but you can configure your system to do so.

#### On KDE Plasma desktop¶

To make configuration easier, there's a file in the repository that more or less automates this process. This file will assign the following keys to the following actions by default:

Keys Description
Prt Sc Start the Flameshot screenshot tool and take a screenshot
Ctrl + Prt Sc Wait for 3 seconds, then start the Flameshot screenshot tool and take a screenshot
Shift + Prt Sc Take a full-screen (all monitors) screenshot and save it
Ctrl + Shift + Prt Sc Take a full-screen (all monitors) screenshot and copy it to the clipboard

If you don't like the defaults, you can change them manually later.

Steps for using the configuration:

1. The configuration file configures shortcuts so that Flameshot automatically saves (without opening the save dialog) screenshots to ~/Pictures/Screenshots folder. Make sure you have that folder by running the following command:

mkdir -p ~/Pictures/Screenshots

(If you don't like the default location, you can skip this step and configure your preferred directory later.)

cd ~/Desktop; wget https://raw.githubusercontent.com/flameshot-org/flameshot/master/docs/shortcuts-config/flameshot-shortcuts-kde


3. Go to System SettingsShortcutsCustom Shortcuts.
4. If there's one, you'll need to disable an entry for Spectacle, the default KDE screenshot utility first because its shortcuts might collide with Flameshot's ones; so, just uncheck the Spectacle entry.
5. Click EditImport..., navigate to the Desktop folder (or wherever you saved the configuration file) and open the configuration file.
6. Now the Flameshot entry should appear in the list. Click Apply to apply the changes.
7. If you want to change the defaults, you can expand the entry, select the appropriate action and modify it as you wish; the process is pretty mush self-explanatory.

#### On Ubuntu and other Gnome based distros¶

You can easily configure your 'print' keyboard shortcut to be assigned to Flameshot. Below an example to open Flameshot in GUI mode:

1. Open SettingsDevicesKeyboardShortcuts.

2. Search for 'print', and unbind the screen capture function by selecting it, and clicking backspace.

3. Scroll down and click on the '+'.

4. On 'Name', name it 'Flameshot' or 'PrintScreen'.

5. Define the command as 'flameshot gui'.

6. Select 'Define shortcut...'and click your keyboard Prt Sc key.

Now you can use your default keyboard key to launch Flameshot.

For defining multiple shortcuts you can repeat the process above, and just change the command.

Some examples of commands are:

# Capture a region using the GUI, and have it automatically saved to your pictures folder when clicking the save button in GUI
flameshot gui -p /home/user/Pictures
# Capture the active monitor and save it automatically to your pictures folder
flameshot screen -p /home/user/Pictures
# Capture the full desktop (all monitors) and save it automatically to your pictures folder
flameshot full -p /home/user/Pictures