Scott Hanselman

Help your users record and report bugs with the Problem Steps Recorder

October 9, '12 Comments [43] Posted in Bugs | Tools
Sponsored By

A few weeks back I ranted in Everything's broken and nobody's upset and it found its way around the web. Some called it a poorly  organized straw man and others felt it was a decent jumping-off point for a larger discussion about software quality. It was likely both of these and more.

On the subject of bug reporting, there's a wonderful gem of a program that ships with Windows 7 and Windows 8 that you and your users can use to report and record bugs. It's the Problem Steps Recorder and it's like TiVo for bugs.

Hit the Start button and type either "Steps" or even "PSR" or to run the Problem Steps Recorder.

Problem Steps Recorder

Click Start Record and reproduce your bug. You can even click "Add Comment" to highlight an area of the screen as a call-out.

Problem Steps Recorder records your clicks

It's kind of a poor-man's screencasting tool. Rather than a heavy full screen video, the Steps Recorder is taking a screenshot on each click or action.

The user can then save the whole thing as as ZIP or just click "Email." I plan on using this the next time my non-technical parents have an issue they want to report.

Since this little app ships with Windows, why not launch it directly from your product's interface or 'Send Feedback' link? Then you could automate the receipt of these recorded problems and directly inject the resulting files into your bug reporting system.

What do you think?

Related Posts in this Three Part series on Software Quality

  1. Everything's broken and nobody's upset
  2. A Bug Report is a Gift
  3. Help your users record and report bugs with the Problem Steps Recorder

About Scott

Scott Hanselman is a former professor, former Chief Architect in finance, now speaker, consultant, father, diabetic, and Microsoft employee. He is a failed stand-up comic, a cornrower, and a book author.

facebook twitter subscribe
About   Newsletter
Sponsored By
Hosting By
Dedicated Windows Server Hosting by SherWeb
Tuesday, 09 October 2012 20:14:25 UTC
Nice tip, passing it on to some customers now.

Have you seen how Google does their "Give us feedback" functionality? You can highlight or blackout areas of the page you're on while submitted feedback/bug report from within the webpage itself. Very nifty.
Tuesday, 09 October 2012 20:22:04 UTC
Try Jing. Better functionality.
Tuesday, 09 October 2012 20:34:53 UTC
HOW DID I NOT KNOW ABOUT THIS TWO YEARS AGO???? *passes out from anger*

Anyways - this is awesome. Wonder if I could start it from a webapp?
Tuesday, 09 October 2012 20:53:37 UTC
This is awesome. One of W7's best kept secrets. How many more tools are there like this in W7?
Tuesday, 09 October 2012 20:55:13 UTC
Is there are reference for the "Additional Details" at the bottom of the page?
Jonathan Beerhalter
Tuesday, 09 October 2012 20:59:11 UTC
Good idea, Scott. Psr is too well hidden and people seem oddly resistant to using it. I think that putting a link in the user interface to launch it for the user makes a lot of sense.
Tuesday, 09 October 2012 21:42:49 UTC
Can't believe I've never heard of this before. I'll be passing this around the rest of my QA team in the office once our long overdue upgrade to Windows 7 arrives as a quick way to track those hard-to-repro bugs.
Martin Costello
Tuesday, 09 October 2012 22:00:56 UTC
I used this all the time when I worked in a computer lab back in school. A real time saver!
Tuesday, 09 October 2012 23:23:53 UTC
In a word. Awesome. So why didn't you tell us sooner? :)
Tuesday, 09 October 2012 23:52:16 UTC
This is great for capturing step-by-step screenshots for quick, one-pass documentation as well, not just for recording 'problem steps'.
Wednesday, 10 October 2012 00:56:59 UTC
I noticed that it captures all desktops. I wonder if there is a way to specify only to capture one desktop.
Brian K
Wednesday, 10 October 2012 02:54:27 UTC
oh it's Great for Users ;)
Wednesday, 10 October 2012 03:03:11 UTC
Beats taking screenshots and using ms paint any day. Would be really nice to see an article on lesser known tools that ships with windows that can be really useful.
Sivakumar Kailasam
Wednesday, 10 October 2012 03:19:18 UTC
Just keep in mind that in some fields (medical, legal), sending any kind of screen makes it incredibly easy to inadvertently release confidential information (say a patient's record that's on screen at the time, or a contract to a potential rival). That can get you into hot water really quickly.

On the other hand, for helping my parents out of a jam, yeah, this could be really handy!
Wednesday, 10 October 2012 05:32:57 UTC
Its a step in the right direction.
Wednesday, 10 October 2012 07:09:57 UTC
Jing may be fine, but you are missing two points here:
1. This is already installed on most of the clients.
2. The information is strictly shared between the user and you, it doesn't take a roundtrip to the Jing servers.
Palle Due Larsen
Wednesday, 10 October 2012 09:03:01 UTC
What a great feature, thanks for letting us know.

I guess I'll add a link to run psr.exe in my applications' help zone, to make it easier for my users to start it up when I need them to.
Kev Winchcombe
Wednesday, 10 October 2012 10:09:48 UTC
Nice one! It's a shame that this feature isn't better known. Thanks for the article, I'll be sure to pass this along!
Ronald Zarīts
Wednesday, 10 October 2012 10:17:25 UTC
This looks to be very useful, but I'm working on a Silverlight app at present, pretty sure I can't launch this from a SL app.
Wednesday, 10 October 2012 10:20:53 UTC
We use this at work for some finicky issues. For a freebie it's good enough, but I think there are some other alternatives around.
Wednesday, 10 October 2012 12:45:07 UTC
This would be great... if my company could be bothered to upgrade everyone to Windows 7. But until XP is dead, Screen Recorder will just be another fantasy.
Wednesday, 10 October 2012 12:52:21 UTC
Very nice Scott... like everyone else said.. too bad it isn't better known
Gregg Coleman
Wednesday, 10 October 2012 13:31:03 UTC
This is a great solution if your user base aren't the entire web. For example, if you have a limited group of user like for an Intranet. Nevertheless, for a worldwide web application, it might be cumbersome for novice user just to launch the application. It would be great to have something within the webpage like a scriptlet to do the same.
Wednesday, 10 October 2012 13:39:20 UTC
Hidden gem!! will pass this on to our QA team

Channa Mydur
Channa Mydur
Wednesday, 10 October 2012 14:10:57 UTC
@CB - If you're in an "out-of-browser" SL app with "full trust", you can launch other executables
Wednesday, 10 October 2012 19:01:41 UTC
I don't see the mail option on my Windows 7. Also, it would be nice if you could pass some settings via the command line to help automate it further when running it from your own app.
Al Gonzalez
Wednesday, 10 October 2012 19:20:22 UTC
I don't remember reading about this in any feature overview at the time Windows 7 was launched. It should have been in.

Thank you Scott for unveiling this wonderful tool.
Joris Spriet
Wednesday, 10 October 2012 21:34:16 UTC
@Al Gonzalez - the email option is a little hidden. Once you have recorded and saved the steps ZIP file, you hit the little down arrow next to the Help icon (or Alt+G) and select Send to Email Recipient.

@Scott - thank you, this has made my day, I only wish I had known about it earlier!
Thursday, 11 October 2012 01:42:34 UTC
Thanks Scott, I'm surprised that Windows had that feature already. I'm following too many tech blogs for years and this is the first time I've heard about that feature. I'll use it a lot. Thanks again
John Kaplan
Thursday, 11 October 2012 01:55:05 UTC
screencast-o-matic is another good screen recorder and it works out of a browser.
Thursday, 11 October 2012 04:06:05 UTC
Good also for doing tutorials ;-).
Thursday, 11 October 2012 05:19:46 UTC
Instead of this, I'm using timesnapper ( all day long. It takes a screenshot in a fixed interval, like every 5 seconds and plays it back like a movie.

I'm using it for both time registration, productivity (see what you actually spent your time on), restoring that blog post that you just lost from a crash and finally bugs; when you can't reproduce that bug you just saw, just play back the movie. (and email the screenshots)
Thursday, 11 October 2012 05:42:03 UTC
Weird that it captures the screenshots with its own window present as well.
Thursday, 11 October 2012 08:30:26 UTC
Did I miss it, or is there a way to launch this from a web-page (without using a plugin)? If so; how?
Thursday, 11 October 2012 10:15:33 UTC
Excellent information Scott.
Thursday, 11 October 2012 15:17:15 UTC
Nice utility but it doesn't work. When adding a comment it says "An error occurred while attempting to add a comment." I also do not get any screenshots from the zip file.
Jason Thorpe
Thursday, 11 October 2012 16:47:14 UTC
THIS is why I read your blog! Another gem I wasn't aware of. Thanks Scott
David M
Thursday, 11 October 2012 17:00:21 UTC
no creativity in this solution ,may be MS has to pay for some one to get more creative idea of how to report the error in Windows .
Thursday, 11 October 2012 17:17:21 UTC
It is a decent tool if your users know how to reproduce the issue they are having. However, I have found that often users aren't paying attention enough to know what it was that they were doing when the issue happened.
Davin Studer
Thursday, 11 October 2012 20:16:27 UTC
I am curious to see what improvements they have made to this tool. When my organization upgraded to Windows 7 we were using this to help troubleshoot user problems. It could have been user error, but we did get a lot of PSR recordings that were missing steps and screenshots or some that would be totally corrupted and we could view them at all, especially when using with older applications running in XP mode.

It is a nice little tool and did help narrow down issues with users most of the time. I have also used it in the past to document steps for new user tutorials.
Tuesday, 16 October 2012 12:28:22 UTC
I found a bug in Windows 8 and recorded it using this useful tool. Now, I cannot find a good place to report Windows 8 bugs!

Even this query seems to indicate that Microsoft does not have a place to accept Windows bugs from normal users:
Thursday, 01 November 2012 11:06:16 UTC
<rant> Just tried submitting a bug report for Visual Studio 2012. And give up after 15 minutes. First it wanted me to sign in. Fine. Tried siging in and got "we need to verify you". Not a problem - got text message, verified account. Tried again in VS - suggested to use the Feedback tool. Installed it in VS, siging in there and it tells me that my Microsoft account is not Connect account. And to get that connected I was asked to create a public profile. Public profile for bugreport??? and asking my birth date and address for public profile?? seriously? I just want to submit an ecking bug report, I don't want to hand out all my private info.

Given up. MS still does not want feedback from their users. </rant>
Friday, 11 October 2013 14:22:14 UTC
After clicking on 'Start Record' in PROBLEM STEPS RECORDER, I am getting the error as "An error occurred while attempting to start recording". Can you please provide the way to resolve this error.

Thanks in advance,
Comments are closed.

Disclaimer: The opinions expressed herein are my own personal opinions and do not represent my employer's view in any way.