HomeDocsiOSScreenshot reports

Screenshot reports

v1.7.0

Detect screenshots, request permissions and attach images to bug reports.

Automatic screenshot detection

When users take a screenshot, BugScreen automatically presents the bug report UI. No additional code required. Reporters can attach up to four screenshots to a single report from the in-app sheet.

Reporter settings load asynchronously. If the sheet opens before they arrive, it shows a loading indicator and keeps any attached screenshot. If they cannot be loaded, the sheet shows a Retry action instead of opening the form with default settings.

Permissions

Photo Library Access (Recommended)

Add this to your Info.plist so BugScreen can auto-attach the screenshot the user just took, and so users can pick screenshots manually:

xml
<key>NSPhotoLibraryUsageDescription</key>
<string>Attach screenshots to bug reports to help us fix issues faster</string>
Auto-attach: When a screenshot is detected, BugScreen renders a snapshot of the current window and pre-attaches it immediately. If the user grants photo library access, BugScreen also looks up the actual screenshot from Photos and swaps it in. Without permission, the window snapshot remains attached.