Skip to content

Loffe/sms-backup-plus

 
 

Repository files navigation

SMS Backup+

This is a fork of the Android backup tool SMS Backup, where development has stopped a while ago. It uses Gmail to perform SMS, MMS and call log backups over the network.

Main differences / improvements:

  • New restore feature. SMS stored on Gmail can be transferred back to the phone. This even works for users who have already created their backups with older versions of SMS Backup. Note: MMS are currently not restored.

  • XOAuth: SMS Backup+ will never ask you for your Gmail password. Instead it uses XOAuth to get access to your data. You can revoke the access rights at any time.

  • MMS backup support (since 1.1), only available on Android 2.x

  • Call log backup (since 1.2), with Google Calendar integration (since 1.3.)

  • Faster backups. SMS Backup+ saves around 30% of data transferred by avoiding Base64 encoding of emails.

  • Batch size limits removed.

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

Tested with Android 1.5 - 2.2.

Important: Some browsers / handsets which ship with non-standard browsers are currently not fully supported, there appears to be a problem which breaks the authorisation process, so connecting your Gmail account via XOAuth is not possible. You'll see the error message "You do not have permission to open this page".

Some possible workarounds:

  • Use the stock Android browser for the authentication (you can switch back afterwards)
  • Install a 3rd party browser (Dolphin HD has been reported to work)
  • Use plain text authentication (Advanced Settings - Server Settings), use your gmail address as username and supply your password

SMS Backup+ is available for free in the market, there will never be a pro / paid version.

But if you like the app you can flattr it (flattr it ??).

Installation

MarketQRCode Install via the Android market QR code link or directly from github downloads.

First steps

You need to have an IMAP account or a Gmail account with IMAP enabled. See the Enabling IMAP in Gmail help page to learn how to enable IMAP for your Gmail account or look at this screenshot. If you use Google Apps make sure you select "Sign in with a Google Apps Account" (screenshot). Also note that it does not work when two-step authentication is enabled for a Google Apps account login.

After starting SMS Backup+, tap on the "Connect" check box to start the authorization process. A browser window will open where Gmail either prompts you to log in or (if you were already logged in) a screen asking you to give SMS Backup+ permission to access your emails.

After clicking on "Grant Access" SMS Backup+ will become visible again, the checkbox should now be checked, indicating that the authorization process was successful.

Upgrading (for users of SMS Backup)

You don't need to uninstall the old version in order to try out SMS Backup+. However make sure that "Auto backup" is disabled in both apps, otherwise you might end up with messages backed up multiple times, resulting in duplicates in Gmail.

If you've used SMS Backup before you should just connect your Gmail account as described above (SMS Backup+ is not able to access login information stored by SMS Backup). Make sure you select "Skip" when asked about the initial sync, otherwise already backed up messages will be backed up again.

Initial backup

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

After having connected your Gmail account, SMS Backup+ will ask you to perform a first sync. If you choose "Backup", SMS Backup+ will start backing up all your messages to Gmail.

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

After you performed your initial backup, SMS Backup+ is ready to run in the background and finish uploading all of your current and future messages (check "Auto Backup"). Make sure that you have Background data enabled in your Android Accounts & Sync settings (screenshot).

Restoring

If you wish to restore messages back to your phone tap "Restore". By default all messages stored on Gmail will be restored (this can be changed in "Advanced Settings"). You can safely restore to a phone which has already message stored on it, SMS Backup+ will skip the restore of already existing messages.

SMS Backup+ can also backup your call logs. It stores all calls using a separate label (defaults to Call log, but can be changed in Advanced Settings). If you wish you can set this to the same value as SMS, to make all backed up data use the same label.

The body of the call log message contains the duration of the call 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 sync with.

If you only want to backup specific call types you can do so as well.

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

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

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

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

It's a known SMS bug in the latest OTA 2.2 update (details). As a workaround you can try installing SMS Time fix (apk) and activate the "Last Resort" option (screenshot).

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

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

Screenshot

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

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

Installation from source

$ git clone git://github.com/jberkel/sms-backup-plus.git
$ cd sms-backup-plus
$ echo "sdk.dir=/path/to/android-sdk" > local.properties
$ ant debug
$ adb install bin/sms-backup-plus-debug.apk

I've imported some relevant issues from the original issue list to github issues.

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

However, if you're already familiar with Git I'd prefer if you cloned the repository and send me a pull request.

##Credits

##Screenshots

SMS Backup+ screenshot Gmail screenshot Gcal screenshot

##License

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

About

Backup Android SMS, MMS and call log to Gmail / Gcal / IMAP

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 97.3%
  • Python 2.7%