explaingit

dahorg/wlameshot

Analysis updated 2026-05-18

3C++Audience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Wayland-compatible screenshot tool with annotation support (arrows, blur, text, numbered markers), inspired by Flameshot. Uses grim fallback for Hyprland and Sway. MIT licensed, built with Qt6.

Mindmap

mindmap
  root((Wlameshot))
    Capture modes
      GUI region select
      Fullscreen
      Specific screen
    Annotation tools
      Arrows and shapes
      Text labels
      Blur and redact
      Numbered markers
    Wayland support
      Qt QScreen first
      grim fallback
      wl-clipboard
    Setup
      Qt6 CMake build
      Hyprland keybind
      Waybar button
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Take annotated screenshots on a Hyprland or Sway Wayland desktop with arrows, text, and blur tools

USE CASE 2

Bind Wlameshot to Print Screen in Hyprland for a Flameshot-like workflow on Wayland

USE CASE 3

Redact sensitive areas in a screenshot using the blur tool before sharing

What is it built with?

C++Qt6CMake

How does it compare?

dahorg/wlameshotbong-water-water-bong/npu-gpu-cpufatehmtd/gradiumpp
Stars333
LanguageC++C++C++
Setup difficultymoderatehardmoderate
Complexity3/55/53/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Qt6.5+, CMake, and a C++17 compiler to build. Wayland mode also needs grim and wl-clipboard at runtime.

Use freely for personal or commercial projects, keep the copyright notice.

In plain English

Wlameshot is a screenshot tool for Linux desktops running Wayland, the modern display system replacing the older X11 system on many Linux distributions. It was inspired by Flameshot, a popular screenshot tool that works well on X11 but has limitations on Wayland. The name combines Wayland and Flameshot. After taking a screenshot, you can annotate it directly in the app before saving or copying it. The annotation tools include arrows, circles, rectangles, a freehand pen, text labels, a highlighter, numbered markers (useful for numbered step guides), and a blur tool for redacting sensitive areas. You can pick colors from preset swatches or a custom color picker, and the selection region can be resized and moved with handles. The workflow ends with either saving to a PNG file or copying the image to the clipboard. The Wayland support works through a fallback approach: the app first tries Qt's built-in screen capture, which works on X11 and some Wayland setups, and falls back to a command-line tool called grim when the compositor blocks direct screen access for security reasons. This covers the most common Wayland environments including Hyprland, Sway, and GNOME. Clipboard handling also uses a separate utility on Wayland to keep the copied image available after the app closes. Building requires Qt 6.5 or newer, CMake, and a C++17 compiler. For Wayland, two additional runtime tools (grim and wl-clipboard) must be installed. The README includes configuration examples for binding it to the Print Screen key in Hyprland and adding it as a Waybar panel button. The project is MIT licensed.

Copy-paste prompts

Prompt 1
I'm on Hyprland and want to use Wlameshot. Show me how to build it, install it, and bind it to Print Screen in my bindings.conf.
Prompt 2
How do I add a Wlameshot button to Waybar on a wlroots Wayland compositor? Show me the exact JSON for the custom module.
Prompt 3
Walk me through building Wlameshot on Arch Linux: what packages do I install for Qt6, CMake, grim, and wl-clipboard, and what is the build command?
Prompt 4
My Wlameshot screenshot is blank on Hyprland. How does the grim fallback work and how do I verify grim is installed correctly?

Frequently asked questions

What is wlameshot?

A Wayland-compatible screenshot tool with annotation support (arrows, blur, text, numbered markers), inspired by Flameshot. Uses grim fallback for Hyprland and Sway. MIT licensed, built with Qt6.

What language is wlameshot written in?

Mainly C++. The stack also includes C++, Qt6, CMake.

What license does wlameshot use?

Use freely for personal or commercial projects, keep the copyright notice.

How hard is wlameshot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is wlameshot for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub dahorg on gitmyhub

Verify against the repo before relying on details.