The best linux screenshot tool - Gradia - CourtneyR.dev's 2nd Brain

The best linux screenshot tool - Gradia 🔗 **Source:** [The best linux screenshot tool - Gradia](https://www.youtube.com/watch?v=B88NeX-dK2E) > [!note]+ Document Notes > tags: [linux-tools, screenshot, productivity] > author: [MISSING] > source: YouTube > reference: https://www.youtube.com/watch?v=B88NeX-dK2E > date created: 2025-01-14 12:00 > > # 🏷️ Title: The best linux screenshot tool - Gradia >  ## 🧰 Action Inbox - [H1] Install Gradia from Flatpak, Snap, or Nix — available across package managers #linux-tools - [H2] Test OCR text extraction feature — mentioned but not demonstrated in video #productivity - [H3] Configure annotation tools for customer support workflows — numbers, circles, arrows for step-by-step guides #workflow ## 🧭 Table of Contents - [📝 Summary](#-summary) - [📖 Main Content](#-main-content) - [🗒️ Notes](#️-notes) - [📚 References](#-references) - [🗣️ Paraphrase](#️-paraphrase) - [📰 Newsletter](#-newsletter) - [✅ Action Items](#-action-items) - [🧪 Hypotheses](#-hypotheses) - [📊 Methodology](#-methodology) - [❓ Questions](#-questions) - [🔮 Future Research](#-future-research) - [💡 Implications](#-implications) - [🧠 Learning Styles Assessment](#-learning-styles-assessment) - [📊 Accessibility Assessment](#-accessibility-assessment) - [🌍 DEIB Assessment](#-deib-assessment) - [✅ Logical Validity](#-logical-validity) - [🛡️ DARVO Analysis](#-darvo-analysis) - [🎯 Conclusion](#-conclusion) ### 🔗 References - [Gradia Official Site](https://gradia.alexandervanhe.be) - [Linux Unplugged Podcast](https://linuxunplugged.com/) ## 📝 Summary - A Linux user demonstrates Gradia as a comprehensive screenshot tool with annotation capabilities - Addresses the gap between basic screenshot tools (Slurp/Grim) and feature-rich solutions like CleanShot X on macOS - Shows practical workflow for creating annotated screenshots for customer support documentation - Highlights cross-desktop compatibility, working well on both GNOME and Hyperland window managers - Provides alternative to problematic tools like Flameshot that don't work reliably across all Linux environments ## 📖 Main Content The video presents Gradia as a solution for Linux users seeking advanced screenshot capabilities beyond basic screen capture. The presenter, coming from CleanShot X on macOS, needed annotation features for customer support workflows but found existing Linux tools inadequate. Gradia offers comprehensive screenshot editing with annotations (arrows, numbers, shapes), background customization (solid colors, gradients, custom images), and formatting options (padding, border radius, shadows). The tool includes OCR text extraction capabilities, though this wasn't demonstrated in the video. Key advantages include cross-desktop compatibility (works on Hyperland, GNOME, and other environments), multiple installation options (Flatpak, Snap, Nix), and a workflow that supports both file saving and clipboard copying for immediate use. ## 🗒️ Notes #### ⏱️ [00:00](https://youtu.be/B88NeX-dK2E?t=0) — [H1] Current screenshot workflow limitations - Key idea: Basic Slurp/Grim setup lacks annotation capabilities - Evidence: "takes a screenshot, but then I'm just left pasting the said screenshot into Dolphin... annotation has just not been there" #### ⏱️ [00:35](https://youtu.be/B88NeX-dK2E?t=35) — [H2] CleanShot X as the gold standard - Key idea: macOS CleanShot X provided comprehensive screenshot features - Evidence: "you could take a screenshot... there's arrows and notations... you could scroll and you could capture them" #### ⏱️ [01:15](https://youtu.be/B88NeX-dK2E?t=75) — [H3] Flameshot compatibility issues - Key idea: Popular Linux screenshot tools don't work reliably across window managers - Evidence: "Flameshot... worked fine under KDE... but it did not work in Hyperland at all" #### ⏱️ [01:45](https://youtu.be/B88NeX-dK2E?t=105) — [H1] Gradia discovery and availability - Key idea: Found Gradia through Linux Unplugged podcast recommendation - Evidence: "available on flatub or the snap store... there is a current nyx package" #### ⏱️ [02:30](https://youtu.be/B88NeX-dK2E?t=150) — [H2] Feature comparison with CleanShot X - Key idea: Gradia matches most CleanShot X functionality for Linux - Evidence: "does essentially just what cleanot x does... doesn't have quite all the same features but has plenty" #### ⏱️ [03:15](https://youtu.be/B88NeX-dK2E?t=195) — [H3] Cross-desktop compatibility - Key idea: Works well beyond GNOME despite native integration claims - Evidence: "says great for Gnome, but honestly, I'm on Hyperland... It works great" #### ⏱️ [03:45](https://youtu.be/B88NeX-dK2E?t=225) — [H1] Screenshot workflow demonstration - Key idea: Simple area selection brings up annotation interface - Evidence: Shows selecting area and automatic interface appearance #### ⏱️ [04:30](https://youtu.be/B88NeX-dK2E?t=270) — [H2] Annotation tools overview - Key idea: Multiple annotation options for different use cases - Evidence: "I can choose... I'll use circles... Or I'd use a number" #### ⏱️ [05:15](https://youtu.be/B88NeX-dK2E?t=315) — [H3] Background customization options - Key idea: Flexible background styling for professional screenshots - Evidence: "change the background... solid... Gradient... or an image" #### ⏱️ [06:00](https://youtu.be/B88NeX-dK2E?t=360) — [H2] Export and sharing options - Key idea: Multiple output methods for different workflows - Evidence: "save it out to a file... or we can copy it directly to our clipboard" #### ⏱️ [06:30](https://youtu.be/B88NeX-dK2E?t=390) — [H1] Practical use case frequency - Key idea: Regular need for screenshot annotation in support workflows - Evidence: "I want to mark up an image probably three times a week" #### ⏱️ [07:00](https://youtu.be/B88NeX-dK2E?t=420) — [H2] Final recommendation and adoption - Key idea: Gradia solves the annotation gap for Linux users - Evidence: "Gradia is the one. That's what I'm going to keep using" ## 📚 References - [Gradia Official Website](https://gradia.alexandervanhe.be) - [CleanShot X](https://cleanshot.com/) - [Flameshot](https://flameshot.org/) ## 🗣️ Paraphrase - Linux screenshot tools often lack annotation features needed for professional documentation workflows, leaving users with basic capture-and-paste functionality - Gradia bridges the gap between simple Linux screenshot tools and comprehensive solutions like macOS CleanShot X, offering annotation, background customization, and flexible export options - The tool demonstrates cross-desktop compatibility, working reliably on various window managers including Hyperland and GNOME, solving compatibility issues that plague other screenshot utilities ## 📰 Newsletter Looking for better screenshot capabilities on Linux? Gradia might be your answer! This comprehensive tool brings professional annotation features to Linux desktops, offering arrows, numbers, shapes, and background customization that rivals macOS solutions like CleanShot X. Key benefits include cross-desktop compatibility (works on GNOME, Hyperland, and other window managers), multiple installation options (Flatpak, Snap, Nix), and OCR text extraction. Perfect for creating step-by-step documentation, customer support guides, or any workflow requiring annotated screenshots. The tool addresses common Linux pain points where basic screenshot utilities leave users manually editing in separate applications, streamlining the process into a single, efficient workflow. Resources: [Gradia Official Site](https://gradia.alexandervanhe.be), [Linux Screenshot Tools Comparison](https://itsfoss.com/take-screenshot-linux/), [Hyperland Window Manager](https://hyprland.org/) ## ✅ Action Items #### DevRel - Developer advocacy: Demo Gradia in Linux desktop workflow presentations - Education: Create screenshot annotation workshop for Linux users - Developer experience: Document integration with development tools and IDEs - Developer marketing: Feature in Linux productivity tool roundups - Community management: Gather feedback on screenshot tool preferences #### Community - Contributors: Test Gradia across different Linux distributions and desktop environments - Maintainers: Evaluate for inclusion in default desktop tool recommendations - Ecosystem: Compare with other Linux screenshot solutions for feature gaps #### Linux Desktop - Workflow: Integrate Gradia into standard documentation creation processes - Training: Develop guides for annotation best practices in technical documentation - Tool evaluation: Assess against Flameshot, GNOME Screenshot, and KDE Spectacle - Package management: Ensure availability across major distribution repositories ## 🧪 Hypotheses - Gradia's cross-desktop compatibility makes it more reliable than desktop-specific screenshot tools - OCR text extraction in Gradia provides workflow advantages over manual text transcription - Background customization features improve screenshot professionalism compared to transparent backgrounds - Single-tool annotation workflow reduces time compared to screenshot-then-edit approaches ### 📊 Methodology - Compatibility testing: Install and test Gradia across GNOME, KDE, Hyperland, and other window managers - Feature comparison: Create side-by-side comparison with Flameshot, GNOME Screenshot, and CleanShot X - Workflow timing: Measure time from screenshot to annotated output using different tools ### ❓ Questions - How does Gradia's OCR accuracy compare to dedicated text extraction tools? - What specific features from CleanShot X are missing in Gradia that users need most? - How well does Gradia integrate with different file managers and clipboard managers across Linux distributions? ### 🔮 Future Research - Comprehensive Linux screenshot tool benchmarking across desktop environments - User experience study comparing annotation workflows between platforms - Integration possibilities with Linux productivity and documentation toolchains ### 💡 Implications - Practice: Streamlines documentation creation workflows for Linux users and developers - Education: Enables better instructional content creation on Linux platforms - Community: Reduces barrier to creating high-quality visual documentation in open source projects - Accessibility: May improve visual communication for users who struggle with text-only documentation ### 🧠 Learning Styles Assessment Reading level estimate: 8th Grade (Flesch-Kincaid) #### 👀 Visual learners - Present: Screenshot examples, tool interface demonstration, annotation samples - Improve: Comparison charts with other tools, feature matrix visualization #### 🔊 Aural learners - Present: Video narration explaining features and workflow - Improve: Audio-only version focusing on tool benefits and use cases #### 🗣️ Verbal learners - Present: Clear explanations of tool capabilities and workflow steps - Improve: Glossary of screenshot terminology, comparison analogies #### 🧩 Kinesthetic learners - Present: Step-by-step demonstration of screenshot creation and annotation - Improve: Interactive tutorial checklist, hands-on installation guide #### 🧠 Logical learners - Present: Feature comparison with existing tools, workflow efficiency analysis - Improve: Decision tree for tool selection, performance metrics #### 🧑‍🤝‍🧑 Social learners - Present: Community recommendations (Linux Unplugged mention) - Improve: User testimonials, community forum discussions #### 🧘‍♀️ Solitary learners - Present: Individual workflow demonstration, personal use case examples - Improve: Self-assessment questionnaire for tool fit, independent practice exercises #### 🌿 Naturalistic learners - Present: Tool ecosystem context within Linux environment - Improve: Package manager availability as part of distribution ecosystem ### 📊 Accessibility Assessment #### Screen reader semantics - Present: Clear headings in video title and description - Improve: Video transcript with heading structure, alternative text for screenshot examples #### Keyboard navigation - Present: Demonstrates keyboard shortcuts in workflow - Improve: Complete keyboard navigation documentation for tool usage #### Contrast and readability - Present: High contrast interface elements in tool demonstration - Improve: Color accessibility notes for annotation tool usage #### Text resizing and reflow - Present: Tool interface appears scalable in demonstration - Improve: Documentation of accessibility settings within Gradia #### Media and captions - Present: Video with audio narration - Improve: Closed captions, full transcript with timestamps #### Forms and interactions - Present: Clear interface interactions in demonstration - Improve: Accessibility evaluation of annotation controls ### 🌍 DEIB Assessment #### Cultural breadth - Present: Linux tool applicable across global developer communities - Improve: Multi-language interface options, international workflow examples #### Inclusive language - Present: Technical terminology explained clearly - Improve: Plain language summary of key concepts #### Neurodiversity support - Present: Step-by-step workflow demonstration - Improve: Alternative interaction methods, sensory considerations for tool usage #### Representation - Present: Focuses on technical capability rather than user identity - Improve: Diverse use case examples, varied professional contexts #### Psychological safety - Present: Non-judgmental tool comparison, acknowledges different preferences - Improve: Validation of different workflow needs, no tool shaming ### ✅ Logical Validity #### Strong reasoning - Deductive strength: If annotation features are needed and existing tools lack them, then Gradia fills the gap - Inductive strength: Personal experience with multiple tools supports general recommendation - Causal reasoning: Workflow inefficiencies caused by tool limitations, solved by feature-complete alternative - Analogical strength: CleanShot X comparison provides familiar reference point #### Fallacies - Hasty generalization: Limited testing period before full recommendation, should note evaluation timeframe - Appeal to authority: Linux Unplugged mention, while relevant, shouldn't be sole credibility source #### Tone of voice - Overall tone: Enthusiastic but practical, sharing genuine workflow problems and solutions with technical specificity ### 🛡️ DARVO Analysis - Deny: No denial patterns present - Attack: No attacks on critics or alternatives - Reverse victim/offender: No victim/offender dynamics - Emotional cues and rhetoric: Positive enthusiasm about tool discovery, frustration with previous limitations expressed constructively ## 🎯 Conclusion Gradia represents a significant improvement in Linux screenshot tooling, particularly for users requiring annotation capabilities for documentation and support workflows. Its cross-desktop compatibility addresses a major pain point with existing tools like Flameshot, while feature parity with macOS solutions like CleanShot X makes platform switching more feasible. For Linux users creating instructional content, technical documentation, or customer support materials, Gradia offers a complete workflow from capture to annotated output without requiring multiple applications. The tool's availability across major package managers (Flatpak, Snap, Nix) ensures broad accessibility across Linux distributions. The demonstration suggests Gradia could become a standard recommendation for Linux desktop productivity, particularly as remote work and digital documentation continue to emphasize visual communication tools. ## 🧱 Refactor Appendix ### 📚 Literature Split Pad Purpose: Stage CEE units that become Literature notes. Split level: H3 ### [H1] Gradia provides comprehensive screenshot annotation for Linux > [!quote] [The best linux screenshot tool - Gradia](https://www.youtube.com/watch?v=B88NeX-dK2E) by an unnamed author via [[YouTube]]. Published 2024. Accessed 2025-01-14. > "does essentially just what cleanot x does... doesn't have quite all the same features but has plenty" Addresses annotation gap in Linux screenshot tools compared to macOS solutions. [view highlight](https://www.youtube.com/watch?v=B88NeX-dK2E#H1) #linux-tools #productivity ID:rw_001 ### [H2] Cross-desktop compatibility solves Linux tool fragmentation > [!quote] [The best linux screenshot tool - Gradia](https://www.youtube.com/watch?v=B88NeX-dK2E) > "says great for Gnome --- ## Full Transcript [00:00] Welcome. Today we're going to look at [00:01] screenshots on Linux. Specifically, uh [00:03] I've tried a few things. Uh right now I [00:06] have via Hyperland I have super P lined [00:09] up with uh what is it? Slurp and Grim. [00:12] Uh and it works because that it takes a [00:14] screenshot, but then I'm just left [00:15] pasting the said screenshot into uh [00:18] Dolphin into my file manager and like [00:21] annotation has just not been there. Uh [00:23] I've looked at I've looked it's [00:25] just way too heavy. Lots of other [00:27] options. And what I came from was, let's [00:29] take a look at it so we can see it. This [00:32] is Gradia, which we'll talk about in a [00:33] second. Uh, CleanShot [00:36] X. This is what I came from, uh, on Mac [00:38] OS, which was excellent because you [00:40] could take a screenshot and you can see [00:41] like there's arrows and notations and [00:43] like you could scroll and you could [00:45] capture them. You can record gifts as it [00:46] says in the video there. Uh, it was [00:48] excellent. I used it to mark up [00:50] screenshots all the time for customers [00:51] to say, "Hey, step one, do this and put [00:53] a number one. Step two, do this. Put a [00:55] number two." Um and everything I had [00:58] tried. So I had tried um was it [01:01] Flameshot? Uh and that worked fine under [01:03] KDE or no. Uh but it did not work in [01:05] Hyperland at all. Like I couldn't even [01:07] get it to start up. I don't know why it [01:08] didn't start up. I didn't when it didn't [01:10] work I was like you know I don't have [01:11] time for this. Um but recently I heard [01:13] on Linux unplugged uh that about Gradia. [01:16] So that's what we're going to take a [01:17] look at now. [01:20] And to do that let's start by going to [01:21] the site which is Gradia Gradia. [01:24] alexandervanhe.be [01:27] available on flatub or the snap store. [01:29] I'm in nyx and there is a current nyx [01:31] package for the current release version [01:32] and it does essentially just what um [01:36] cleanot x does. Uh doesn't have quite [01:37] all the same features but has plenty. So [01:39] you can get beautiful screenshots, [01:40] right? Annotations. It has I never could [01:43] Okay, I'm trying to spend like 40 [01:44] minutes trying to figure out how to [01:45] showcase your code. I can't figure out [01:47] how to get this source snippet thing [01:49] working. So I don't know. Um, you can [01:52] extract text with OCR. Uh, you can have [01:55] native native integration. It says great [01:57] for Gnome, but honestly, I'm on [01:58] Hyperland. It works great. I'm on [01:59] Hyperland with Whand. It works great. [02:01] So, let's take this and let's do this [02:04] first by just opening Gradia [02:08] pretty. [02:10] And we can let's move this off to shift [02:14] 8 nine. We'll go back to super eight. [02:17] And we'll take us We'll go back to nine. [02:19] Actually, we'll take a screenshot. [02:20] That's the first thing. take a [02:21] screenshot. I can switch to eight. And I [02:24] can select the area I want to go. That's [02:27] going to bring gradient right back over. [02:29] I'm gonna move it. I moved it back over [02:31] to my ninth workspace on my laptop. And [02:34] then we have our annotation tools, [02:35] right? I can choose a lot of times I'll [02:38] use circles to say, hey, this thing [02:41] right here is what you're supposed to be [02:42] looking at for users for my use. This [02:44] right here, right? Or I'd use a number. [02:46] I picked the hot pink. This is not the [02:48] standard one. You can just click and get [02:49] one or two. Don't love the size of that. [02:54] Bring the sizes up. Yep. Three, four, [02:57] five, six. Great. Um, we can also change [03:00] the background here, right? I can say [03:01] it's solid. See, right back here, it's [03:03] solid. Gradient. Gradient is fine. I'll [03:05] just leave it like that. Or an image. [03:07] Uh, and I can select my own custom image [03:09] if I want. I'm just going to leave it as [03:10] gradient. I think that what this allows [03:13] me to do and have beautiful screenshots [03:15] already is a far and above worrying [03:17] about what image specifically is in the [03:19] background. Right? We can change our [03:20] padding on the image minus leave a five [03:24] is great. We can change the border [03:25] radius right right here. [03:30] Two is also great. We can change the [03:31] shadow. We can change the autobalance [03:33] aspect ratio. Uh again, I would leave [03:36] everything kind of how it is, right? We [03:37] can change the name of it and we can [03:39] save it out to a file, right? save [03:40] image. It's going to open up. We can [03:42] save it wherever we want or we can copy [03:45] it directly to our clipboard. And [03:47] honestly, this is exactly what I have [03:50] been needing uh in a screenshot tool. [03:53] So, if you are looking for a good [03:55] screenshot tool on Linux uh that lets [03:56] you do markup because I honestly I want [03:58] to mark up an image probably three times [03:59] a week and I just haven't been doing it. [04:01] I keep being what about I fired a [04:03] flameshot didn't work. Uh try try [04:05] uh color paint I think I have on here as [04:07] well and none of it worked. But Gradia, [04:10] Gradia is the one. That's what I'm going [04:11] to keep using. That's what I would [04:12] recommend at this point. If you have any [04:14] questions, whatever things I miss, maybe [04:17] you know how Flameshot should work. I'm [04:18] not going to try it anymore, but you can [04:20] tell me below. Uh or if you other other [04:22] Linux tools you think I should do that [04:23] are going to enhance my experience [04:24] because Gradia, perfect. Love it. I'd [04:27] love to know more good tools. Have an [04:30] awesome day.