✦Use cases / Videos you can make / Bug reports

Bug reports a developer can act on.

Capture the screen, mark the problem, copy the exact error text and record the steps that cause it. Attach a file to the ticket and you are done.

Made forQA testersProduct managersDesignersSupport teamsDevelopers

“It doesn’t work” isn’t a bug report.

Developers need to see the problem, the exact error and the steps that cause it. Shotbox captures all three in under a minute.

What you'll make

Annotated screenshots

An arrow, a box and a number on exactly what went wrong.

Steps to reproduce

A short recording or GIF of the steps.

Exact error text

Copy the words out of a dialog that will not let you select them.

How Shotbox helps

Every tool for bug reports, in one app.

x 812 · y 344 #7A5CFF
Screenshots →

Capture exactly what’s wrong

Press ⌥⇧⌘4 and drag. The screen freezes so nothing moves while you select, and the loupe gives pixel-exact edges.

  • Area, window or full screen
  • Hex colour under the cursor
  • Capture history for this session
123
Then click Save
Annotate →

Mark the problem

Box the broken element, number the steps and add a note. Blur any customer data before it goes in the ticket.

  • Arrow, box, step counter, text
  • Blur destroys the original pixels
  • Copy straight to the clipboard
CAPTURE
card_declined (402): The card was declined.
→
CLIPBOARD
card_declined (402): The card was declined.
✓Text copied
Copy text from images →

Copy the exact error

Error dialogs often won’t let you select their text. Capture it and copy the words out, on your Mac.

  • From Quick Access
  • Accurate recognition
  • Paste into the ticket
02:14■✎
Mic + system audio
Screen recorder →

Record the steps

For bugs that need showing, record a short clip or GIF of the steps that cause it.

  • One shortcut to start and stop
  • MP4 or GIF
  • Draw on screen to point
# launch-review
Alex

Can you send the new settings screen?

You
Screenshots →

Into the ticket in one move

Drag the thumbnail straight from the corner of the screen into Linear, Jira, GitHub or Slack.

  • Drag and drop from Quick Access
  • Or copy and paste
  • Pin it on screen while you write
📌 Stick
Draw on screen →

Point at the bug while recording

Draw an arrow at the broken element while you record the steps.

  • Stick keeps the mark on its target
  • Five colours
  • Clear with C
→
Scrolling capture →

Layout bugs on long pages

Capture the whole page to show where a layout breaks further down.

  • Automatic or manual scrolling
  • Annotate the result
  • Drag straight into the ticket
Recommended setup

Start with these settings.

Capture⌥⇧⌘4 for an area or window
Screenshot lookPlain, so the bug isn’t hidden by styling
AnnotationRectangle, Step counter, Text (Sticker style)
RecordingGIF for short steps, MP4 with mic for longer ones
ExportGIF at 50%
Tips

Tips for better results.

  1. Click the window

    Click a window instead of dragging to capture exactly that window, with nothing overlapping.

  2. Nudge the selection

    Hold Space to move the selection and use the arrow keys to nudge it a pixel at a time.

  3. Check the colour

    For visual bugs, the loupe shows the exact hex colour under the cursor.

  4. Find it again

    Capture history (⇧⌘Y) lists everything you captured this session.

How it works

Three steps, one app.

Everything runs on your Mac, and nothing is uploaded on the way.

  1. 1

    Capture the screen

    Area, window or full screen with one shortcut.

    Screenshots →
  2. 2

    Copy the error

    Pull the text out of the capture, on your Mac.

    Copy text from images →
  3. 3

    Record the steps

    A quick recording or GIF to attach to the ticket.

    Screen recorder →
An example

Reporting a checkout bug

  1. 0:00

    Capture the broken checkout with ⌥⇧⌘4.

  2. 0:20

    Copy the error text out of the capture.

  3. 0:40

    Box the button, add a note and drag the screenshot into the ticket.

  4. 1:00

    Record a 15-second GIF of the steps and attach it.

Questions
Can I share a link to the recording?

No. Shotbox has no cloud, so you attach the file itself. Drag it straight into the ticket.

Can I hide customer data?

Yes. Blur or pixelate it in the screenshot; the original pixels are destroyed on export.

Do I need any permissions?

Screen Recording, granted once in System Settings.

Features you'll use
Shotbox app icon

Make it with Shotbox.

£5.60 a month, cancel any time.