SMS Backup+

Reporting bugs

Please read the known issues before reporting any new issues; we already know about several significant issues, including Gmail login failures (for which there is a robust work-around), and problems with logging phone calls into calendars (which we are investigating).

Description

This is a fork of the now-defunct Android backup toolSMS Backup. It uses Gmail/IMAP to perform SMS, MMS and call log backups overthe network.

Main features/improvements:

• Restore. SMS/Call logs stored on Gmail can be transferred back to the phone.

  • ⚠️ MMS are not restored.

• Security. SMS Backup+ does not need your Gmail password.

  • Where possible, SMS Backup+ uses XOAuth2, including when matching phone numbers againstcontact names, and writing call log records into your calendar. This access can be revoked at any time.
  • ⚠️ In June 2019 Google changed their API policy, introducing sensitivity scopes, andas a result SMS Backup+ can no longer use XOAuth2 to save messages into your mailbox;instead a "password" is required to access Gmail via IMAP, but it can be a generatedapplication password(which can be revoked without affecting your real password).

• MMS backup support (added in version 1.1)

• Call log backup (version 1.2), with Google Calendar integration(1.3) and restore (1.4).

• Works with any IMAP server (but defaults to Gmail).

Tested with Android 4.x (Ice Cream Sandwich) - 10.x. (Q)

SMS Backup+ is available for free in the Google Play Store and on F-Droid,there will never be a pro / paid version.

But if you find the app useful and want to support its development you can make a donationusing the secure in-app Play Store payment mechanism.

To get updates more frequently join the beta programme or download the latest beta manuallyfrom Github releases.

Also make sure to read the Privacy Policy.

Usage

First steps

You need to have an IMAP account or a Gmail account with IMAP enabled. SeeUse IMAP to check Gmail on other email clients to learn how to enable IMAP for your Gmailaccount or look at this screenshot.

After starting SMS Backup+, tap on "Connect" to start the authorization process.

�� 1.5.11: You will first have give SMS Backup+ the permission to access your account, displayedas "Allow SMS Backup+ to access your contacts?".

If you consent you have to confirm the Gmail account to be used for the backup.

If you don't have a Google account registered on your device a browser windowwill appear to perform a web-based authentication as fallback.

After completing the authorization process the "Connect"switch should be activated, indicating success. You are now ready to performthe first backup.

�� 1.5.11: "Connected" changed from checkbox to switch.

Initial backup

It is important that you perform the first backup manually. SMS Backup+ needsto know whether you want to upload messages currently stored on your device ornot.

After having connected your Gmail account, SMS Backup+ will ask you to performa first backup. If you choose "Backup", SMS Backup+ will start backing up allyour messages to Gmail.

If you choose "Skip", nothing is sent to Gmail and all messages currentlystored on your device are simply marked "backed up". This option is handy ifyou previously uninstalled SMS Backup+ and do not want to send your messagesagain to Gmail. Please note that any messages arrived after you lastuninstalled SMS Backup and this initial backup won't ever be backed up toGmail.

�� 1.5.11: Before the backup starts you will have to grant "send andview" permissions for SMS.

Restoring

If you wish to restore messages back to your phone tap "Restore". By defaultall messages stored on Gmail will be restored (this can be changed in "AdvancedSettings").

�� 1.5.11: Default changed to 500 messages.

You can safely restore to a phone which has already messages storedon it, SMS Backup+ will skip the existing messages.

Before the restore can start you will need to confirm the change of thedefault SMS app. This step is required to get further permissions to writemessages (see also the corresponding FAQ entry).

Call log support

SMS Backup+ can also backup and restore your call logs. It stores all calls using aseparate label (defaults to Call log, but can be changed in "Advancedsettings"). If you wish you can set this to the same value as SMS, to make allbackups use the same label.

The body of the call log message contains the duration of thecall in seconds followed by the phone number and call type (incoming /outgoing / missed).

An example:

267s (00:04:07)
+44123456789 (incoming call)

You can also add call log entries to a Google calendar. Just select Calendar sync in Advanced settings, and make sure you have selected a calendar to syncwith.

If you only want to backup specific call types (incoming, outgoint etc.) you cando so as well.

�� 1.5.11: Call log backup is disabled by default. Permissions need to be confirmedseparately for phone and calendar access.

Rich Communication Services

Rich Communication Services is currently not supported, nor are there any plans to support it.Rich Communication Services is also known as RCS, Advanced Messaging, Advanced Communications, joyn or Message+.

3rd party app integration

If you want to trigger backups from another app, enable 3rd party integrationin Advanced Settings and send the broadcast intentcom.zegoggles.smssync.BACKUP. This will work even when Auto Backup isdisabled.

Usage without Gmail (IMAP)

You don't have to use Gmail to backup your text messages - changeAuthentication to "Plain text" in "Advanced settings - Custom IMAP server",then change the server address / user name and password accordingly. Make sureto set security to "SSL (optional / trust all)" if your IMAP serverhas a self-signed certificate ("Unknown certificate" error duringbackup).

�� 1.5.11: security settings have been simplified. Select TLS and check"Trust all certificates" if using a self-signed certificate.

Also note that Gmail labels simply correspond to IMAP folders that willautomatically get created on the first backup.

FAQ

If you don't find an answer here you can also visit the Google+ community which might be ableto help.

• General questions
  • I want to file a bug report, what should I do?
  • Can you add feature X?
  • Why does it need so many permissions?
  • When updating the app I get 'Package file was not signed correctly'
• Backup questions
  • Automatic backup does not work / stopped working
  • I get the one of following errors during backup/restore: Command: SELECT "SMS"; response:...
  • Only received messages are backed up, not the ones I sent
  • How can I make the app think that it has to do the backup again?
  • Why do backed up SMS show up in my inbox?
  • I want the backed up messages to show up in my Gmail inbox!
  • What's the difference between regular and incoming backup schedule?
  • I'd like SMS Backup+ to schedule a backup only at a given time of the day / when Wifi is available / etc.
  • The app saves only 100 SMS/MMS per contact!
  • In Gmail, I'd like to have all messages listed chronologically and not ordered by who sent them.
  • When I delete a text locally, will it delete the saved copy on Gmail?
  • I get the error "Trust anchor for certification path not found"
• Restore questions
  • Why does SMS Backup+ ask to become the default SMS app?
  • Are there any plans to support restoring of MMS?
  • I'm not able to restore all of my (insert huge number) messages!
  • How do I restore the last N weeks / N messages?
  • The timestamps of the restored messages is wrong / the messages are not restored in the right order
• Authentication questions
  • How can I revoke the app's access to my Gmail account?
  • When connecting, I get 'Could not obtain request token...'

General questions

I want to file a bug report, what should I do?

First search Github issues to see if the bug has already been reported. If not, create a newissue and attach the following details:

• Version of SMS Backup+ used
• Version of Android / brand of phone used

If it is related to backing up / restoring you should also enable the sync log with"Extra debug information" enabled (in "Advanced settings") and attach a relevant portion of it.The sync log is stored as sms_backup_plus.log (in the directory Android/data/com.zegoggles.smssync/files).

�� 1.5.11: new log file path, was previously on external storage / sdcard.

Rather than including the log in the text of your issue description, please use the "attachimage" feature to attach your logfile as text to your issue.Alternatively, create a gist and link to it from your issue description.

It might also be worth to install the current beta version of SMS Backup+ tosee if the bug is also present in the development version.

Can you add feature X?

Over the years a lot of features have been added, often as a result ofrequests by users. This has worked great initially but has made the product itself very unfocussedand generic. It started as a tool to back up text messages (as the name SMS Backup implies) butgradually more and more features were added (call logs, MMS, WhatsApp...). It's now at a point whereit has become too heavy and difficult too maintain or use. The settings screen makes this obvious,there are just too many things to configure. If anything features should be removed at this point,not added. A more focussed product would be easier to maintain and use.

Right now, SMS Backup+ is in maintenance mode; no new features will be added. Existing bugs will ofcourse be addressed.

Why does it need so many permissions?

• Read contacts - Needed to map phone numbers to names and email addresses
• Your messages (read / write SMS) - Needed for backup+restore
• Modify calendar events - needed for the call log backup to GCal
• Send email to guests - this refers to calendar invitations (which are not created by the app)
• Prevent phone from sleeping - needed to keep network active during a backup
• Find accounts on the device - used for authentication
• Use accounts on the device - used for authentication
• Google Play billing service - used for in-app donations
• Run at startup - used to enable automatic backups after reboot

�� 1.5.11 introduces runtime permissions (Android 6.0+) which means that you only grant the permissionsfor the features you actually use, after installing the application.

When updating the app I get 'Package file was not signed correctly'

Try uninstalling the app, then installing the new version. Make sure to select"Skip" when doing the first backup, otherwise messages will get backed uptwice.

Backup questions

Automatic backup does not work / stopped working

If the automatic backup does not work first make sure that a manuallyinitiated backup works as expected.

�� 1.5.11 brings many improvements to auto-backup reliability. However some beta users havestill reported problems. If the backups don't run automatically try changing the Android"Battery optimization" settings for SMS Backup+ to "Don't optimize".

When reporting a bug related to auto backup it is essential to attach a sync log file. Seethe relevant FAQ for more information on how to do this.

I get the one of following errors during backup/restore: Command: SELECT "SMS"; response: #6# [NO, Unknown, Mailbox; SMS, [Failure]] (or response: #6# [NO, [NONEXISTENT], unknown mailbox: SMS (failure)])

Make sure you have the "Show IMAP" option checked in the Gmail label settings:

If this is the case make sure that the label name is set correctly (capitalizationmatters!).

How can I make the app think that it has to do the backup again?

Select "Reset" from the menu, and confirm that you want to reset the currentsync state. All messages on the phone will be backed up on the next run.

Only received messages are backed up, not the ones I sent

Do you use a non-standard app like Google Voice/Hangouts or Signal to sendmessages? It could also be a device specific problem.Related issues: 516, 841.

Why do backed up SMS show up in my inbox?

This is probably related to Gmail's automatic priority inbox filing.A workaround is to set up a filter with "subject: SMS with", let the filtermark it as not important.

I want the backed up messages to show up in my Gmail inbox!

Just set the label to "Inbox" instead of the default "SMS" or "Call log".

What's the difference between regular and incoming backup schedule?

Incoming backup schedule is used for incoming messages. 3 minutes here meansthat any incoming SMS will trigger a backup after 3 minutes. It is a fullbackup (including any sent messages). You should set the incoming schedule to alow value if you want to make sure that incoming SMS show up inGmail shortly after arrival.

Regular schedule is used to perform backups in specific intervals. 2 hours heremeans that the device will try to backup all messages every 2 hours.

Fewer updates performed by the app means less energy consumed, so there'sa trade-off data protection vs. battery life.

I'd like SMS Backup+ to schedule a backup only at a given time of the day / when Wifi is available / etc.

If you require more control over the backup schedule than what SMS Backup+ alreadyprovides you can use a 3rd party app to trigger the backup. Tasker forexample supports SMS Backup+ since version 1.0.14.

The app saves only 100 SMS/MMS per contact!

This seems to be a limitation of Gmail. After the first hundred or so SMS beingbacked up, Gmail will cease to properly thread many of the conversations.You will notice that Gmail will eventually treat each SMS (in that initialbackup) as individual conversations and will not longer group/thread themtogether.

A way around this is to do a full backup 100 SMS at a time (see Advanced settings).

In Gmail, I'd like to have all messages listed chronologically and not ordered by who sent them.

It's a Gmail feature, but you can disable it.In Gmail settings, set conversation view to off(screenshot).

When I delete a text locally, will it delete the saved copy on Gmail?

No. SMS Backup+ does not do a "real" sync, once the text has been transferredto Gmail it won't get modified or deleted by the app.

I get the error "Trust anchor for certification path not found"

This means that it is impossible to establish a trusted connection with the IMAP server. A fewreasons why this might happen:

• You run on an ancient version of Android
• You use an IMAP server with an expired or self-signed certificate

You can try to set the IMAP Server Setting Security to SSL (optional / trust all).

�� 1.5.11: Added "Trust all certificates" option

Restore questions

Why does SMS Backup+ ask to become the default SMS app?

Google has changed the way SMS permissions work starting with Android 4.4(KitKat). In order to get write access to your messages an app has to be set asthe default system SMS app. Before starting the restore operation SMS Backup+will request your permission to be set as default app. After restoring you willbe asked to set the previous choice (usually "Messaging") back as default. ⚠️ This last step is important, if you don't set the old default back you mightlose new messages.

Are there any plans to support restoring of MMS?

No, for a variety of reasons: MMS are highly carrier-dependent, documentation is lacking and theAndroid Emulator does not support them.

However SMS Backup+ is open source; patches are more than welcome.

I'm not able to restore all of my (insert huge number) messages!

SMS Backup has not been designed to restore many thousands of messages. See thequestion "How do I restore the last N weeks / N messages?" for a way around that.

How do I restore the last N weeks / N messages?

If you have a lot of messages backed up (let's say over 5000) restoring can bevery slow, especially if you're only interested in the most recent messages.

A workaround is to use the Gmail web interface (or an IMAP email client) tomove the bulk of the messages to another label in Gmail (e.g. SMSARCHIVED), andonly keep a few hundred or so messages in the SMS label.

Next time you restore it will only restore those messages and it will be a lotfaster.

Authentication questions

How can I revoke the app's access to my Gmail account?

Go to Authorized Access to your Google Account and select "Remove Access"next to "SMS Backup+".

When connecting, I get 'Could not obtain request token...'

If you get this error message and your network connection is activedouble-check that your time zone settings are correct, and that the local time isdisplaying correctly. The authentication process won't work otherwise.

Beta testing

If you want to help beta testing, visit the Play Store beta page. You will be asked to opt into the beta program (you can leave it anytime).

Once opted in your device will automatically update to the latest beta which might have bug fixesand features not found in the currently released version.

Alternatively you can download an APK from Github releases and install it manually( ⚠️ you won't get automatic updates this way). You can also install via F-Droidwhich often has more recent versions than what is available on the Play Store.

Contributing

Installation from source

$ git clone https://github.com/jberkel/sms-backup-plus.git
$ cd sms-backup-plus
$ ./gradlew assembleDebug
$ adb install app/build/outputs/apk/app-debug.apk

Translating the UI

If you want to help translating the UI to other languages download andtranslate the following file, then send the translated version via email:

• strings.xml

However, if you're already familiar with Git you can just clone therepository and submit a pull request.

Credits

• Christoph Studer Original author of SMS Backup (2009-2010)
• Ben Dodson - Contacts 2.0 / MMS support
• Felix Knecht - Call log backup code
• Michael Scharfstein - Call log calendar ICS support
• K-9 Mail IMAP library, with some modifications (k-9/sms-backup-plus)
• signpost Matthias Käppler, Signpost OAuth library
• Shimon Simon (new icon designs)
• bbs.goapk.com / Chen Ma, Aaron LI - Chinese translation
• Leszek Ciesielski - Polish translation
• Roberto Elena Ormad - Spanish translation
• Gabriele Ravanetti / Patryk Rzucidlo / Chiara De Liberato - Italian translation
• Harun Şahin - Turkish translation
• Lukas Pribyl - Czech translation
• João Pedro Ferreira - Portuguese translation
• Martijn Brouns, Niko Strijbol - Dutch translation
• Torbe - Norwegian translation
• Nemanja Bračko, Mladen Pejaković - Serbian translation
• Markus Osanger - German translation
• Dimitris / Mazin Hussein - Greek translation
• Yunsu Choi, Taegil Bae - Korean translation
• Javier Pico - Galician translation
• Ferran Rius - Catalan translation
• Mads Andreasen - Danish translation, initial JobDispatcher code
• sHa - Ukrainian translation
• Erik Eloff - Swedish translation
• Matrix44 - Slovak translation
• László Gárdonyi - Hungarian translation
• Petr P. Gornostaev, saratovout - Russian translation

Screenshots

1.5.11

1.5.10

License

This application is released under the terms of the Apache License, Version 2.0.