Flameshot
Powerful screenshot software
Quick Take: Flameshot
Flameshot is the best free screenshot annotation tool if you need cross-platform consistency. The in-place annotation workflow is fast and effective: capture, draw arrows, blur sensitive data, save. The CLI enables scripted captures. It's completely free with no restrictions. The downsides are all about being a Linux-first tool on macOS: the UI isn't native, there's no screen recording or scrolling capture, and macOS-specific polish is lacking. On macOS specifically, Shottr (also free) is a better native option, and CleanShot X ($29) is in a different league. Flameshot's sweet spot is developers who use Linux and Mac and want the same screenshot tool on both.
Best For
- •Developers who use both Linux and macOS and want a consistent screenshot tool
- •Users who need free screenshot annotation without any paid tools
- •QA engineers who need CLI-driven automated screenshot capture
- •Anyone who needs quick blur/pixelate for sensitive data in screenshots
What is Flameshot?
Flameshot is a free, open-source screenshot tool with a built-in annotation editor. It started as a Linux application and was ported to macOS and Windows. You take a screenshot, annotate it with arrows, text, blur, and shapes right on the capture, and save or copy it — all in one flow. Flameshot is not the prettiest tool on macOS. It doesn't look or feel like a native Mac app. The UI has the functional-but-utilitarian aesthetic of a Linux GTK application. But it works, it's completely free, and the annotation tools are faster to use than most alternatives. The capture workflow: press your configured shortcut, select an area, and the annotation toolbar appears immediately on the captured image. Draw arrows, add text, blur sensitive areas, draw rectangles and circles, add numbered markers, highlight regions. When you're done, save to disk, copy to clipboard, or upload to an image host. The whole process — capture to annotated result — takes 10-15 seconds. Flameshot also has a CLI (`flameshot gui`, `flameshot full`, `flameshot screen`). This makes it scriptable: trigger captures from shell scripts, cron jobs, or keyboard shortcuts configured through your terminal. The CLI is how many Linux power users integrate Flameshot into their workflow, and it works the same on macOS. The main limitation: no screen recording. Flameshot captures static images only. If you need video or GIF recording, you need a separate tool. There's also no cloud hosting, scrolling capture, or OCR — features that CleanShot X provides. Flameshot does one thing (screenshot with annotation) and does it well, for free. The honest take: on macOS, CleanShot X ($29) is the better screenshot tool by a wide margin — more features, better UI, cloud hosting, screen recording. But CleanShot costs money. If you want a free screenshot tool that goes beyond the basic macOS Cmd+Shift+4 with real annotation capability, Flameshot is the best free option. It's especially useful for Linux users who've switched to Mac and want the same tool they know.
Install with Homebrew
brew install --cask flameshotDeep Dive: Flameshot's Cross-Platform Screenshot Philosophy
How a Linux screenshot tool found its way onto macOS and Windows.
History & Background
Flameshot was created by Lupire Iacob as a Linux screenshot tool, inspired by the annotation workflows of proprietary Windows tools like Greenshot and ShareX. The goal was to provide Linux users with fast, in-place annotation that didn't exist in the default Linux screenshot tools. Built with Qt for cross-platform compatibility, it was later ported to macOS and Windows. The macOS port works but retains its Linux aesthetic — Qt widgets don't match macOS's native Cocoa controls.
How It Works
Flameshot is built with C++ and Qt, the same framework used by tools like VLC and OBS. Qt provides cross-platform UI rendering, which is why Flameshot looks and feels the same on all platforms. The capture engine uses platform-specific screen capture APIs (CGWindowListCreateImage on macOS). The annotation editor renders drawings directly on the captured image bitmap. The CLI interface is a separate process that communicates with the GUI via D-Bus (Linux) or platform-specific IPC.
Ecosystem & Integrations
Flameshot is a standalone tool without a plugin system. It integrates with system-level tools: Imgur API for uploads, macOS system tray for quick access, and the CLI for script integration. The configuration file (~/.config/flameshot/flameshot.ini) can be version-controlled in dotfiles for consistent setup across machines.
Future Development
Flameshot development focuses on stability, platform-specific bug fixes, and annotation feature additions. The macOS version receives less development attention than Linux. Community contributions are welcome but the macOS-specific contributor base is small.
Key Features
In-Place Annotation Editor
The annotation toolbar appears directly on your capture. No separate editor, no export-then-open-in-preview workflow. Draw arrows pointing to the important element. Add text labels. Blur passwords or personal data. Draw rectangles to highlight areas. Add numbered markers (1, 2, 3) for step-by-step instructions. Highlight text with a semi-transparent marker. Freehand draw for quick circles or underlines. All tools have adjustable color and thickness. The annotation happens on the raw capture before saving — one workflow, not two.
Blur and Pixelate
Drag over any area to blur or pixelate it. This is critical for screenshots that contain sensitive data: API keys, email addresses, personal names, account numbers. The blur is irreversible in the saved image — the original data can't be recovered. For anyone sharing screenshots in bug reports, documentation, or Slack messages, blur is a daily-use feature.
CLI Integration
Flameshot provides CLI commands: `flameshot gui` opens the interactive capture, `flameshot full` captures the entire screen, `flameshot screen` captures a specific monitor. CLI options include save path, delay, and region. This enables scripted screenshots — capture a specific region of the screen every 5 minutes for monitoring, or integrate into a custom keyboard shortcut system. On macOS, you can bind these to Karabiner-Elements shortcuts or Automator workflows.
Upload to Image Hosts
After capturing, Flameshot can upload directly to Imgur (built-in) or custom image hosts via API configuration. The upload returns a URL for sharing. This is basic compared to CleanShot Cloud's dedicated hosting, but it works for quick sharing without setting up your own image hosting.
Customizable Appearance and Shortcuts
Configure the annotation toolbar: which tools appear, their default colors, and keyboard shortcuts. You can customize the UI opacity, button size, and color picker. The configuration lives in a config file that can be version-controlled in your dotfiles. On macOS, Flameshot integrates with the system tray (menu bar) for quick access.
Cross-Platform Consistency
Flameshot works on Linux, macOS, and Windows with the same interface and feature set. If you use multiple operating systems or work on a team with mixed platforms, everyone can use the same screenshot tool. The muscle memory, keyboard shortcuts, and annotation workflow transfer between platforms.
Who Should Use Flameshot?
1The Linux-to-Mac Developer
A developer who used Flameshot on Linux switched to macOS for work. Instead of learning a new tool, they install Flameshot via Homebrew and continue using the same workflow: capture area, annotate with arrows and blur, copy to clipboard, paste into the issue tracker. Same shortcuts, same interface, zero learning curve on the new platform.
2The Budget-Conscious Documentarian
A freelancer who writes technical documentation needs screenshots with annotations but can't justify $29 for CleanShot X. Flameshot provides arrows, text, numbered steps, and blur for free. The output quality is professional — annotated screenshots in documentation look the same regardless of which tool created them.
3The Script-Driven QA Engineer
A QA engineer uses Flameshot's CLI to capture screenshots during automated test runs. A shell script runs `flameshot full --path /screenshots/test_$(date +%s).png` after each test step, creating a visual log of the test execution. When a test fails, the screenshot shows exactly what was on screen at the failure point.
How to Install Flameshot on Mac
Flameshot installs via Homebrew on macOS.
Install via Homebrew
Run: brew install --cask flameshot. This installs the Flameshot application.
Grant Permissions
On first launch, grant Screen Recording permission in System Settings > Privacy & Security > Screen Recording. Without this, Flameshot can't capture your screen.
Configure Shortcuts
Open Flameshot from the menu bar > Configuration. Set your preferred keyboard shortcut for capture. The default varies by platform — configure it to match your workflow (many people use Ctrl+Shift+P or a similar combination).
Pro Tips
- • Flameshot sits in the menu bar. Click the icon to access configuration and quick capture.
- • The CLI commands (flameshot gui, flameshot full) work from Terminal for scripted captures.
- • Customize the annotation toolbar to show only the tools you use. Fewer buttons = faster workflow.
- • Set a default save directory in Configuration to avoid the save dialog every time.
Configuration Tips
Set Default Annotation Colors
In Configuration > General, set your preferred default color for annotations (red is standard for documentation, blue for less aggressive marking). Set the default line thickness. These defaults apply every time you capture, reducing the clicks needed per screenshot.
Minimize the Toolbar
Disable annotation tools you don't use. If you only need arrows, text, and blur, disable circles, squares, markers, and pencil. A smaller toolbar is faster to navigate. You can always re-enable tools later.
Set Up Imgur Upload
In Configuration > General, enable the Imgur upload button. After capture, one click uploads to Imgur and copies the URL. This is the fastest free way to share annotated screenshots via a link.
Alternatives to Flameshot
Flameshot's competition on macOS ranges from free built-in tools to premium screenshot apps.
CleanShot X
CleanShot X ($29) is the premium macOS screenshot tool: scrolling capture, OCR, screen recording, cloud hosting, and polished annotation. It's better in every way except price. If you can afford $29 and screenshots are a daily tool, CleanShot X is worth it. If you need a free tool with good annotations, Flameshot is the answer.
Shottr
Shottr is a free macOS screenshot tool with annotation, scrolling capture, OCR, pixel measurement, and color picking. It's Mac-native and more polished than Flameshot. If you're on macOS and want a free tool, Shottr is arguably better than Flameshot because it's designed for Mac. Flameshot's advantage is cross-platform consistency — same tool on Linux, Mac, and Windows.
macOS Built-in (Cmd+Shift+3/4/5)
The built-in macOS screenshot captures screens and selected areas. It saves to Desktop with no annotation. You'd need to open the screenshot in Preview to add arrows or text — a clunky multi-step process. Flameshot collapses capture and annotation into one step, which is a significant workflow improvement even over the built-in option.
Pricing
Flameshot is completely free and open-source, licensed under GPL v3. No paid tiers, no subscription, no feature restrictions. All annotation tools, CLI features, and upload capabilities are included.
Pros
- ✓Completely free and open-source
- ✓In-place annotation is fast — capture and annotate in one step
- ✓Blur/pixelate for sensitive data in screenshots
- ✓CLI for scripted and automated captures
- ✓Cross-platform (Linux, macOS, Windows) with consistent interface
- ✓Customizable toolbar and keyboard shortcuts
- ✓Numbered markers for step-by-step instructions
Cons
- ✗Non-native UI on macOS — looks and feels like a Linux port
- ✗No screen recording (video or GIF)
- ✗No scrolling capture
- ✗No OCR text recognition
- ✗No cloud hosting (only Imgur upload)
- ✗Occasional macOS permission issues with screen capture
- ✗Less polished than CleanShot X or Shottr
Community & Ecosystem
Flameshot is developed on GitHub (flameshot-org/flameshot) with community contributions. The project is more active on Linux than macOS — most issues and discussions focus on Linux desktop environments. macOS-specific issues are addressed but with lower priority. The community is small but responsive. Documentation is available on the Flameshot wiki. Reddit and Stack Overflow have answers for common configuration questions.
Frequently Asked Questions about Flameshot
Our Verdict
Flameshot is the best free screenshot annotation tool if you need cross-platform consistency. The in-place annotation workflow is fast and effective: capture, draw arrows, blur sensitive data, save. The CLI enables scripted captures. It's completely free with no restrictions. The downsides are all about being a Linux-first tool on macOS: the UI isn't native, there's no screen recording or scrolling capture, and macOS-specific polish is lacking. On macOS specifically, Shottr (also free) is a better native option, and CleanShot X ($29) is in a different league. Flameshot's sweet spot is developers who use Linux and Mac and want the same screenshot tool on both.
About the Author
Productivity & Workflow Analyst
Related Technologies & Concepts
Related Topics
Screenshot & Annotation Tools
Applications for capturing and annotating screen content.
Sources & References
Fact-CheckedLast verified: Feb 23, 2026
Key Verified Facts
- Flameshot is free, open-source, and licensed under GPL v3.[fact1]
- 1Flameshot - Powerful yet simple to use screenshot software
Accessed May 6, 2026
- 2Flameshot GitHub Repository
Accessed May 6, 2026
Research queries: Flameshot macOS 2026 screenshot tool review