Screenshot reports
v1.9.0Detect screenshots, request permissions and attach images to bug reports.
Automatic screenshot detection
Take a screenshot to open the bug reporter with an image attached.
If the reporter cannot load, choose Retry. Your attached screenshot stays in place.
Preview and markup
- Tap an image thumbnail to preview it. Swipe between attachments or remove an image from the preview.
- Choose Markup to use Pen, Arrow, Box or Redact, then save your edits.
Send your first report
- Run a tester build on a device and allow the screenshot permissions described below.
- Take a screenshot, check its preview, enter a description and submit the report.
- Open Report Inbox from your app’s Inbox tab in the console. Check that the report and its attachments appear. If the list has not updated, refresh it.
- If you connected an integration, open the resulting issue or message and check its attachments.
Choose each app’s reporter wording, Type choices and Severity visibility in the Console’s Reporter tab.
Permissions
Request permissions
Android 14+: no permission needed to detect screenshots. The SDK prompts once for photo access to auto-attach the screenshot; if denied, the user picks it from the photo picker instead.
Android 13 and below: needs a runtime permission to detect screenshots. Opt in with .requestPermissionsOnStart(true) to have the SDK prompt automatically, or use the fine-grained helpers below.
import android.app.Application
import app.bugscreen.android.BugScreenConfig
import app.bugscreen.android.BugScreenSDK
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
BugScreenSDK.start(
BugScreenConfig.Builder(this)
.apiKey("fb_your_api_key_here")
.requestPermissionsOnStart(true)
.build()
)
}
}To choose when to ask, call the permission helper from your Activity instead:
import android.os.Bundle
import androidx.activity.ComponentActivity
import app.bugscreen.android.BugScreenSDK
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
if (BugScreenSDK.shouldRequestPermission(this)) {
BugScreenSDK.requestScreenshotPermission(this) { granted ->
// Manual reports remain available if permission is denied.
}
}
}
}Permissions added to your app
BugScreen's manifest is merged into your app's manifest, so these <uses-permission> entries appear in your Play Console listing if you ship the SDK in your production app:
INTERNET— upload bug reports.READ_EXTERNAL_STORAGE(Android 12 and below only) — read the latest screenshot fromMediaStore.READ_MEDIA_IMAGES(Android 13+) — same lookup on modern Android; requested opt-in at runtime.DETECT_SCREEN_CAPTURE(Android 14+) — install-time, silent; lets the SDK know when a screenshot is taken.