SMS Backup Reader


This program is designed to read the XML backup files produced by the Android app SMS Backup & Restore by Ritesh. This program runs on Windows, OSX, Linux, and any other OS with Java installed.

Download Latest Version Sourceforge Project Page SMS Backup & Restore App

How to Use:

  1. Download the latest version of SMS Backup Reader from the link above.
  2. This program requires Java to run. If you do not have Java installed, please visit the Java website to obtain it: http://www.java.com
  3. To run, simply double-click on SMS Backup Reader. If it opens as a folder and shows you multiple files inside, then either you do not have Java installed, or you need to go back, right-click on SMS Backup Reader, and open it with Java.
  4. Enter your country code. The default is 1 for the U.S. For example, the U.K. is 44.
  5. There is an option to change the timezone hours offset for the received messages. ONLY use this if you have previously encountered issues when loading messages!
  6. Once it is open, choose the file you want to load by clicking the appropriate button.
  7. Next, click Load!.
  8. To see different conversations, click on the contacts on the left side. The numbers are the PHONE NUMBERS of the contacts. If there are no names showing, it is because you did not backup the names using SMS Backup & Restore. SMS Backup Reader does not know the names unless they are in the file.
  9. To export a specific conversation, click on that contact, and click the Export button.
  10. To export all conversations, click on the Export All button.
  11. Close the program when you are finished.
Similar instructions are available in English, Spanish, Hindi, and Dutch inside of the program.

Current Features:

  • Country code selection. You may have a contact stored one way, but when the SMS comes in, it may have the full international prefix and country code, even if it is from that same country you are in. Entering the country code of your number helps solve some of this problem.
  • Separate message threads for each contact.
  • "Sent" and "Received" and date/time information for each message.
  • Export all conversations as a single text file divided by contact (easy archiving for later reading/printing).
  • International support (UTF-8)

Known Issues:

  • Issue reading some backup files. Probably due to certain cases of formatting (Such as an email address instead of a number)
  • Poorly formatted XML files will cause the program to do nothing when you click load (for example, if "&#0" is in the XML file). This is a null character and shouldn't be there. Working on a way to ignore it

(Eventual) To-dos:

  • Country code drop down instead of entering manually
  • Read other backups. (Call Log, APN, etc).

Changelog

v0.7 - 2013-05-10
  • Completely recoded and tested the project:
  • Tested with Java 6 and 7, on Windows 7, Windows 8, Ubuntu, and OS X 10.8.
  • Eclipse instead of NetBeans
  • Refactored to better fit the Java programming model: BackupReader is now a separate class, enabling GUI/CLI creation as a separate entity.
  • Better commenting (still needs more).
  • Feedback for load success/failure
  • Added error codes to deal with problems reading files.
  • Feedback for export success/failure.
  • Added better international support (Unicode font and UTF-8 parsing).
v0.6 - 2012-05-20
  • Added the ability to change the received message time offset.
  • This will make it so you can effectively change the timezone. Default is 0 (zero), if it already works, do not change it!
v0.5.1 - 2011-12-02
  • Forgot to remove some debugging statements
  • Extra address checking
v0.5 - 2011-12-02
  • Added help in 4 languages
  • Fixed an issue with draft messages. The address is "null" for drafts.
  • Fixed an issue with short codes. If the address is less than 6, assume its a short code.
  • Tested with the latest backups from SMS Backup & Restore (as of 2011-12-02) and old backups (2011-07-20).
v0.3.5 - 2011-10-26
  • Added the ability to export selected contact messages.
  • Added popups to warn if no messages were loaded rather than simply doing nothing.
v0.3 - 2011-10-26
  • Added the ability to export all messages as a file
v0.2.1 - 2011-09-05
  • Fixed a bug or two
v0.2 - 2011-08-03
  • Added the ability to specify country code. This should help with multiple versions of the same contact.
  • Bug fix, code cleanup
v0.1.5 - 2011-07-31
  • Fix for initial release (v0.1 had some issues).
All content authored by: devadvance (+Matt Joseph).