Installation

Installation

Requirements

• Python 3.10 or newer
• PySide6 (Qt6)
• PyGObject
• dbus-python
• Pillow, requests

You'll also need screenshot tools for your display server (see below).

Automated Install

The setup script handles everything. It detects your distro and display server, installs dependencies, and sets up LinuxShot.

git clone https://github.com/TaintedAngel/linuxshot.git
cd linuxshot
chmod +x setup.sh
./setup.sh

After that, run linuxshot setup to register keyboard shortcuts (KDE Plasma).

Manual Install

Arch / CachyOS / EndeavourOS / Manjaro

sudo pacman -S python python-pip python-gobject python-pillow python-requests \
    python-pyside6 python-dbus libnotify spectacle wl-clipboard
pip install --break-system-packages .

Debian / Ubuntu / Pop!_OS / Mint

sudo apt install python3 python3-pip python3-gi python3-pil python3-requests \
    libnotify-bin grim slurp wl-clipboard
pip install .

PySide6 and dbus-python get pulled in through pip automatically.

Fedora / Nobara

sudo dnf install python3 python3-pip python3-gobject python3-pillow python3-requests \
    libnotify grim slurp wl-clipboard
pip install .

X11 Users

If you're on X11 instead of Wayland, install these instead of grim/slurp/wl-clipboard:

# Arch
sudo pacman -S maim xdotool xclip

# Debian/Ubuntu
sudo apt install maim xdotool xclip

# Fedora
sudo dnf install maim xdotool xclip

AUR (Arch)

A PKGBUILD is included in the aur/ directory. If it's published:

yay -S linuxshot-git

Post-Install

linuxshot setup    # register shortcuts, desktop file, autostart
linuxshot tray     # start the tray icon

Run linuxshot check to verify all dependencies are working.

Updating

linuxshot update

This pulls the latest version from GitHub and reinstalls.

Uninstalling

pip uninstall linuxshot
rm ~/.local/share/applications/linuxshot.desktop
rm ~/.config/autostart/linuxshot.desktop