StepGrab 1.4! you all said the arrows needed to be editable. They are now.

StepGrab 1.4! you all said the arrows needed to be editable. They are now.

Last time I posted about StepGrab here, most of the feedback came down to the same thing: the arrows. They point at the click, which is correct, but sometimes that means covering the exact button you were trying to show — and the only fix was to record the whole thing again.

That's what 1.4 is. There's an editor window now:

  • Drag the numbered badge to change the arrow's direction and length
  • Drag the middle of the line to bend it around whatever it was covering, or flip an elbow to the other side
  • Click the step description to rewrite it — clear the field and the generated sentence comes back
  • Reorder steps by dragging, delete them, undo anything with ⌘Z
  • The preview renders the actual export per format — PDF, HTML, GIF, Mobile — so what you're looking at is the file you'll get, not an approximation of it

For those who don't know the app: StepGrab sits in the menu bar. You start a recording, click through whatever you want to document, and it takes a screenshot on every click, draws the arrow, numbers the step and writes a sentence describing what you did. Then it exports as a PDF, an HTML page, Markdown, a GIF, an MP4 or a portrait video. Mostly useful for support docs, onboarding, SOPs — anything you'd otherwise end up explaining twice.

On the free tier and pricing, since that came up here too: the recording quota is gone. Free is now 15 steps per guide and as many guides as you want, with GIF export, and no account — you just open the app and record.

Pro unlocks the other formats (PDF, HTML, Markdown, MP4, portrait video), raises the step limit and lets you put your own logo and footer on exports. $2.99/month with a 3-day trial, $12.99/year, or $44.99 once. The yearly works out at about a third of paying monthly, which is deliberate — I'd rather people stay than churn.

Everything runs locally. No account, no upload, no telemetry. macOS 14+.

Still very interested in what's annoying about it — the arrow thing came from here, so it clearly works.

→ StepGrab on the Mac App Store

Screenshots and a longer walkthrough at stepgrab.net if you'd rather look before installing.

u/Comprehensive_Web279 — 2 months ago

StepGrab 1.4 — you all said the arrows needed to be editable. They are now.

Last time I posted about StepGrab here, most of the feedback came down to the same thing: the arrows. They point at the click, which is correct, but sometimes that means covering the exact button you were trying to show — and the only fix was to record the whole thing again.

That's what 1.4 is. There's an editor window now:

  • Drag the numbered badge to change the arrow's direction and length
  • Drag the middle of the line to bend it around whatever it was covering, or flip an elbow to the other side
  • Click the step description to rewrite it — clear the field and the generated sentence comes back
  • Reorder steps by dragging, delete them, undo anything with ⌘Z
  • The preview renders the actual export per format — PDF, HTML, GIF, Mobile — so what you're looking at is the file you'll get, not an approximation of it

For those who don't know the app: StepGrab sits in the menu bar. You start a recording, click through whatever you want to document, and it takes a screenshot on every click, draws the arrow, numbers the step and writes a sentence describing what you did. Then it exports as a PDF, an HTML page, Markdown, a GIF, an MP4 or a portrait video. Mostly useful for support docs, onboarding, SOPs — anything you'd otherwise end up explaining twice.

On the free tier and pricing, since that came up here too: the recording quota is gone. Free is now 15 steps per guide and as many guides as you want, with GIF export, and no account — you just open the app and record.

Pro unlocks the other formats (PDF, HTML, Markdown, MP4, portrait video), raises the step limit and lets you put your own logo and footer on exports. $2.99/month with a 3-day trial, $12.99/year, or $44.99 once. The yearly works out at about a third of paying monthly, which is deliberate — I'd rather people stay than churn.

Everything runs locally. No account, no upload, no telemetry. macOS 14+.

Still very interested in what's annoying about it — the arrow thing came from here, so it clearly works.

→ StepGrab on the Mac App Store

Screenshots and a longer walkthrough at stepgrab.net if you'd rather look before installing.

stepgrab.net
u/Comprehensive_Web279 — 2 months ago

Do you try on less when there's a queue at the fitting room?

Mods gave me the okay. I'm writing my bachelor's thesis at WU Vienna on queues at fitting rooms, and I need people who actually shop in stores.

8 min, anonymous, no names or email, university server, 18+: https://soscisurvey.wu.ac.at/waiting_at_fitting_rooms/

The thing I'm testing: a queue number you pull with your phone so you keep browsing instead of standing in line. It doesn't make the wait shorter, just less like waiting.

I think it might not work. You'd have to pull the number before you've finished picking things out, and then get called at the wrong moment.

Menswear fitting rooms are emptier than womenswear ones, so this may be less of an issue here than I assume. That's partly why I'm asking. Does a queue change what you take in, or do you just wait?

reddit.com
u/Comprehensive_Web279 — 2 months ago

The fitting room queue was the worst part of my shift, and I'm now writing my thesis about it

I worked for a clothing store and Saturdays at the fitting rooms were the thing that ruined me.

I'm back at university now and I ended up writing my bachelor's thesis about exactly this. The idea I keep coming back to is a digital queue number — you scan a code, keep browsing, get a ping when a room is free. Nobody waits less. It just isn't spent standing in a line.

What I don't know, and what you do: whether that would actually survive contact with a real shop floor, or whether it just moves the problem somewhere else. My guess is the people who ignore the ping become your problem instead.

If anyone's up for it, there's a short anonymous survey (about 8 min, no names, no email, runs on my university's server): https://soscisurvey.wu.ac.at/waiting_at_fitting_rooms/

But honestly I'm more interested in what you'd say in the comments.

reddit.com
u/Comprehensive_Web279 — 2 months ago

[Academic] Waiting at fitting rooms in clothing stores — 8 min, anonymous (18+, must have used a fitting room in the past 12 months)

I'm writing my bachelor's thesis at WU Vienna about queues at fitting rooms — whether ideas that work for waiting online (a virtual queue number, a live availability screen, something to do while you wait) also work in a physical store.

About 8 minutes, completely anonymous: no names, no email addresses, no IP addresses.

https://soscisurvey.wu.ac.at/waiting_at_fitting_rooms/

soscisurvey.wu.ac.at
u/Comprehensive_Web279 — 2 months ago

[Academic] Waiting at fitting rooms in clothing stores (18+, anyone who has used a fitting room in the past 12 months)

I'm writing my bachelor's thesis at WU Vienna about queues at fitting rooms — specifically whether ideas that work for waiting online (a virtual queue number, a live availability screen, something to do while you wait) could also work in a physical store.

About 8 minutes, completely anonymous: no names, no email addresses, no IP addresses.

https://soscisurvey.wu.ac.at/waiting_at_fitting_rooms/

Happy to post the results here once I'm done. Thanks!

reddit.com
u/Comprehensive_Web279 — 2 months ago

Umfrage für meine Bachelorarbeit: Warteschlangen an Umkleidekabinen (8 Min, anonym)

Hallo zusammen,

ich schreibe an der WU Wien meine Bachelorarbeit über Warteschlangen an Umkleidekabinen — genauer darüber, ob Ideen, die beim Warten im Netz funktionieren, auch im Laden etwas bringen: eine virtuelle Wartenummer, eine Anzeige mit freien Kabinen, oder etwas zu tun während des Wartens.

Der Fragebogen ist auf Englisch, dauert etwa 8 Minuten und ist vollständig anonym.

https://soscisurvey.wu.ac.at/waiting_at_fitting_rooms/

Danke euch! Die Ergebnisse teile ich gerne, wenn ich durch bin

reddit.com
u/Comprehensive_Web279 — 2 months ago

[Academic] Waiting at fitting rooms in clothing stores (18+, anyone who has used a fitting room in the past 12 months)

I'm writing my bachelor's thesis at WU Vienna about queues at fitting rooms — specifically whether ideas that work for waiting online (a virtual queue number, a live availability screen, something to do while you wait) could also work in a physical store.

About 8 minutes, completely anonymous: no names, no email addresses, no IP addresses.

https://soscisurvey.wu.ac.at/waiting_at_fitting_rooms/

Happy to post the results here once I'm done. Thanks!

reddit.com
u/Comprehensive_Web279 — 2 months ago

9 months of building, 4 months of shipping updates, live on Product Hunt today

StepGrab on Product Hunt

What it is: a Mac menu bar app that takes a screenshot every time you click and turns that into a numbered step-by-step guide. Hit record, do the task once, stop. Every click comes back as a screenshot with an arrow on what you clicked and the step already written next to it.

Export as PDF, GIF, MP4, HTML or Markdown. Works with any Mac app, not just browser tabs, so Outlook, Excel and System Settings are fair game. Runs entirely on device, no account, nothing uploaded.

I posted the first version here about a month ago. Since then it went 1.0 to 1.3, and the honest summary is that almost none of the good ideas were mine. Keystroke badges, the permission handling, the entire onboarding rebuild, all of it came from people in comment sections telling me what was broken. 1.3 shipped this morning.

Still a student, still building this next to a working student job, still figuring out the part that comes after "the app works".

stepgrab.net · Mac App Store

If you've launched on PH before: what's the one thing you'd do in the first three hours that isn't refreshing the page?

u/Comprehensive_Web279 — 2 months ago

Rebuilt the first-run flow of a small macOS utility. Same number of screens, completely different job. Would like a second opinion.

Rebuilt the first-run flow of a small macOS utility. Same number of screens, completely different job. Would like a second opinion.

I spent the last week rewriting onboarding for a Mac app I work on. The old version was five screens and I now think four of them were doing nothing.

Old flow

  1. Welcome
  2. A list of six features
  3. Sign-in prompt
  4. Permission request
  5. "You're all set"

Then the window closed. The app lives in the menu bar, so what you were left with was an icon and no content. Every screen described the product. None of them moved the user toward using it.

New flow

  1. Welcome, one sentence on what it's for, plus a language picker
  2. First permission, with a status row that flips to a checkmark the moment it's granted in System Settings, no relaunch
  3. Second permission, marked optional, stating what you lose if you skip it
  4. "Record something", with a suggested throwaway task
  5. The result of that recording

Screen 4 is the actual change. Instead of describing what the app does, the user does it once, on a task we suggest so nobody has to invent one. Screen 5 shows what came out. Sign-in was removed from onboarding entirely.

Screenshots of the new flow attached, in order.

Three things I'm unsure about

  1. The language picker on screen 1. Apple's HIG is clear that you shouldn't ask for setup information before the app has done anything, and I agree in principle. But the people who need it are precisely the ones running their Mac in one language while producing output in another, and if it's buried in settings they never find it. Is there a pattern for "optional setup that a minority genuinely needs early"?
  2. Two permission screens or one. I split them because each needs its own explanation and one of them is optional. The result is that a two-step requirement now looks like two steps out of five. Would you merge them into one screen with two rows, or does splitting help comprehension enough to justify the length?
  3. Evaluating this without analytics. The app has no telemetry and I want to keep it that way, which means I have no drop-off data. Watching people over the shoulder works but stops scaling after about ten sessions. For those of you who have evaluated onboarding under that constraint, what did you actually use? I'm asking about method, not looking for participants.

Happy to be told the whole thing is still wrong. That's sort of the point of asking now instead of after it ships.

If you'd rather drop an idea somewhere than write it here, there's a feature inbox. Comments work just as well.

u/Comprehensive_Web279 — 3 months ago

Follow-up: after your feedback I went and read my own onboarding like a new user. It was worse than I thought.

Last week I posted here about 1-star reviews getting to me. Most of you said some version of the same thing: it's usually not bugs, it's the app failing to explain itself. u/elementik4 split it into two buckets for me — wrong-fit user is a store listing problem, missing a setting that exists is an onboarding problem. That split stuck with me all week.

So I opened my own setup wizard and read it like someone who had never seen the app.

Five pages. Welcome screen. A list of six features. A sign-in prompt. A permission request. Then "you're all set", the window closes, and you're looking at a menu bar icon with nothing in it. Not one of those pages does anything for the user. I built a slideshow and called it onboarding.

Then I went reading. Apple's HIG is pretty blunt about it ("education isn't a substitute for great app design"), and there's an NN/g study with 70 people, tutorial vs no tutorial. The tutorial group wasn't faster and wasn't more successful. They rated the app as harder. That one stung.

What's changing:

  • Feature list is gone. It was already in the help window.
  • Sign-in moves to the end, after you've seen it work.
  • New page 3: you record something right now, with a suggested 20 second task.
  • New page 4: the actual screenshots you just captured, plus an export button.

u/elementik4 also pointed me at TipKit, so the rest of the features get surfaced later when they're relevant instead of all at once up front. u/andreimotin said to test it on someone who has never seen the app, not on myself, so I'm doing that this weekend with people who aren't developers. u/TravelCodeRepeat asked whether there's a contact button inside the app. There wasn't. There is now.

Three things I could use help with:

  1. Screen Recording permission. Do you hard-gate the wizard on it, or let people click past it? The app does nothing without it, so letting someone through means they get a broken app. But blocking them on page 2 feels aggressive.
  2. The first recording. Suggest a specific task, or let them pick their own? Suggested is faster, their own is more relevant to them. Can't decide.
  3. Small stuff. Has anyone seen a first-run detail in another Mac app that you thought was clever? I mean the little things. A permission row that flips to a checkmark the second you grant it. Something that saves one click, or one moment of "wait, what now". Those details seem to be what makes an app feel finished, and I'd rather steal a good one than invent a mediocre one. This is also just a good excuse to hear which apps got it right, since I only ever see my own.

Thanks again to everyone who replied last time. It genuinely changed what I'm building this month.

reddit.com
u/Comprehensive_Web279 — 3 months ago
▲ 18 r/MacOS

Update on the small Mac app I posted here two weeks ago — most of it came from your comments

I posted about StepGrab here two weeks ago and got a lot more feedback than I expected. Instead of writing another pitch, I'd rather just tell you what changed, because almost all of it came from this sub.

What it does, briefly, for anyone who missed it: it sits in the menu bar, you hit record, do a task once, and every click comes back as a screenshot with an arrow on what you clicked and the step written out next to it. GIF, PDF or MP4 at the end. Everything runs on your Mac, no account, no upload.

What shipped since:

  • Step descriptions now read as one connected flow instead of isolated click sentences
  • Text recognition got noticeably better inside menus and popups
  • The German quotation marks that kept sneaking into English guides are gone

All three came from comments on the last post. The quotation mark one still slightly embarrasses me.

What still doesn't work: unlabelled toolbar icons. I recorded two real workflows last week and counted, 4 of 9 steps wrong in one and 5 of 11 in the other, every single failure an icon with no text label. You get "click the checkbox at the upper left" where the honest answer is "Object Selection Tool". To describe a click properly you need to know what was clicked, and on macOS that lives in the Accessibility API. I've shipped a build that used it, but approval for that entitlement is unpredictable enough that I can't put a core feature on top of it, so I work from OCR and cursor position instead. Editing the step text before export is what I'm building next, because right now any guide with toolbar work needs fixing by hand afterwards.

Free tier is 10 steps per guide across 5 guides, or 20 and 20 if you sign in, with GIF export. Pro is $9.99 a year or $44.99 once.

I'm launching it on Product Hunt tomorrow and made a code for that. It felt backwards to run it there first when you're the people who actually shaped the last release, so here it is a day early:

https://apps.apple.com/redeem?ctx=offercodes&id=6760129490&code=PHUNT

Code PHUNT, brings Lifetime to $34.99 instead of $44.99, valid until 1 September. Apple only allows it on accounts that haven't bought anything in the app yet, so it won't work if you already went Pro.

Not asking for anything tomorrow. I just didn't want to hand the better price to strangers before the people who gave me the roadmap.

Still curious about one thing: for those of you who write guides for colleagues or family, what do you do about them going stale when the app updates? That's the problem I have no answer for yet.

u/Comprehensive_Web279 — 3 months ago
▲ 15 r/macapps

Solo devs: the 1-star reviews get to me way more than they should, and most of them aren't actually bugs. Normal?

I'm the solo dev behind a small Mac app, a few weeks into being live, and I wanted to be honest about the part nobody really talks about.

The negative feedback gets to me. One critical review sits with me longer than ten good ones lift me up. I know that's lopsided and probably not rational, but it genuinely affects my mood for a day. Is that just how it is early on, or does it fade?

The other thing I keep noticing: when I dig into the harsher reviews, most of them aren't bugs. They're people expecting the app to do something it doesn't, or not finding a setting that's already there. My first instinct was "that's user error," but the more I sit with it, the more it feels like my problem, not theirs. If people don't discover a feature or misread what the app is for, that's me failing to make the app explain itself.

Here's the part I keep chewing on, and maybe I'm being naive. If someone doesn't like the app, or wants control it doesn't give them, docking a star or two feels completely fair to me. What throws me is a one-star for something that works exactly as described. In my head, one star is for a bug, or an app that doesn't do what it promises. "It does what it says, but it's not for me" feels like a reason to move on, not a one-star. But maybe that's just ego, and a rating is really just "did this deliver enough for me." How do you read it?

Either way, I'm not just venting. I'm building a proper in-app guided tour, something that walks you through your first real use instead of dropping you in cold, and surfaces the settings people keep missing.

Questions for people further along than me:

  1. How do you stop the bad reviews from wrecking your headspace? Did it get easier?
  2. Is "most negative feedback is really an onboarding gap" everyone's experience, or just my stage?
  3. And honestly, how do you think about what a one-star should mean?

Not looking for reassurance, genuinely trying to learn from people who've been through it.

u/Comprehensive_Web279 — 3 months ago

Solo devs: the 1-star reviews get to me way more than they should, and most of them aren't actually bugs. Normal?

I'm the solo dev behind a small Mac app, a few weeks into being live, and I wanted to be honest about the part nobody really talks about.

The negative feedback gets to me. One critical review sits with me longer than ten good ones lift me up. I know that's lopsided and probably not rational, but it genuinely affects my mood for a day. Is that just how it is early on, or does it fade?

The other thing I keep noticing: when I dig into the harsher reviews, most of them aren't bugs. They're people expecting the app to do something it doesn't, or not finding a setting that's already there. My first instinct was "that's user error," but the more I sit with it, the more it feels like my problem, not theirs. If people don't discover a feature or misread what the app is for, that's me failing to make the app explain itself.

Here's the part I keep chewing on, and maybe I'm being naive. If someone doesn't like the app, or wants control it doesn't give them, docking a star or two feels completely fair to me. What throws me is a one-star for something that works exactly as described. In my head, one star is for a bug, or an app that doesn't do what it promises. "It does what it says, but it's not for me" feels like a reason to move on, not a one-star. But maybe that's just ego, and a rating is really just "did this deliver enough for me." How do you read it?

Either way, I'm not just venting. I'm building a proper in-app guided tour, something that walks you through your first real use instead of dropping you in cold, and surfaces the settings people keep missing.

Questions for people further along than me:

  1. How do you stop the bad reviews from wrecking your headspace? Did it get easier?
  2. Is "most negative feedback is really an onboarding gap" everyone's experience, or just my stage?
  3. And honestly, how do you think about what a one-star should mean?

Not looking for reassurance, genuinely trying to learn from people who've been through it.

reddit.com
u/Comprehensive_Web279 — 3 months ago
▲ 53 r/AppHookup+2 crossposts

[macOS] StepGrab ($49.99 to $34.99 lifetime Pro with offer code, ends July 17) Record a task once instead of stitching screenshots together by hand, and get a step-by-step guide with annotated screenshots and written steps

The deal first: lifetime Pro drops from $49.99 to $34.99 with the offer code FIRSTWEEK30P, valid until July 17 and capped at 1000 redemptions total. Redeem it in the App Store app (App Store menu, then Redeem Gift Card or Code). There is also a yearly option at $9.99, and the base app is free with a usable tier (5 steps per guide, 10 guides, GIF export), so you can test it before paying anything.

Background, because I made this: I'm the person my family and coworkers ask when they don't know how to do something on their Mac. For years my answer was screenshots, cropped by hand, arrows drawn in Preview, pasted into a document. Three weeks later someone asks the same question, the app got an update, and half my screenshots are wrong.

StepGrab is what came out of six months of fixing that for myself. It sits in the menu bar, you hit record, do the task once, and stop. Every click turns into an annotated screenshot on its own, with an arrow on the thing you clicked and step text written by an on-device AI model ("Click Export in the toolbar"). Fully offline, no account, nothing leaves your Mac. Exports as GIF for free, PDF and MP4 with Pro.

Released last week and there are still codes left. Happy to answer questions.

PS: there is also an yearly subscription for 9,99$

apps.apple.com
u/Comprehensive_Web279 — 4 days ago

Mac devs adding App Intents: brainstorming with you before I write any code. What makes Shortcuts actions actually useful vs shelf-ware?

Before anything else: I read rule 10 and this is hopefully not that. There's nothing built yet and nothing to show, which is sort of the point. I want to steal this sub's collective brain before I decide what to build, since you're the people who'd actually use it.

Quick context: I make a small Mac app (StepGrab) that turns a screen recording into a step-by-step guide, one screenshot per click with the step text written on-device, exports to GIF, PDF or MP4. Zero Shortcuts support today. App Intents are next on my list. I'm deliberately not linking it, this isn't meant as promo.

What I'm trying to figure out with you: for the apps in your workflows, which actions do you actually run regularly, and which sounded good on the box but turned into shelf-ware? My current guesses are a "start recording" action, a "stop and export" with the format as a parameter, and guides as proper entities so the exported file can get passed down the chain (rename it, mail it, drop it in a shared folder). But I'm guessing.

The thing I can't answer alone is whether Spotlight/Siri triggering is the valuable half, or whether it's really about the file coming out the other end so the rest of your shortcut can grab it. And maybe there's a trigger type (folder, time, focus mode) that makes a documentation tool click into place in a way I'm not seeing.

If you've ever chained a capture or export app into a bigger workflow, I'd love to hear what made it stick, or what made you delete it after a week. Both teach me the same amount.

reddit.com
u/Comprehensive_Web279 — 3 months ago
▲ 93 r/MacOS+2 crossposts

Record a Mac task once, get a step-by-step guide. I spent 6 months building this native app — 100% on-device, offline, no Electron.

Hey r/macOS. Full disclosure: I'm a solo dev, this is my app, and I'm posting under the Saturday self-promotion rule. Been building it for the past 6 months.

The problem I kept re-explaining the same Mac tasks. Onboarding someone, or answering the same "how do I do this" question for what felt like the tenth time. Doing it by hand means screenshot, crop, annotate, write the step, repeat, and there goes the afternoon.

Why I didn't just use Scribe or Tango Both are browser extensions built for web apps, and they're fine at that. But most of what I document isn't in a browser. It's Finder, System Settings, the occasional native app. The browser tools simply can't see any of it.

What StepGrab does Hit record, do the task once, and you get a numbered step-by-step guide. Every click becomes a screenshot of the exact window, with the step text already written for you. Exports to GIF on the free tier, PDF and MP4 on Pro.

The part I actually care about Everything runs offline, and the AI that writes the step text runs on-device. There's no account or sign-up, so nothing about your screen ever leaves your Mac. It's also a native app, no Electron. A lot of what people document is internal or sensitive stuff, and I didn't want a cloud service sitting in the middle of that.

Pricing The free tier is actually usable: GIF export, up to 5 steps per guide, 10 guides total. Pro is $9.99/year or $49.99 lifetime (I hate forced subscriptions too) and removes the limits plus adds PDF and MP4 export. There's a 2-week Pro trial either way.

Mac App Store: https://apps.apple.com/app/stepgrab/id6760129490

Six months of evenings and weekends went into this, so roast away. I'm especially curious what you think of the capture approach and the on-device model. Happy to get technical in the comments.

u/Comprehensive_Web279 — 3 months ago

StepGrab 1.2 is out, one week after launching here. Your feedback basically wrote the changelog.

https://reddit.com/link/1utemx5/video/mrt5i901ckch1/player

Quick follow-up: I posted StepGrab here about a week ago. It's a Mac app where you record a task once and it turns into a numbered step-by-step guide, screenshots and written steps included. The launch went better than expected, and the feedback came with homework. A buyer found German quotation marks in his English PDFs, someone else called the design old school, and honestly both were right.

So here's what shipped in 1.2:

  • AI step text: on-device AI (Apple Intelligence) writes a natural description for every step. Nothing leaves your Mac.
  • Latency-free capture: recording no longer adds input lag.
  • Social export: turns a guide into a MacBook-mockup video in 9:16, 1:1 or 4:5, so a guide doubles as a demo clip.
  • Choose content: pick exactly which screen to record, external displays included.
  • Share as ZIP: PDF, GIF and MP4 together in one file.
  • In-app help that's actually searchable now.
  • Plus the unglamorous part: translation fixes across all languages and a redesign along Apple's current HIG.

Next on the list is a proper review window before export, where you can see all steps at full size and delete or reorder them. That one came straight from a Reddit comment too.

If you tried the first version and something bugged you, tell me. The changelog above is mostly your doing anyway.

Mac App Store: https://apps.apple.com/app/stepgrab/id6760129490 Site: stepgrab.net

reddit.com
u/Comprehensive_Web279 — 3 months ago

Keeping screenshot-heavy docs current, especially for native (non-browser) apps. How do you handle it?

For a while my hardest documentation problem wasn't writing the docs, it was stopping them from going stale. An app ships a UI update, half my screenshots now point at buttons that moved, people quietly stop trusting the doc, and a few weeks later nobody opens it.

Most of the capture tools I know (Scribe, Tango) are built for the browser. Fine for SaaS, not much help for what I actually document most: native macOS apps and system settings. So a good chunk of my process is still manual screenshotting, and those are the screenshots that rot first.

I care more about the maintenance side than the creation side, so I'm curious how you handle it. Do you review on a schedule, or only when a release breaks something and someone complains? Do you keep steps text-heavy and screenshot-light on purpose so there's less to redo? And for non-browser stuff, has any capture-and-update routine ever actually survived long-term for you?

Full disclosure: the native-app gap annoyed me enough that I built a small Mac tool for the capture part myself. I'd rather talk about the workflow than the tool, so I'm keeping it out of the post, but I'll drop it in the comments if anyone wants it. Mostly I want to hear what's kept your docs alive, because "just screenshot it all again" obviously doesn't scale.

reddit.com
u/Comprehensive_Web279 — 3 months ago
▲ 4 r/software+1 crossposts

StepGrab — record any Mac workflow and get a step-by-step guide automatically (native, on-device, works offline)

Hey r/macOSApps 👋

I'm the solo dev behind StepGrab, and this is my first time posting it here.

The problem

Every time I had to document a process — onboarding a teammate, writing an SOP, answering the same "how do I do X" question — I did the same tedious dance: screenshot, crop, paste, annotate, repeat, then write text around every step. A 12-step guide could eat 30–40 minutes, and it was outdated the moment the UI changed.

How it compares to what's already out there

The closest tools are Scribe and Tango. They're genuinely good, and if you live in Chrome they might suit you better: they're browser-first, capture web apps very cleanly, and have more mature team/sharing features than I do right now.

Where they didn't work for me: they're built around a browser extension. Capturing native Mac apps (Finder, System Settings, Xcode, a native mail client) is clunky or impossible. StepGrab is the opposite — it's a real Mac app, so it captures anything on your screen natively.

What it does

  • Hit record, do the task once, hit stop
  • It captures each click as a screenshot and auto-writes the step text
  • Auto-highlights where you clicked
  • Edit any step, screenshot or caption before you export
  • Export to PDF, Markdown, or HTML
  • Everything runs locally

Pricing

  • Free version — usable on its own
  • Pro — $9.99/year or $49.99 one-time (lifetime)
  • 2-week Pro trial, no card required

Transparency

  • 100% offline. No account, no login, no telemetry.
  • The AI that writes the step descriptions runs on-device — your screenshots never leave your Mac.
  • Notarized, distributed through the Mac App Store.
  • Requires macOS 14.6 (Sonoma) or later.
  • Privacy policy: stepgrab.net/privacy

Links

Happy to answer technical questions — under the hood it uses ScreenCaptureKit for capture and a local model for the text, no private APIs.

u/Comprehensive_Web279 — 3 months ago