Latest 0.1.8
License MIT
Platforms ios 8.0
Dependencies SwiftyJSON
Frameworks MessageUI, Photos

CI Status

BugReporter is a simple and elegant bug reporting tool for you apps.


  • [x] Detect ‘take screenshot’ event and fire a report
  • [x] Create a report with information about the device and the application
  • [x] Send report using email as channel
  • [x] Send report using UIActivityViewController as channel
  • [x] User can select how to send reports
  • [x] User can dismiss sending a report
  • [x] Load configuration from a property file (plist)
  • [x] Notify reporting life cycle
  • [ ] Detect shake gesture and fire a report
  • [ ] Attach multiple images to a report
  • [ ] Save report into file system if cannot be sent
  • [ ] Send report to a backend

What BugReporter is not

  • BugReporter is not a crash reporting tool (like Crashlytics).
  • BugReporter will not take screenshots of your app unless the user triggers a report event.

How to setup

Include a file named BugReporterSettings.plist inside your project. The content of this property file should have at least one property called applicationId with a non-empty string value. This property will be used in future versions when integrating with a backend.


This property lets you specify a list of emails, used as default addresses when sending a report through email.

Example file

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
<plist version="1.0">
            <string>[email protected]</string>
            <string>developer_2_[email protected]</string>
            <string>[email protected]</string>        


  • iOS 8.0+
  • Xcode 8.1+
  • Swift 3.0+


  • If you need help, write me an e-mail
  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.


BugReporter is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod "BugReporter"


To run the example project, clone the repo, and run pod install from the Example directory first.


Ezequiel Aceto, ezequiel.aceto (at)


BugReporter is available under the MIT license. See the LICENSE file for more info.

Latest podspec

    "name": "BugReporter",
    "version": "0.1.8",
    "summary": "A simple and elegant bug reporting tool for you apps.",
    "description": "Bug Reporter is a tool that simplifies the process of reporting bugs and comments from users to developers.",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Kimi": "[email protected]"
    "source": {
        "git": "",
        "tag": "0.1.8"
    "social_media_url": "",
    "platforms": {
        "ios": "8.0"
    "source_files": "BugReporter/Classes/**/*",
    "resource_bundles": {
        "BugReporter": [
    "frameworks": [
    "dependencies": {
        "SwiftyJSON": [
            "~> 3.1"
    "pushed_with_swift_version": "3.0"

Pin It on Pinterest

Share This