Install on Linux

How to install Flameshot on Linux systems.

🔗 Installation on Linux

🔗 Distro-Specific

There are packages available for different distros:

If you want to run Flameshot with the most cutting edge features, you can download a development version from here or use AUR if you are on an Arch-based distro.

Important things to Know:

  1. Other than AUR (Arch User Repository) that is officially maintained by Flameshot developers, all packages listed above are maintained by the respective Linux distribution. Therefore, if the version is very old or you have problems installing Flameshot from the commands above, please directly contact the distribution.
  2. In rolling-release distros (e.g Arch, Solus), you can expect to get the recent version of Flameshot within the first few days of release, but in nonrolling-release distros (e.g Ubuntu, Debian, Fedora) you will most probably stay a few versions behind, especially if your Linux release version is old (check here). In these cases you might want to either go for the packages we provide on Flameshot release page or go with distro-agnostic solutions which are explained here.

In addition, we also have continuous integration, it currently provides the following packages which can be accessed via our Github release page:

  • Debian10 (buster)
  • Ubuntu18.04 (bionic)
  • Ubuntu20.04 (focal)
  • Fedora31
  • Fedora32
  • OpenSUSE Leap 15.2

General packages (AppImage, snap, and Flatpak): they can run on common Linux-based operating systems, such as RHEL, CentOS, openSUSE, SLED, Ubuntu, Fedora, Debian and derivatives.

Expand this section to see what distros are using an up to date version of Flameshot Packaging status

🔗 Distro-Agnostic

🔗 AppImage

You can always use the AppImage as it is distro agnostic:

  1. Navigate to the folder you would like to store the software (the following is a suggestion):
mkdir --parents ~/Applications/Flameshot
cd ~/Applications/Flameshot
  1. Delete older versions of Flameshot AppImage:
rm Flameshot-*x86_64.AppImage
  1. Download the latest AppImage

    3.1. Get it from Release page, OR

    3.2. Use the following to automatically download the latest.

    curl --remote-name \
        --remote-header-name \
        --location $(curl -s https://api.github.com/repos/flameshot-org/flameshot/releases/latest \
                    | grep -Po 'https://github.com/flameshot-org/flameshot/releases/download/[^}]*\.AppImage' \
                    | uniq)
    
  2. Set it to executable:

chmod +x Flameshot-*.x86_64.AppImage
  1. Now you have the Flameshot ready and you can run the software:
./Flameshot-*.x86_64.AppImage

This will create an icon in your system tray area (usually in the bottom-right or top-right of the screen).

  1. Now, you can launch the application. You can either:

    6.1. Click on the tray icon and select "Take screenshot"

    6.2. Open terminal and use the following to run the application:

    ./Flameshot-*.x86_64.AppImage gui
    
  2. You may also add a symlink to the AppImage executable in your PATH. This way you can just run flameshot in your terminal and it will automatically run the AppImage. For example:

ln --symbolic ~/Applications/Flameshot/Flameshot-11.0.0.x86_64.AppImage ~/.local/bin/flameshot

# and now you can simply run
flameshot

🔗 Snap

Flameshot is not currently on snap, but when it gets available, you can install Flameshot through:

snap install flameshot

To update the snap applications on your computer, you should run snap refresh.

🔗 Flatpak

Flameshot is not currently on Flathub, but it will be there soon and the information here will be updated accordingly. For now you can install the Flatpak from the github release:

flatpak install flathub org.flameshot.Flameshot

Alternatively you can install from the github using Flatpak if you want a specific version. For example for getting the version 0.9.0:

flatpak install https://github.com/flameshot-org/flameshot/releases/download/v0.9.0/org.flameshot.Flameshot-0.9.0.x86_64.flatpak

And for running it you should do

flatpak run org.flameshot.Flameshot

To update the flatpaks you can use flatpak update.

You may also add a symlink to the Flatpak command in your PATH. For example:

ln --symbolic /var/lib/flatpak/exports/bin/org.flameshot.Flameshot ~/.local/bin/flameshot

This can help when creating custom keyboard shortcuts.

🔗 Docker

There is also a docker image available for those who want it (not maintained by Flameshot maintainers):

https://github.com/ManuelLR/docker-flameshot


🔗 Runtime Dependencies

🔗 Debian

libqt5dbus5, libqt5network5, libqt5core5a, libqt5widgets5, libqt5gui5

Optional:

openssl, ca-certificates

🔗 Fedora

qt5-qtbase

Optional:

openssl, ca-certificates

🔗 Arch

qt5-base

Optional:

openssl, ca-certificates