# flameshot-org/flameshot architecture

> Architecture diagram of the GitHub repository flameshot-org/flameshot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/flameshot-org/flameshot
- Repository: https://github.com/flameshot-org/flameshot

## Overview

Flameshot is a desktop screenshot application. Users invoke it through CLI commands, global shortcuts, the tray, or DBus; the application creates a capture request, grabs a screen region, presents an editing overlay, applies tools, then saves, copies, pins, or uploads the result. Configuration controls appearance and shortcuts. The sampled code confirms CLI parsing, request construction, filename generation, upload dispatch, and capture-widget behavior; some runtime connections are inferred only where documented by the repository structure.

Main entry points: [`src/core/flameshotdaemon.cpp`](https://github.com/flameshot-org/flameshot/blob/master/src/core/flameshotdaemon.cpp) (Flameshot Daemon), [`src/widgets/capturelauncher.cpp`](https://github.com/flameshot-org/flameshot/blob/master/src/widgets/capturelauncher.cpp) (Capture Launcher), [`src/main.cpp`](https://github.com/flameshot-org/flameshot/blob/master/src/main.cpp) (Application Main), [`src/widgets/capture/capturewidget.cpp`](https://github.com/flameshot-org/flameshot/blob/master/src/widgets/capture/capturewidget.cpp) (Capture Widget)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Control"]
  node_main["Application Main<br/>[main.cpp]"]
  node_cli_parser["CLI Parser"]
  node_daemon["Flameshot Daemon"]
  node_capture_request["Capture Request<br/>[capturerequest.cpp]"]
  node_dbus["DBus Adapter"]
  node_shortcut_filter["Shortcut Filter"]
  node_tray["Tray Icon<br/>[trayicon.cpp]"]
end

subgraph group_capture["Capture and Editing"]
  node_capture_launcher["Capture Launcher"]
  node_screen_grabber["Screen Grabber<br/>[screengrabber.cpp]"]
  node_capture_widget["Capture Widget<br/>[capturewidget.cpp]"]
  node_tool_factory["Tool Factory<br/>[toolfactory.cpp]"]
end

subgraph group_config["Configuration and Storage"]
  node_config_window["Config Window<br/>[configwindow.cpp]"]
  node_config_resolver["Config Resolver<br/>[configresolver.cpp]"]
  node_config_handler["Config Handler<br/>[confighandler.cpp]"]
  node_filename_handler["Filename Handler"]
  node_config_file[("Config File")]
end

subgraph group_integrations["Output Integrations"]
  node_save_tool["Save Tool<br/>[savetool.cpp]"]
  node_upload_tool["Upload Tool"]
  node_uploader_manager["Uploader Manager"]
  node_imgur_uploader["Imgur Uploader<br/>[imguruploader.cpp]"]
  node_screenshot_saver["Screenshot Saver"]
end

node_user(("User"))
node_desktop{{"Desktop Environment"}}
node_clipboard[("System Clipboard")]
node_imgur{{"Imgur Service"}}
node_screenshot_files[("Screenshot Files")]

node_user -->|"enters commands"| node_cli_parser
node_desktop -->|"raises shortcuts"| node_shortcut_filter
node_main -->|"parses arguments"| node_cli_parser
node_main -->|"builds request"| node_capture_request
node_main -->|"starts daemon"| node_daemon
node_daemon -->|"registers interface"| node_dbus
node_daemon -->|"manages tray"| node_tray
node_shortcut_filter -->|"dispatches shortcut"| node_daemon
node_daemon -->|"launches capture"| node_capture_launcher
node_capture_request -->|"dispatches request"| node_capture_launcher
node_capture_launcher -->|"grabs screen"| node_screen_grabber
node_capture_launcher -->|"opens overlay"| node_capture_widget
node_capture_widget -->|"creates tools"| node_tool_factory
node_tool_factory -->|"dispatches save"| node_save_tool
node_tool_factory -->|"dispatches upload"| node_upload_tool
node_save_tool -->|"resolves filename"| node_filename_handler
node_save_tool -->|"saves image"| node_screenshot_saver
node_screenshot_saver -->|"writes screenshot"| node_screenshot_files
node_upload_tool -->|"requests upload"| node_uploader_manager
node_uploader_manager -->|"selects uploader"| node_imgur_uploader
node_imgur_uploader -.->|"uploads image"| node_imgur
node_capture_widget -->|"copies image"| node_clipboard
node_config_window -->|"edits settings"| node_config_resolver
node_config_resolver -->|"resolves values"| node_config_handler
node_config_handler -->|"reads and writes"| node_config_file
node_filename_handler -->|"reads pattern"| node_config_handler

click node_main "https://github.com/flameshot-org/flameshot/blob/master/src/main.cpp"
click node_cli_parser "https://github.com/flameshot-org/flameshot/blob/master/src/cli/commandlineparser.cpp"
click node_daemon "https://github.com/flameshot-org/flameshot/blob/master/src/core/flameshotdaemon.cpp"
click node_capture_request "https://github.com/flameshot-org/flameshot/blob/master/src/core/capturerequest.cpp"
click node_dbus "https://github.com/flameshot-org/flameshot/blob/master/src/core/flameshotdbusadapter.cpp"
click node_shortcut_filter "https://github.com/flameshot-org/flameshot/blob/master/src/core/globalshortcutfilter.cpp"
click node_tray "https://github.com/flameshot-org/flameshot/blob/master/src/widgets/trayicon.cpp"
click node_capture_launcher "https://github.com/flameshot-org/flameshot/blob/master/src/widgets/capturelauncher.cpp"
click node_screen_grabber "https://github.com/flameshot-org/flameshot/blob/master/src/utils/screengrabber.cpp"
click node_capture_widget "https://github.com/flameshot-org/flameshot/blob/master/src/widgets/capture/capturewidget.cpp"
click node_tool_factory "https://github.com/flameshot-org/flameshot/blob/master/src/tools/toolfactory.cpp"
click node_save_tool "https://github.com/flameshot-org/flameshot/blob/master/src/tools/save/savetool.cpp"
click node_upload_tool "https://github.com/flameshot-org/flameshot/blob/master/src/tools/imgupload/imguploadertool.cpp"
click node_uploader_manager "https://github.com/flameshot-org/flameshot/blob/master/src/tools/imgupload/imguploadermanager.cpp"
click node_imgur_uploader "https://github.com/flameshot-org/flameshot/blob/master/src/tools/imgupload/storages/imgur/imguruploader.cpp"
click node_screenshot_saver "https://github.com/flameshot-org/flameshot/blob/master/src/utils/screenshotsaver.cpp"
click node_config_window "https://github.com/flameshot-org/flameshot/blob/master/src/config/configwindow.cpp"
click node_config_resolver "https://github.com/flameshot-org/flameshot/blob/master/src/config/configresolver.cpp"
click node_config_handler "https://github.com/flameshot-org/flameshot/blob/master/src/utils/confighandler.cpp"
click node_filename_handler "https://github.com/flameshot-org/flameshot/blob/master/src/utils/filenamehandler.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_cli_parser,node_daemon,node_capture_request,node_dbus,node_shortcut_filter,node_tray,node_user toneBlue
class node_capture_launcher,node_screen_grabber,node_capture_widget,node_tool_factory,node_clipboard,node_screenshot_files toneAmber
class node_config_window,node_config_resolver,node_config_handler,node_filename_handler,node_config_file toneMint
class node_save_tool,node_upload_tool,node_uploader_manager,node_imgur_uploader,node_screenshot_saver toneRose
class node_desktop,node_imgur toneIndigo
```

## Components

### Entry and Control

- [Application Main](https://github.com/flameshot-org/flameshot/blob/master/src/main.cpp): `src/main.cpp`
- [CLI Parser](https://github.com/flameshot-org/flameshot/blob/master/src/cli/commandlineparser.cpp): `src/cli/commandlineparser.cpp`
- [Flameshot Daemon](https://github.com/flameshot-org/flameshot/blob/master/src/core/flameshotdaemon.cpp): `src/core/flameshotdaemon.cpp`
- [Capture Request](https://github.com/flameshot-org/flameshot/blob/master/src/core/capturerequest.cpp): `src/core/capturerequest.cpp`
- [DBus Adapter](https://github.com/flameshot-org/flameshot/blob/master/src/core/flameshotdbusadapter.cpp): `src/core/flameshotdbusadapter.cpp`
- [Shortcut Filter](https://github.com/flameshot-org/flameshot/blob/master/src/core/globalshortcutfilter.cpp): `src/core/globalshortcutfilter.cpp`
- [Tray Icon](https://github.com/flameshot-org/flameshot/blob/master/src/widgets/trayicon.cpp): `src/widgets/trayicon.cpp`

### Capture and Editing

- [Capture Launcher](https://github.com/flameshot-org/flameshot/blob/master/src/widgets/capturelauncher.cpp): `src/widgets/capturelauncher.cpp`
- [Screen Grabber](https://github.com/flameshot-org/flameshot/blob/master/src/utils/screengrabber.cpp): `src/utils/screengrabber.cpp`
- [Capture Widget](https://github.com/flameshot-org/flameshot/blob/master/src/widgets/capture/capturewidget.cpp): `src/widgets/capture/capturewidget.cpp`
- [Tool Factory](https://github.com/flameshot-org/flameshot/blob/master/src/tools/toolfactory.cpp): `src/tools/toolfactory.cpp`

### Configuration and Storage

- [Config Window](https://github.com/flameshot-org/flameshot/blob/master/src/config/configwindow.cpp): `src/config/configwindow.cpp`
- [Config Resolver](https://github.com/flameshot-org/flameshot/blob/master/src/config/configresolver.cpp): `src/config/configresolver.cpp`
- [Config Handler](https://github.com/flameshot-org/flameshot/blob/master/src/utils/confighandler.cpp): `src/utils/confighandler.cpp`
- [Filename Handler](https://github.com/flameshot-org/flameshot/blob/master/src/utils/filenamehandler.cpp): `src/utils/filenamehandler.cpp`
- **Config File**

### Output Integrations

- [Save Tool](https://github.com/flameshot-org/flameshot/blob/master/src/tools/save/savetool.cpp): `src/tools/save/savetool.cpp`
- [Upload Tool](https://github.com/flameshot-org/flameshot/blob/master/src/tools/imgupload/imguploadertool.cpp): `src/tools/imgupload/imguploadertool.cpp`
- [Uploader Manager](https://github.com/flameshot-org/flameshot/blob/master/src/tools/imgupload/imguploadermanager.cpp): `src/tools/imgupload/imguploadermanager.cpp`
- [Imgur Uploader](https://github.com/flameshot-org/flameshot/blob/master/src/tools/imgupload/storages/imgur/imguruploader.cpp): `src/tools/imgupload/storages/imgur/imguruploader.cpp`
- [Screenshot Saver](https://github.com/flameshot-org/flameshot/blob/master/src/utils/screenshotsaver.cpp): `src/utils/screenshotsaver.cpp`

### Other components

- **User**
- **Desktop Environment**
- **System Clipboard**
- **Imgur Service**
- **Screenshot Files**

## Connections

- User → CLI Parser: enters commands
- Desktop Environment → Shortcut Filter: raises shortcuts
- Application Main → CLI Parser: parses arguments
- Application Main → Capture Request: builds request
- Application Main → Flameshot Daemon: starts daemon
- Flameshot Daemon → DBus Adapter: registers interface
- Flameshot Daemon → Tray Icon: manages tray
- Shortcut Filter → Flameshot Daemon: dispatches shortcut
- Flameshot Daemon → Capture Launcher: launches capture
- Capture Request → Capture Launcher: dispatches request
- Capture Launcher → Screen Grabber: grabs screen
- Capture Launcher → Capture Widget: opens overlay
- Capture Widget → Tool Factory: creates tools
- Tool Factory → Save Tool: dispatches save
- Tool Factory → Upload Tool: dispatches upload
- Save Tool → Filename Handler: resolves filename
- Save Tool → Screenshot Saver: saves image
- Screenshot Saver → Screenshot Files: writes screenshot
- Upload Tool → Uploader Manager: requests upload
- Uploader Manager → Imgur Uploader: selects uploader
- Imgur Uploader → Imgur Service: uploads image
- Capture Widget → System Clipboard: copies image
- Config Window → Config Resolver: edits settings
- Config Resolver → Config Handler: resolves values
- Config Handler → Config File: reads and writes
- Filename Handler → Config Handler: reads pattern
