SMSCLEANER

Section: User Commands (1)
Updated: 03.09.2006

NAME

smscleaner - Backup and delete SMS from a mobile phone using Gammu

SYNOPSIS

smscleaner [Options]

DESCRIPTION

smscleaner connects to a mobile phone using gammu. It reads the phone's phone book (so that a name can be added to the SMS if possible) and all SMS, then deletes surplus SMS after saving them to an XML file.

Caution:: This software is (perhaps still ;-) quite experimental. Version 0.1 was my first Python program and the first time I did something with mobile phones. Anyway, it has always been working as it should with my Nokia 6230i. I don't know if it works just as fine with other mobiles.
You're welcome to test it and contact me if there are problems. But use it with care, e. g. first run it with the -n option and check if everything is okay.

REQUIREMENTS

The Gammu engine (http://gammu.org/) is used to connect the mobile phone, so you need a working Gammu installation. Aditionally, the Gammu Python bindings (found at http://cihar.com/gammu/python/) and the PyXML package (from http://pyxml.sourceforge.net/) are needed. And Python, of course :-)

OPTIONS

-h, --help: Show a help message explaining the command line options
-l, --leave number: Leave number sent and number received SMS on the mobile. Short for -r number -s number.
-r, --leave-received number: Leave number received SMS on the mobile (default: 50)
-s, --leave-sent number: Leave number sent SMS on the mobile (default: 50)
-n, --no-delete: Don't actually delete the SMS from the mobile
-o, --outfile file: Write XML output to file instead of generating a file name from the sent or received dates of the processed SMS (see below)

Anyway, unread SMS and templates, etc. will be left untouched. SMS containing images are not handeled by smscleaner yet and will be also not deleted.

USAGE

First, smscleaner connects the phone, then it reads the phonebook. Only the phone memory (ME) is used, not the SIM card. Then, all SMS are read.
You can then choose what to do: exit, show the SMS that would be deleted and delete the SMS (after saving them to an XML file).

If SMS are deleted, they are stored in a file in ~/.smscleaner/. It is named by the creation date in the form ``YYYY-MM-DD[--YYYY-MM-DD][_N].xml'', where the first date is the date of the oldest deleted SMS and the second date the date from the newest deleted SMS. If they were all sent or received on the same day, the second date is leaved out. If a file with this name already exists, a consecutive number (``_N'') is appended automatically, so that no file will be overwritten.
The storage format used by smscleaner is quite simple XML. At the moment, smscleaner doesn't do anything with these files, but maybe somebody wants to parse them and do something with its content.

BUGS

SMS containing a Nokia picture are not yet handeled. I'm working on that, but not too hard ;-)

AUTHOR

Tobias Leupold <tobias . leupold at web . de>; http://nasauber.de/

This document was created by man2html, using the manual pages.
Time: 11:25:44 GMT, May 28, 2007