GAMMU(1) Gammu Documentation GAMMU(1)
NAME
Gammu - Does some neat things with your cellular phone or modem.
SYNTAX
Usage: gammu [confign] [nothing|text|textall|binary|errors] <command>
[options]
DESCRIPTION
This program is a tool for mobile phones. Many vendors and phones are
supported, for actual listing see <http://cihar.com/gammu/phonedb/>.
OPTIONS
First parameter optionally specifies which config section to use (all
are probed by default). Second parameter optionally controls debug
level, next one specifies actions.
Commands can be specified with or without leading --.
Debug levels
Parameters, which allow to control debug level:
nothing - no debug level
text - transmission dump in text format
textall - all possible info in text format
errors - errors in text format
binary - transmission dump in binary format
SMS and EMS
Sending messages might look a bit complicated on first attempt to use.
But be patient, the command line has been written in order to allow
almost every usage. See EXAMPLES section for some hints on usage.
addsms folder file
Adds SMSes from file (format like backupsms uses) to selected
folder in phone.
addsmsfolder name
backupsms file
Stores all SMSes from phone to file.
deleteallsms folder
Delete all SMS from specified SMS folder.
deletesms folder start [stop]
Delete SMS from phone. See description for getsms for info about
sms folders naming convention. Locations are numerated from 1.
displaysms ... (options like in sendsms)
getallsms -pbk
Get all SMS from phone. In some phones you will have also SMS
templates and info about locations used to save Picture Images.
With each sms you will see location. If you want to get such sms
from phone alone, use gammu getsms 0 location
geteachsms -pbk
Similiary to getallsms. Difference is, that links all contace-
nated sms
getsms folder start [stop]
Get SMS. Locations are numerated from 1.
When give folder 0, sms is given from "flat" memory (all sms
from all folders have unique numbers). It’s sometimes emulated
by Gammu. You can use it with all phones.
When give folder 1, 2, etc. sms are taken from Inbox, Outbox,
etc. and each sms has unique number in his folder. Name of
folders can depend on your phone (the most often 1="Inbox",
2="Outbox", etc.). This method is not supported by all phones
(for example, not supported by Nokia 3310, 5110, 6110). If work
with your phone, use getsmsfolders to get folders list.
getsmsc [start [stop]]
Get SMSC settings from SIM card. Numerate locations from 1.
getsmsfolders
Get names for SMS folders in phone
nokiagett9
restoresms file
Restores SMSes from file (format like backupsms uses) to
selected folder in phone. Please note that this overwrites
existing messages in phone (if it supports it).
savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id]
[-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name]
[-smscset number] [-smscnumber number] [-reply] [-maxsms num]
Read phonebook entry from file created by backup option and
saves in VCARD 1.0 (only name and default number) or VCARD 2.1
(all entry details with all numbers, text and name) format as
SMS
savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read]
[-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
[-smscnumber number] [-reply] [-maxsms num]
savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
Read WAP bookmark from file created by backup option and saves
in Nokia format as SMS
savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
Read calendar note from file created by backup option and saves
in VCALENDAR 1.0 format as SMS
savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num]
Save caller logo as sms (Nokia format - size 72x14).
savesms EMS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
[-maxsms num] [-unicode] [-16bit] [-format lcrasbiut] [-text text]
[-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10
file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE
file] [-toneSElong file] [-fixedbitmap file] [-variablebitmap file]
[-variablebitmaplong file] [-animation frames file1 ...] [-protected
number]
Saves EMS sequence. All parameters after -unread (like -def-
sound) can be used few times.
-text - adds text
-unicodefiletext - adds text from Unicode file
-defanimation - adds default animation with ID specified by
user.ID for different phones are different.
-animation - adds "frames" frames read from file1, file2, etc.
-defsound - adds default sound with ID specified by user. ID for
different phones are different.
-tone10 - adds IMelody version 1.0 read from RTTL or other com-
patible file
-tone10long - IMelody version 1.0 saved in one of few SMS with
UPI. Phones compatible with UPI (like SonyEricsson phones) will
read such ringtone as one
-tone12 - adds IMelody version 1.2 read from RTTL or other com-
patible file
-tone12long - IMelody version 1.0 saved in one of few SMS with
UPI. Phones compatible with UPI (like SonyEricsson phones) will
read such ringtone as one
-toneSE - adds IMelody in "short" form supported by SonyEricsson
phones
-tone10long - SonyEricsson IMelody saved in one or few SMS with
UPI
-variablebitmap - bitmap in any size saved in one SMS
-variablebitmaplong - bitmap with maximal size 96x128 saved in
one or few sms
-fixedbitmap - bitmap 16x16 or 32x32
-protected - all ringtones and bitmaps after this parameter
(excluding default ringtones and logos) will be "protected" (in
phones compatible with ODI like SonyEricsson products it won’t
be possible to forward them from phone menu)
Example: gammu savesms EMS -text "Greetings" -defsound 1 -text
"from Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
will create EMS sequence with text "Greetings" and default sound
1 and text "from Gammu" and ringtone axelf.txt and 2 frame ani-
mation read from (1’st frame) file1.bmp and (2’nd frame)
file2.bmp
Example: gammu savesms EMS -protected 2 -variablebitmaplong
ala.bmp -toneSElong axelf.txt -toneSE ring.txt
ala.bmp and axelf.txt will be "protected"
savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read]
[-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
[-smscnumber number] [-reply] [-maxsms num]
savesms MMSSETTINGS file location [-folder id] [-unread] [-read]
[-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
[-smscnumber number] [-reply] [-maxsms num]
savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-netcode netcode] [-biglogo]
Save operator logo as sms (Nokia format - size 72x14 or 78x21
after using -biglogo).
savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
Save Picture Image as sms (Nokia format - size 72x28).
savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ring-
tone]
Read ringtone (RTTL) format and bitmap (Picture Image size) and
name and save as Nokia profile.
savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-long] [-scale]
Read RTTL ringtone from file and save as SMS into SIM/phone mem-
ory. Ringtone is saved in Nokia format.
-folder number - save to specified folder. Numerate forlders
from 1. The most often folder 1 = "Inbox", 2 = "Outbox", etc.
-unread - makes message unread. In some phones (like 6210) you
won’t see unread sms envelope after saving such sms. In some
phones with internal SMS memory (like 6210) after using it with
folder 1 SIM SMS memory will be used
-read - makes message read. In some phones with internal SMS
memory (like 6210) after using it with folder 1 SIM SMS memory
will be used -unsent - makes message unsent
-reply - reply SMSC is set
-sender number - set sender number
-flash - Class 0 SMS
-smscset number - SMSC will be taken from set number. Default
set: 1
-smscnumber number - SMSC number
-long - ringtone is saved using Profile style. It can be longer
(and saved in 2 SMS), but decoded only by newer phones (like
33xx)
-scale - ringtone will have Scale info for each note. It will
allow to edit it correctly later in phone composer (for example,
in 33xx)
savesms SMSTEMPLATE [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-unicode] [-text text] [-unicodefiletext file]
[-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file]
[-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file]
[-variablebitmap file] [-variablebitmaplong file] [-animation frames
file1 ...]
savesms TEXT [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
[-maxsms num] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen
len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disable-
fax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID]
[-replacefile file]
Take text from stdin and save as text SMS into SIM/phone memory.
-folder number - save to specified folder. Numerate folders from
1. The most often folder 1 = "Inbox", 2 = "Outbox",etc. Use
getsmsfolders to get folder list.
-unread - makes message unread. In some phones (like 6210) you
won’t see unread sms envelope after saving such sms. In some
phones with internal SMS memory (like 6210) after using it with
folder 1 SIM SMS memory will be used
-read - makes message read. In some phones with internal SMS
memory (like 6210) after using it with folder 1 SIM SMS memory
will be used
-unsent - makes message unsent
-reply - reply SMSC is set
-sender number - set sender number (default: "Gammu")
-flash - Class 0 SMS
-smscset number - SMSC will be taken from set number. Default
set: 1
-smscnumber number - SMSC number
-len len - specify, how many chars will be read. When use this
option and text will be longer than 1 SMS, will be splitted into
more linked SMS
-autolen len - specify, how many chars will be read. When use
this option and text will be longer than 1 SMS, will be splitted
into more linked SMS.Coding type (SMS default alphabet/Unicode)
is set according to input text
-enablevoice | -disablevoice | -enablefax | -disablefax |
-enableemail | -disableemail - sms will set such indicators.
Text will be cut to 1 sms.
-voidsms - many phones after receiving it won’t display any-
thing, only beep, vibrate or turn on light. Text will be cut to
1 sms.
-unicode - SMS will be saved in Unicode format
-inputunicode - input text is in Unicode.
TIP: You can create Unicode file using WordPad in Win32 (during
saving select "Unicode Text Document" format). In Unix can use
for example YUdit.
-replacemessages ID - ID can be 1..7. When you will use option
and send more single SMS to one recipient with the same ID, each
another SMS will replace each previous with the same ID
-replacefile file - when you want, you can make file in such
format: src_unicode_char1,dest_unicode_char1,src_uni-
code_char2,dest_unicode_char2 (everything in one line). After
reading text for SMS from stdin there will be made translation
and each src char will be converted to dest char. In docs there
is example file (replace.txt), which will change all "a" chars
to "1"
TIP: when use ~ char in sms text and -unicode option (Unicode
coding required), text of sms after ~ char will blink in some
phones (like N33xx)
Example: echo some_text | gammu savesms TEXT
savesms TODO file location [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread]
[-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset
number] [-smscnumber number] [-reply] [-maxsms num]
Read WAP settings from file created by backup option and saves
in Nokia format as SMS
sendsms VCARD10|VCARD21 destination file SM|ME location [-nokia]
[-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder
number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
sendsms ANIMATION destination frames file1 file2... [-report] [-valid-
ity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset
number] [-smscnumber number] [-reply] [-maxsms num]
sendsms BOOKMARK destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms CALENDAR destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms CALLER destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms EMS destination [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-16bit]
[-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID]
[-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file]
[-tone12long file] [-toneSE file] [-toneSElong file] [-fixedbitmap
file] [-variablebitmap file] [-variablebitmaplong file] [-animation
frames file1 ...] [-protected number]
sendsms MMSINDICATOR destination URL Title Sender [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms MMSSETTINGS destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms OPERATOR destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode]
[-biglogo]
sendsms PICTURE destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-uni-
code] [-alcatelbmmi]
sendsms PROFILE destination [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap
bitmap] [-ringtone ringtone]
sendsms RINGTONE destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
sendsms SMSTEMPLATE destination [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-text
text] [-unicodefiletext file] [-defsound ID] [-defanimation ID]
[-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file]
[-toneSE file] [-toneSElong file] [-variablebitmap file] [-vari-
ablebitmaplong file] [-animation frames file1 ...]
sendsms TEXT destination [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-inputunicode]
[-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice]
[-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-dis-
ableemail] [-voidsms] [-replacemessages ID] [-replacefile file]
sendsms TODO destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms WAPINDICATOR destination URL Title [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms WAPSETTINGS destination file location DATA|GPRS [-report]
[-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]
[-smscset number] [-smscnumber number] [-reply] [-maxsms num]
sendsmsdsms TEXT|WAPSETTINGS|... destination FILES|MYSQL|PGSQL config-
file ... (options like in sendsms)
smsd FILES configfile
SMS Deaemon. See smsdrc config file for more options
smsd MYSQL configfile
smsd PGSQL configfile
Memory (phonebooks and calls)
addcategory TODO|PHONEBOOK text
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
clearall
deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]
getallcategory TODO|PHONEBOOK
getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
getcategory TODO|PHONEBOOK start [stop]
getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]
Get memory location from phone. Numerate locations from 1.
DC = Dialled calls
MC = Missed calls
RC = Received calls
ON = Own numbers
VM = voice mailbox
SM = SIM phonebook
ME = phone internal phonebook
FD = fixed dialling
SL = sent SMS log
getspeeddial start [stop]
listmemorycategory text|number
nokiagetpbkfeatures memorytype
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
savefile VCARD10|VCARD21 target.vcf file SM|ME location
savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id]
[-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name]
[-smscset number] [-smscnumber number] [-reply] [-maxsms num]
Read phonebook entry from file created by backup option and
saves in VCARD 1.0 (only name and default number) or VCARD 2.1
(all entry details with all numbers, text and name) format as
SMS
searchmemory text
sendsms VCARD10|VCARD21 destination file SM|ME location [-nokia]
[-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder
number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
Filesystem
addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT]
[-readonly] [-protected] [-system] [-hidden] [-newtime]
Add file with specified name to folder with specified folder ID.
-type - file type was required for filesystem 1 in Nokia phones
(current filesystem 2 doesn’t need this)
-readonly, -protected, -system, -hidden - you can set readonly,
protected (file can’t be for example forwarded from phone menu),
system and hidden (file is hidden from phone menu) file
attributes
-newtime - after using it date/time of file modification will be
set to moment of uploading
addfolder parentfolderID name
deletefiles fileID
deletefolder name
getfilefolder ID1, ID2, ...
getfiles ID1, ID2, ...
getfilesystem [-flatall|-flat]
Display info about all folders and files in phone memory/memory
card. By default there is tree displayed, you can change it:
-flatall there are displayed full file/folder details like ID
(first parameter in line)
-flat
Please note, that in some phones (like N6230) content of some
folders (with more files) can be cut (only part of files will be
displayed) for example on infrared connection. This is not Gammu
issue, but phone firmware problem.
getfilesystemstatus
getfolderlisting folderID
Display files and folders available in folder with given folder
ID. You can get ID’s using getfilesystem -flatall.
Please note, that in some phones (like N6230) content of some
folders (with more files) can be cut (only part of files will be
displayed) for example on infrared connection. This is not Gammu
issue, but phone firmware problem.
getrootfolders
Display info about drives available in phone/memory card.
nokiaaddfile Gallery|Gallery2|Cam-
era|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name]
[-protected] [-readonly] [-system] [-hidden] [-newtime]
Install the *.jar/*.jad file pair of a midlet in the application
or game menu of the phone. You have to give the name without the
jar/jad suffix, otherwise you will get the slightly confusing
error message Can’t open specified file. Read only ?
The option -overwrite deletes the application’s .jad and .jar
files bevor installing, but doesn’t delete the application data.
Option -overwriteall will also delete all data. Both these
options work only for Application or Game upload.
Example: gammu nokiaaddfile Application Alien will read
Alien.JAD and Alien.JAR and add to Applications
Example: gammu nokiaaddfile Tones file.mid will read file.mid
and add to Tones folder
nokiaaddplaylists
sendfile name
setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]
Logo and pictures
copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]
Allow to convert logos files to another. When give ONLY input-
file, output will be written to stdout using ASCII art. When
give output file and format, in some file formats (like NLM)
will be set indicator informing about logo type to given.
getbitmap DEALER
In some models it’s possible to save dealer welcome note - text
displayed during enabling phone, which can’t be edited from
phone menu. Here you can get it.
getbitmap CALLER location [file]
Get caller group logo from phone. Locations 1-5.
getbitmap OPERATOR [file]
Get operator logo (picture displayed instead of operator name)
from phone.
getbitmap PICTURE location [file]
Get Picture Image from phone.
getbitmap STARTUP [file]
Get static startup logo from phone. Allow to save it in file.
savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read]
[-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
[-smscnumber number] [-reply] [-maxsms num]
savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num]
Save caller logo as sms (Nokia format - size 72x14).
savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-netcode netcode] [-biglogo]
Save operator logo as sms (Nokia format - size 72x14 or 78x21
after using -biglogo).
savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
Save Picture Image as sms (Nokia format - size 72x28).
sendsms ANIMATION destination frames file1 file2... [-report] [-valid-
ity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset
number] [-smscnumber number] [-reply] [-maxsms num]
sendsms CALLER destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms OPERATOR destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode]
[-biglogo]
sendsms PICTURE destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-uni-
code] [-alcatelbmmi]
setbitmap CALLER location [file]
Set caller logo.
setbitmap COLOUROPERATOR [fileID [netcode]]
setbitmap COLOURSTARTUP [fileID]
setbitmap DEALER text
setbitmap OPERATOR [file [netcode]]
Set operator logo in phone. When won’t give file and netcode,
operator logo will be removed from phone. When will give only
filename, operator logo will be displayed for your current GSM
operator. When give additionaly network code, it will be dis-
played for this operator: gammu setbitmap OPERATOR file "260 02"
setbitmap PICTURE file location [text]
setbitmap STARTUP file|1|2|3
Set startup logo in phone. It can be static (then you will have
to give file name) or one of predefined animated (only some
phones like Nokia 3310 or 3330 supports it)
setbitmap TEXT text
setbitmap WALLPAPER fileID
Ringtones
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
clearall
copyringtone source destination [RTTL|BINARY]
Copy source ringtone to destination.
getphoneringtone location [file]
Get one of "default" ringtones and saves into file
getringtone location [file]
Get ringtone from phone in RTTL or BINARY format. Locations are
numerated from 1.
getringtoneslist
nokiacomposer file
Show, how to enter RTTL ringtone in composer existing in many
Nokia phones (and how should it look like).
playringtone file
Play aproximation of ringtone over phone buzzer. File can be in
RTTL or BINARY (Nokia DCT3) format.
playsavedringtone number
Play one of "built" ringtones. This option is available for DCT4
phones. For getting ringtones list use getringtoneslist.
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-long] [-scale]
Read RTTL ringtone from file and save as SMS into SIM/phone mem-
ory. Ringtone is saved in Nokia format.
-folder number - save to specified folder. Numerate forlders
from 1. The most often folder 1 = "Inbox", 2 = "Outbox", etc.
-unread - makes message unread. In some phones (like 6210) you
won’t see unread sms envelope after saving such sms. In some
phones with internal SMS memory (like 6210) after using it with
folder 1 SIM SMS memory will be used
-read - makes message read. In some phones with internal SMS
memory (like 6210) after using it with folder 1 SIM SMS memory
will be used -unsent - makes message unsent
-reply - reply SMSC is set
-sender number - set sender number
-flash - Class 0 SMS
-smscset number - SMSC will be taken from set number. Default
set: 1
-smscnumber number - SMSC number
-long - ringtone is saved using Profile style. It can be longer
(and saved in 2 SMS), but decoded only by newer phones (like
33xx)
-scale - ringtone will have Scale info for each note. It will
allow to edit it correctly later in phone composer (for example,
in 33xx)
sendsms RINGTONE destination file [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
setringtone file [-location location] [-scale] [-name name]
Set ringtone in phone. When don’t give location, it will be
written "with preview" (in phones supporting this feature like
61xx or 6210). When use RTTL ringtones, give location and use
-scale, there will be written scale info with each note. It will
avoid scale problems available during editing ringtone in com-
poser from phone menu (for example, in N33xx).
TIP: when use ~ char in ringtone name, in some phones (like
33xx) name will blink later in phone menus
Calendar notes
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
clearall
deletecalendar start [stop]
getallcalendar
getcalendar start [stop]
getcalendarsettings
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
savefile CALENDAR target.vcs file location
savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
Read calendar note from file created by backup option and saves
in VCALENDAR 1.0 format as SMS
sendsms CALENDAR destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
To do lists
addcategory TODO|PHONEBOOK text
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
clearall
deletetodo start [stop]
getallcategory TODO|PHONEBOOK
getalltodo
getcategory TODO|PHONEBOOK start [stop]
gettodo start [stop]
listtodocategory text|number
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
savefile TODO target.vcs file location
savesms TODO file location [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
sendsms TODO destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
Notes
getallnotes
Date, time and alarms
getalarm [start]
Get alarm from phone, if no location is specified, 1 is used.
getdatetime
Get date and time from phone
setalarm hour minute
Sets repeating alarm in phone on selected time.
setdatetime [HH:MM[:SS]] [YYYY/MM/DD]
Set date and time in phone to date and time set in computer.
Please note, that this option doesn’t show clock on phone
screen. It only set date and time.
TIP: you can make such synchronization each time, when will con-
nect your phone and use Gammu. See gammurc for details.
Categories
addcategory TODO|PHONEBOOK text
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
clearall
getallcategory TODO|PHONEBOOK
getcategory TODO|PHONEBOOK start [stop]
listmemorycategory text|number
listtodocategory text|number
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
Backing up and restoring
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
addsms folder file
Adds SMSes from file (format like backupsms uses) to selected
folder in phone.
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
backupsms file
Stores all SMSes from phone to file.
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
restoresms file
Restores SMSes from file (format like backupsms uses) to
selected folder in phone. Please note that this overwrites
existing messages in phone (if it supports it).
savefile VCARD10|VCARD21 target.vcf file SM|ME location
savefile BOOKMARK target.url file location
savefile CALENDAR target.vcs file location
savefile TODO target.vcs file location
Nokia specific
nokiaaddfile Gallery|Gallery2|Cam-
era|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name]
[-protected] [-readonly] [-system] [-hidden] [-newtime]
Install the *.jar/*.jad file pair of a midlet in the application
or game menu of the phone. You have to give the name without the
jar/jad suffix, otherwise you will get the slightly confusing
error message Can’t open specified file. Read only ?
The option -overwrite deletes the application’s .jad and .jar
files bevor installing, but doesn’t delete the application data.
Option -overwriteall will also delete all data. Both these
options work only for Application or Game upload.
Example: gammu nokiaaddfile Application Alien will read
Alien.JAD and Alien.JAR and add to Applications
Example: gammu nokiaaddfile Tones file.mid will read file.mid
and add to Tones folder
nokiaaddplaylists
nokiacomposer file
Show, how to enter RTTL ringtone in composer existing in many
Nokia phones (and how should it look like).
nokiadebug filename [[v11-22] [,v33-44]...]
nokiadisplayoutput
nokiadisplaytest number
nokiagetadc
nokiagetoperatorname
6110.c phones have place for name for one GSM network (of
course, with flashing it’s possible to change all names, but
Gammu is not flasher ;-)). You can get this name using this
option.
nokiagetpbkfeatures memorytype
nokiagetscreendump
nokiagett9
nokiagetvoicerecord location
Get voice record from location and save to WAV file. File is
coded using GSM 6.10 codec (available for example in win32).
Name of file is like name of voice record in phone.
nokiamakecamerashoot
nokianetmonitor test
Takes output or set netmonitor for Nokia DCT3 phones.
TIP: For more info about this option, please visit
http://www.mwiacek.com and read netmonitor manual.
TIP: test 243 enables all tests (after using command gammu
nokianetmonitor 243 in some phones like 6210 or 9210 have to
reboot them to see netmonitor menu)
nokianetmonitor36
Reset counters from netmonitor test 36 in Nokia DCT3 phones.
TIP: For more info about this option, please visit
www.mwiacek.com and read netmonitor manual.
nokiasecuritycode
Get/reset to "12345" security code
nokiaselftests
nokiasetlights keypad|display|torch on|off
nokiasetoperatorname [networkcode name]
nokiasetphonemenus
Enable all (?) possible menus for DCT3 Nokia phones:
1. ALS (Alternative Line Service) option menu
2. vibra menu for 3210
3. 3315 features in 3310 5.45 and higher
4. two additional games (React and Logic) for 3210 5.31 and
higher
5. WellMate menu for 6150
6. NetMonitor
and for DCT4:
1. ALS (Alternative Line Service) option menu
2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
3. GPRS Always Online
nokiasetvibralevel level
Set vibra power to "level" (given in percent)
nokiatuneradio
nokiavibratest
Siemens specific
siemensnetmonact netmon_type (1-full, 2-simple)
siemensnetmonitor test
siemenssatnetmon
Network
getgprspoint start [stop]
listnetworks [country]
Show names/codes of GSM networks known for Gammu
monitor [times]
Get phone status and writes continuously to standard output.
Press Ctrl+C to break this state.
networkinfo
nokiadebug filename [[v11-22] [,v33-44]...]
nokiagetoperatorname
6110.c phones have place for name for one GSM network (of
course, with flashing it’s possible to change all names, but
Gammu is not flasher ;-)). You can get this name using this
option.
nokianetmonitor test
Takes output or set netmonitor for Nokia DCT3 phones.
TIP: For more info about this option, please visit
http://www.mwiacek.com and read netmonitor manual.
TIP: test 243 enables all tests (after using command gammu
nokianetmonitor 243 in some phones like 6210 or 9210 have to
reboot them to see netmonitor menu)
nokiasetoperatorname [networkcode name]
setautonetworklogin
siemensnetmonact netmon_type (1-full, 2-simple)
siemensnetmonitor test
siemenssatnetmon
WAP settings and bookmarks
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
clearall
deletewapbookmark start [stop]
Delete WAP bookmark(s) from phone. Locations are numerated from
1.
getchatsettings start [stop]
getsyncmlsettings start [stop]
getwapbookmark start [stop]
Get WAP bookmark(s) from phone. Locations are numerated from 1.
getwapsettings start [stop]
Get WAP settings from phone. Locations are numerated from 1.
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
savefile BOOKMARK target.url file location
savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
Read WAP bookmark from file created by backup option and saves
in Nokia format as SMS
savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
[-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
number] [-reply] [-maxsms num]
savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread]
[-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset
number] [-smscnumber number] [-reply] [-maxsms num]
Read WAP settings from file created by backup option and saves
in Nokia format as SMS
sendsms BOOKMARK destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms WAPINDICATOR destination URL Title [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms WAPSETTINGS destination file location DATA|GPRS [-report]
[-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]
[-smscset number] [-smscnumber number] [-reply] [-maxsms num]
MMS and MMS settings
getallmms [-save]
geteachmms [-save]
getmmsfolders
getmmssettings start [stop]
readmmsfile file [-save]
savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read]
[-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
[-smscnumber number] [-reply] [-maxsms num]
savesms MMSSETTINGS file location [-folder id] [-unread] [-read]
[-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
[-smscnumber number] [-reply] [-maxsms num]
sendsms MMSINDICATOR destination URL Title Sender [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
sendsms MMSSETTINGS destination file location [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num]
Phone tests
nokiadisplaytest number
nokiagetadc
nokiaselftests
nokiasetlights keypad|display|torch on|off
nokiavibratest
FM radio
addnew file [-yes]
Adds settings written in file created using backup option. All
things backup’ed by backup can be restored (when made backup to
Gammu text file).
backup file [-yes]
Backup your phone to file. It’s possible to backup (depends on
phone):
* phonebook from SIM and phone memory
* calendar notes
* SMSC settings
* operator logo
* startup (static) logo or startup text
* WAP bookmarks
* WAP settings
* caller logos and groups
* user ringtones BSLen use text backup files. List can be
extended on request.
TIP: if you will backup settings to Gammu text file, it will be
possible to edit it. It’s easy: many things in this file will be
written double - once in Unicode, once in ASCII. When you will
remove Unicode version Gammu will use ASCII on restore (and you
can easy edit ASCII text) and will convert it according to your
OS locale. When will be available Unicode version of text, it
will be used instead of ASCII (usefull with Unicode phones - it
isn’t important, what locale is set in computer and no conver-
sion Unicode -> ASCII and ASCII -> Unicode is done).
TIP: you can use any editor with regular expressions function to
edit backup text file. Example: TextPad 4.2.2 from
http://www.textpad.com/ with regular expressions based on POSIX
standard P1003.2 is OK for it. Few examples for it:
* to remove info about voice tags:
FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
TO:
* to change all numbers starting from +3620, +3630, +3660, +3670
to +3620
Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\(20\|30\|60\|70\)
Repl: Type = NumberMobile\nEntry\1Text = "\+3620
* to change phone numbers type to mobile for numbers starting
from +3620, +3630,... and removing the corresponding TextUnicode
line
F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
"\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
\([^\n]*\)\n
R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
clearall
getfmstation start [stop]
Show info about FM stations in phone
nokiatuneradio
restore file [-yes]
Restore settings written in file created using backup option.
All things backup’ed by backup can be restored (when made backup
to Gammu text file).
Please note that restoring deletes all current content in phone.
If you want only to add entries to phone, use addnew.
In some phones restoring calendar notes will not show error, but
won’t be done, when phone doesn’t have set clock inside.
Phone information
getdisplaystatus
getsecuritystatus
Show, if phone wait for security code (like PIN, PUK, etc.) or
not
identify
Show the most important phone data.
monitor [times]
Get phone status and writes continuously to standard output.
Press Ctrl+C to break this state.
nokiasecuritycode
Get/reset to "12345" security code
Phone settings
getcalendarsettings
getprofile start [stop]
resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
Reset phone settings. BE CAREFULL !!!!
PHONE:
DEV:
ALL: Clear user settings
* removes or set logos to default
* set default phonebook and other menu settings
* clear T9 words,
* clear call register info
* set default profiles settings
* clear user ringtones
UIF:
* changes like after ALL
* disables netmon and PPS (all "hidden" menus)
FACTORY:
* changes like after UIF
* clear date/time
savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ring-
tone]
Read ringtone (RTTL) format and bitmap (Picture Image size) and
name and save as Nokia profile.
sendsms PROFILE destination [-report] [-validity
HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num-
ber] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap
bitmap] [-ringtone ringtone]
Dumps decoding
decodebinarydump file [phonemodel]
After using option logfile with name binary (see /readme.txt for
info about this method of reporting bugs) created file can be
decoded using this option. It’s available only, if Gammu was
compiled with debug.
decodesniff MBUS2|IRDA file [phonemodel]
Option available only, if Gammu was compiled with debug. Allows
to decode sniffs. See /docs/develop/develop.txt for more
details.
makeconverttable file
Functions that don’t fit elsewhere
batch [file]
entersecuritycode PIN|PUK|PIN2|PUK2 code
Allow to enter security code from PC
nokiagetscreendump
nokiagetvoicerecord location
Get voice record from location and save to WAV file. File is
coded using GSM 6.10 codec (available for example in win32).
Name of file is like name of voice record in phone.
nokiamakecamerashoot
nokiasetphonemenus
Enable all (?) possible menus for DCT3 Nokia phones:
1. ALS (Alternative Line Service) option menu
2. vibra menu for 3210
3. 3315 features in 3310 5.45 and higher
4. two additional games (React and Logic) for 3210 5.31 and
higher
5. WellMate menu for 6150
6. NetMonitor
and for DCT4:
1. ALS (Alternative Line Service) option menu
2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
3. GPRS Always Online
nokiasetvibralevel level
Set vibra power to "level" (given in percent)
presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
Press specified key sequence on phone keyboard
mM - Menu
nN - Names key
pP - Power
uU - Up
dD - Down
+- - +-
gG - Green
rR - Red
123456789*0# is numeric keyboard
reset SOFT|HARD
Make phone reset: soft (without asking for PIN) or hard (with
PIN).
Note: some phones will make hard reset even with SOFT option.
searchphone [-debug]
Gammu information
features
help Output help information and exit.
version
Output version information and exit.
SMS daemon
sendsmsdsms TEXT|WAPSETTINGS|... destination FILES|MYSQL|PGSQL config-
file ... (options like in sendsms)
smsd FILES configfile
SMS Deaemon. See smsdrc config file for more options
smsd MYSQL configfile
smsd PGSQL configfile
FILES
~/.gammurc
/usr/share/doc/gammu/*
/dev/ircomm?
/dev/ttyS?
/dev/ttyACM?
EXAMPLES
To check it out, edit ~/.gammurc and put there something like
[gammu]
port = /dev/ttyACM0
connection = at
Save text message up to standard 160 chars:
echo "All your base are belong to us" | gammu savesms TEXT
Save long text message:
echo "All your base are belong to us" | gammu savesms TEXT
-maxlen 400
gammu savesms EMS -text "All your base are belong to us"
Save some funky message with predefined sound and animation from 2
bitmaps:
gammu savesms EMS -text "Greetings" -defsound 1 -text "from
Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
Save protected message with ringtone:
gammu savesms EMS -protected 2 -variablebitmaplong ala.bmp
-toneSElong axelf.txt -toneSE ring.txt
LICENSE
This program is licensed under GNU/GPL version 2.
BUGS
There are definitely many bugs, reporting to author is welcome. Please
include some useful information when sending bug reports (especially
debug logs, operating system, it’s version and phone information are
needed).
To generate debug log, either enable in gammurc (alternatively you can
do it on command line, but gammurc way allows separating debug log from
other output):
logfile = /tmp/gammu.log
logformat = textall
With this settings, Gammu generates /tmp/gammu.log on each connection
to phone and stores dump of communication there. You can also find some
hints for improving support for your phone in this log.
AUTHORS
You can contact authors on <gammu-users@lists.sourceforge.net>.
Michal Cihar <michal@cihar.com> is current project maintainer and con-
tributor of most of AT and OBEX code.
Marcin Wiacek <marcin@mwiacek.com> is project iniciator and contributor
of most Nokia code.
As this project grew from Gnokii, we would like to thanks all Gnokii
developers, especially Pavel Janik, Pawel Kot and Manfred Jonsson (see
CREDITS from Gnokii for all their contributor).
Many other people have helped with various features, check ChangeLog
for more details.
SEE ALSO
README
<http://www.gammu.org/> contains wiki with more user hints and further
documentation
cu(1)
gnokii(1)
wammu(1)
gmobilemedia(1)
Gammu 1.13.91 Sep 12 2007 GAMMU(1)
