1GAMMU(1) Gammu Documentation GAMMU(1)
2
6 Gammu - Does some neat things with your cellular phone or modem.
7
10 Usage: gammu [confign] [nothing|text|textall|binary|errors] <command>
11 [options]
12
16 This program is a tool for mobile phones. Many vendors and phones are
17 supported, for actual listing see <http://cihar.com/gammu/phonedb/>.
18
22 First parameter optionally specifies which config section to use (all
23 are probed by default). Second parameter optionally controls debug
24 level, next one specifies actions.
25 Commands can be specified with or without leading --.
28 Debug levels
32 Parameters, which allow to control debug level:
33 nothing - no debug level
35 text - transmission dump in text format
36 textall - all possible info in text format
37 errors - errors in text format
38 binary - transmission dump in binary format
39 SMS and EMS
43 Sending messages might look a bit complicated on first attempt to use.
44 But be patient, the command line has been written in order to allow
45 almost every usage. See EXAMPLES section for some hints on usage.
46 addsms folder file
49 Adds SMSes from file (format like backupsms uses) to selected
50 folder in phone.
51 addsmsfolder name
53 backupsms file
56 Stores all SMSes from phone to file.
57 deleteallsms folder
59 Delete all SMS from specified SMS folder.
60 deletesms folder start [stop]
63 Delete SMS from phone. See description for getsms for info about
64 sms folders naming convention. Locations are numerated from 1.
65 displaysms ... (options like in sendsms)
68 getallsms -pbk
71 Get all SMS from phone. In some phones you will have also SMS
72 templates and info about locations used to save Picture Images.
73 With each sms you will see location. If you want to get such sms
74 from phone alone, use gammu getsms 0 location
75 geteachsms -pbk
78 Similiary to getallsms. Difference is, that links all contace‐
79 nated sms
80 getsms folder start [stop]
83 Get SMS. Locations are numerated from 1.
84 When give folder 0, sms is given from "flat" memory (all sms
86 from all folders have unique numbers). It's sometimes emulated
87 by Gammu. You can use it with all phones.
88 When give folder 1, 2, etc. sms are taken from Inbox, Outbox,
90 etc. and each sms has unique number in his folder. Name of
91 folders can depend on your phone (the most often 1="Inbox",
92 2="Outbox", etc.). This method is not supported by all phones
93 (for example, not supported by Nokia 3310, 5110, 6110). If work
94 with your phone, use getsmsfolders to get folders list.
95 getsmsc [start [stop]]
98 Get SMSC settings from SIM card. Numerate locations from 1.
99 getsmsfolders
102 Get names for SMS folders in phone
103 nokiagett9
106 restoresms file
109 Restores SMSes from file (format like backupsms uses) to
110 selected folder in phone. Please note that this overwrites
111 existing messages in phone (if it supports it).
112 savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id]
114 [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name]
115 [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
116 Read phonebook entry from file created by backup option and
117 saves in VCARD 1.0 (only name and default number) or VCARD 2.1
118 (all entry details with all numbers, text and name) format as
119 SMS
120 savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read]
123 [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
124 [-smscnumber number] [-reply] [-maxsms num]
125 savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
128 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
129 number] [-reply] [-maxsms num]
130 Read WAP bookmark from file created by backup option and saves
131 in Nokia format as SMS
132 savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
135 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
136 number] [-reply] [-maxsms num]
137 Read calendar note from file created by backup option and saves
138 in VCALENDAR 1.0 format as SMS
139 savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent]
142 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
143 [-reply] [-maxsms num]
144 Save caller logo as sms (Nokia format - size 72x14).
145 savesms EMS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
148 number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
149 [-maxsms num] [-unicode] [-16bit] [-format lcrasbiut] [-text text]
150 [-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10
151 file] [-tone10long file] [-tone12 file] [-tone12long file] [-toneSE
152 file] [-toneSElong file] [-fixedbitmap file] [-variablebitmap file]
153 [-variablebitmaplong file] [-animation frames file1 ...] [-protected
154 number]
155 Saves EMS sequence. All parameters after -unread (like -def‐
157 sound) can be used few times.
158 -text - adds text
160 -unicodefiletext - adds text from Unicode file
162 -defanimation - adds default animation with ID specified by
164 user.ID for different phones are different.
165 -animation - adds "frames" frames read from file1, file2, etc.
167 -defsound - adds default sound with ID specified by user. ID for
169 different phones are different.
170 -tone10 - adds IMelody version 1.0 read from RTTL or other com‐
172 patible file
173 -tone10long - IMelody version 1.0 saved in one of few SMS with
175 UPI. Phones compatible with UPI (like SonyEricsson phones) will
176 read such ringtone as one
177 -tone12 - adds IMelody version 1.2 read from RTTL or other com‐
179 patible file
180 -tone12long - IMelody version 1.0 saved in one of few SMS with
182 UPI. Phones compatible with UPI (like SonyEricsson phones) will
183 read such ringtone as one
184 -toneSE - adds IMelody in "short" form supported by SonyEricsson
186 phones
187 -tone10long - SonyEricsson IMelody saved in one or few SMS with
189 UPI
190 -variablebitmap - bitmap in any size saved in one SMS
192 -variablebitmaplong - bitmap with maximal size 96x128 saved in
194 one or few sms
195 -fixedbitmap - bitmap 16x16 or 32x32
197 -protected - all ringtones and bitmaps after this parameter
199 (excluding default ringtones and logos) will be "protected" (in
200 phones compatible with ODI like SonyEricsson products it won't
201 be possible to forward them from phone menu)
202 Example: gammu savesms EMS -text "Greetings" -defsound 1 -text
204 "from Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
205 will create EMS sequence with text "Greetings" and default sound
207 1 and text "from Gammu" and ringtone axelf.txt and 2 frame ani‐
208 mation read from (1'st frame) file1.bmp and (2'nd frame)
209 file2.bmp
210 Example: gammu savesms EMS -protected 2 -variablebitmaplong
212 ala.bmp -toneSElong axelf.txt -toneSE ring.txt
213 ala.bmp and axelf.txt will be "protected"
215 savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read]
218 [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
219 [-smscnumber number] [-reply] [-maxsms num]
220 savesms MMSSETTINGS file location [-folder id] [-unread] [-read]
223 [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
224 [-smscnumber number] [-reply] [-maxsms num]
225 savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent]
228 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
229 [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
230 Save operator logo as sms (Nokia format - size 72x14 or 78x21
231 after using -biglogo).
232 savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent]
235 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
236 [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
237 Save Picture Image as sms (Nokia format - size 72x28).
238 savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent]
241 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
242 [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ring‐
243 tone]
244 Read ringtone (RTTL) format and bitmap (Picture Image size) and
245 name and save as Nokia profile.
246 savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
249 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
250 [-reply] [-maxsms num] [-long] [-scale]
251 Read RTTL ringtone from file and save as SMS into SIM/phone mem‐
252 ory. Ringtone is saved in Nokia format.
253 -folder number - save to specified folder. Numerate forlders
255 from 1. The most often folder 1 = "Inbox", 2 = "Outbox", etc.
256 -unread - makes message unread. In some phones (like 6210) you
258 won't see unread sms envelope after saving such sms. In some
259 phones with internal SMS memory (like 6210) after using it with
260 folder 1 SIM SMS memory will be used
261 -read - makes message read. In some phones with internal SMS
263 memory (like 6210) after using it with folder 1 SIM SMS memory
264 will be used -unsent - makes message unsent
265 -reply - reply SMSC is set
267 -sender number - set sender number
269 -flash - Class 0 SMS
271 -smscset number - SMSC will be taken from set number. Default
273 set: 1
274 -smscnumber number - SMSC number
276 -long - ringtone is saved using Profile style. It can be longer
278 (and saved in 2 SMS), but decoded only by newer phones (like
279 33xx)
280 -scale - ringtone will have Scale info for each note. It will
282 allow to edit it correctly later in phone composer (for example,
283 in 33xx)
284 savesms SMSTEMPLATE [-folder id] [-unread] [-read] [-unsent] [-sent]
287 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
288 [-reply] [-maxsms num] [-unicode] [-text text] [-unicodefiletext file]
289 [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file]
290 [-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file]
291 [-variablebitmap file] [-variablebitmaplong file] [-animation frames
292 file1 ...]
293 savesms TEXT [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
296 number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
297 [-maxsms num] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen
298 len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disable‐
299 fax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID]
300 [-replacefile file]
301 Take text from stdin and save as text SMS into SIM/phone memory.
302 -folder number - save to specified folder. Numerate folders from
304 1. The most often folder 1 = "Inbox", 2 = "Outbox",etc. Use
305 getsmsfolders to get folder list.
306 -unread - makes message unread. In some phones (like 6210) you
308 won't see unread sms envelope after saving such sms. In some
309 phones with internal SMS memory (like 6210) after using it with
310 folder 1 SIM SMS memory will be used
311 -read - makes message read. In some phones with internal SMS
313 memory (like 6210) after using it with folder 1 SIM SMS memory
314 will be used
315 -unsent - makes message unsent
317 -reply - reply SMSC is set
319 -sender number - set sender number (default: "Gammu")
321 -flash - Class 0 SMS
323 -smscset number - SMSC will be taken from set number. Default
325 set: 1
326 -smscnumber number - SMSC number
328 -len len - specify, how many chars will be read. When use this
330 option and text will be longer than 1 SMS, will be splitted into
331 more linked SMS
332 -autolen len - specify, how many chars will be read. When use
334 this option and text will be longer than 1 SMS, will be splitted
335 into more linked SMS.Coding type (SMS default alphabet/Unicode)
336 is set according to input text
337 -enablevoice | -disablevoice | -enablefax | -disablefax |
339 -enableemail | -disableemail - sms will set such indicators.
340 Text will be cut to 1 sms.
341 -voidsms - many phones after receiving it won't display any‐
343 thing, only beep, vibrate or turn on light. Text will be cut to
344 1 sms.
345 -unicode - SMS will be saved in Unicode format
347 -inputunicode - input text is in Unicode.
349 TIP: You can create Unicode file using WordPad in Win32 (during
351 saving select "Unicode Text Document" format). In Unix can use
352 for example YUdit.
353 -replacemessages ID - ID can be 1..7. When you will use option
355 and send more single SMS to one recipient with the same ID, each
356 another SMS will replace each previous with the same ID
357 -replacefile file - when you want, you can make file in such
359 format: src_unicode_char1,dest_unicode_char1,src_uni‐
360 code_char2,dest_unicode_char2 (everything in one line). After
361 reading text for SMS from stdin there will be made translation
362 and each src char will be converted to dest char. In docs there
363 is example file (replace.txt), which will change all "a" chars
364 to "1"
365 TIP: when use ~ char in sms text and -unicode option (Unicode
367 coding required), text of sms after ~ char will blink in some
368 phones (like N33xx)
369 Example: echo some_text | gammu savesms TEXT
371 savesms TODO file location [-folder id] [-unread] [-read] [-unsent]
374 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
375 number] [-reply] [-maxsms num]
376 savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
379 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
380 number] [-reply] [-maxsms num]
381 savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread]
384 [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset
385 number] [-smscnumber number] [-reply] [-maxsms num]
386 Read WAP settings from file created by backup option and saves
387 in Nokia format as SMS
388 sendsms VCARD10|VCARD21 destination file SM|ME location [-nokia]
391 [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder
392 number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
393 sendsms ANIMATION destination frames file1 file2... [-report] [-valid‐
396 ity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset
397 number] [-smscnumber number] [-reply] [-maxsms num]
398 sendsms BOOKMARK destination file location [-report] [-validity
401 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
402 ber] [-smscnumber number] [-reply] [-maxsms num]
403 sendsms CALENDAR destination file location [-report] [-validity
406 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
407 ber] [-smscnumber number] [-reply] [-maxsms num]
408 sendsms CALLER destination file [-report] [-validity
411 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
412 ber] [-smscnumber number] [-reply] [-maxsms num]
413 sendsms EMS destination [-report] [-validity
416 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
417 ber] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-16bit]
418 [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID]
419 [-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file]
420 [-tone12long file] [-toneSE file] [-toneSElong file] [-fixedbitmap
421 file] [-variablebitmap file] [-variablebitmaplong file] [-animation
422 frames file1 ...] [-protected number]
423 sendsms MMSINDICATOR destination URL Title Sender [-report] [-validity
426 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
427 ber] [-smscnumber number] [-reply] [-maxsms num]
428 sendsms MMSSETTINGS destination file location [-report] [-validity
431 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
432 ber] [-smscnumber number] [-reply] [-maxsms num]
433 sendsms OPERATOR destination file [-report] [-validity
436 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
437 ber] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode]
438 [-biglogo]
439 sendsms PICTURE destination file [-report] [-validity
442 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
443 ber] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-uni‐
444 code] [-alcatelbmmi]
445 sendsms PROFILE destination [-report] [-validity
448 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
449 ber] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap
450 bitmap] [-ringtone ringtone]
451 sendsms RINGTONE destination file [-report] [-validity
454 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
455 ber] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
456 sendsms SMSTEMPLATE destination [-report] [-validity
459 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
460 ber] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-text
461 text] [-unicodefiletext file] [-defsound ID] [-defanimation ID]
462 [-tone10 file] [-tone10long file] [-tone12 file] [-tone12long file]
463 [-toneSE file] [-toneSElong file] [-variablebitmap file] [-vari‐
464 ablebitmaplong file] [-animation frames file1 ...]
465 sendsms TEXT destination [-report] [-validity
468 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
469 ber] [-smscnumber number] [-reply] [-maxsms num] [-inputunicode]
470 [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice]
471 [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-dis‐
472 ableemail] [-voidsms] [-replacemessages ID] [-replacefile file]
473 sendsms TODO destination file location [-report] [-validity
476 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
477 ber] [-smscnumber number] [-reply] [-maxsms num]
478 sendsms WAPINDICATOR destination URL Title [-report] [-validity
481 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
482 ber] [-smscnumber number] [-reply] [-maxsms num]
483 sendsms WAPSETTINGS destination file location DATA|GPRS [-report]
486 [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]
487 [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
488 sendsmsdsms TEXT|WAPSETTINGS|... destination FILES|MYSQL|PGSQL config‐
491 file ... (options like in sendsms)
492 smsd FILES configfile
495 SMS Deaemon. See smsdrc config file for more options
496 smsd MYSQL configfile
499 smsd PGSQL configfile
502 Memory (phonebooks and calls)
506 addcategory TODO|PHONEBOOK text
507 addnew file [-yes]
510 Adds settings written in file created using backup option. All
511 things backup'ed by backup can be restored (when made backup to
512 Gammu text file).
513 backup file [-yes]
516 Backup your phone to file. It's possible to backup (depends on
517 phone):
518 * phonebook from SIM and phone memory
520 * calendar notes
521 * SMSC settings
522 * operator logo
523 * startup (static) logo or startup text
524 * WAP bookmarks
525 * WAP settings
526 * caller logos and groups
527 * user ringtones BSLen use text backup files. List can be
528 extended on request.
529 TIP: if you will backup settings to Gammu text file, it will be
531 possible to edit it. It's easy: many things in this file will be
532 written double - once in Unicode, once in ASCII. When you will
533 remove Unicode version Gammu will use ASCII on restore (and you
534 can easy edit ASCII text) and will convert it according to your
535 OS locale. When will be available Unicode version of text, it
536 will be used instead of ASCII (usefull with Unicode phones - it
537 isn't important, what locale is set in computer and no conver‐
538 sion Unicode -> ASCII and ASCII -> Unicode is done).
539 TIP: you can use any editor with regular expressions function to
541 edit backup text file. Example: TextPad 4.2.2 from
542 http://www.textpad.com/ with regular expressions based on POSIX
543 standard P1003.2 is OK for it. Few examples for it:
544 * to remove info about voice tags:
546 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
547 TO:
548 * to change all numbers starting from +3620, +3630, +3660, +3670
550 to +3620
551 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
552 "\+36\(20\|30\|60\|70\)
553 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
554 * to change phone numbers type to mobile for numbers starting
556 from +3620, +3630,... and removing the corresponding TextUnicode
557 line
558 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
559 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
560 \([^\n]*\)\n
561 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
562 clearall
565 deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]
568 getallcategory TODO|PHONEBOOK
571 getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
574 getcategory TODO|PHONEBOOK start [stop]
577 getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]
580 Get memory location from phone. Numerate locations from 1.
581 DC = Dialled calls
583 MC = Missed calls
584 RC = Received calls
585 ON = Own numbers
586 VM = voice mailbox
587 SM = SIM phonebook
588 ME = phone internal phonebook
589 FD = fixed dialling
590 SL = sent SMS log
591 getspeeddial start [stop]
594 listmemorycategory text|number
597 nokiagetpbkfeatures memorytype
600 restore file [-yes]
603 Restore settings written in file created using backup option.
604 All things backup'ed by backup can be restored (when made backup
605 to Gammu text file).
606 Please note that restoring deletes all current content in phone.
608 If you want only to add entries to phone, use addnew.
609 In some phones restoring calendar notes will not show error, but
611 won't be done, when phone doesn't have set clock inside.
612 savefile VCARD10|VCARD21 target.vcf file SM|ME location
615 savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id]
618 [-unread] [-read] [-unsent] [-sent] [-sender number] [-smsname name]
619 [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
620 Read phonebook entry from file created by backup option and
621 saves in VCARD 1.0 (only name and default number) or VCARD 2.1
622 (all entry details with all numbers, text and name) format as
623 SMS
624 searchmemory text
627 sendsms VCARD10|VCARD21 destination file SM|ME location [-nokia]
630 [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder
631 number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
632 Filesystem
636 addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT]
637 [-readonly] [-protected] [-system] [-hidden] [-newtime]
638 Add file with specified name to folder with specified folder ID.
639 -type - file type was required for filesystem 1 in Nokia phones
641 (current filesystem 2 doesn't need this)
642 -readonly, -protected, -system, -hidden - you can set readonly,
644 protected (file can't be for example forwarded from phone menu),
645 system and hidden (file is hidden from phone menu) file
646 attributes
647 -newtime - after using it date/time of file modification will be
649 set to moment of uploading
650 addfolder parentfolderID name
654 deletefiles fileID
657 deletefolder name
660 getfilefolder ID1, ID2, ...
663 getfiles ID1, ID2, ...
666 getfilesystem [-flatall|-flat]
669 Display info about all folders and files in phone memory/memory
670 card. By default there is tree displayed, you can change it:
671 -flatall there are displayed full file/folder details like ID
673 (first parameter in line)
674 -flat
676 Please note, that in some phones (like N6230) content of some
678 folders (with more files) can be cut (only part of files will be
679 displayed) for example on infrared connection. This is not Gammu
680 issue, but phone firmware problem.
681 getfilesystemstatus
684 getfolderlisting folderID
687 Display files and folders available in folder with given folder
689 ID. You can get ID's using getfilesystem -flatall.
690 Please note, that in some phones (like N6230) content of some
692 folders (with more files) can be cut (only part of files will be
693 displayed) for example on infrared connection. This is not Gammu
694 issue, but phone firmware problem.
695 getrootfolders
698 Display info about drives available in phone/memory card.
700 nokiaaddfile Gallery|Gallery2|Cam‐
703 era|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name]
704 [-protected] [-readonly] [-system] [-hidden] [-newtime]
705 Install the *.jar/*.jad file pair of a midlet in the application
706 or game menu of the phone. You have to give the name without the
707 jar/jad suffix, otherwise you will get the slightly confusing
708 error message Can't open specified file. Read only ?
709 The option -overwrite deletes the application's .jad and .jar
711 files bevor installing, but doesn't delete the application data.
712 Option -overwriteall will also delete all data. Both these
713 options work only for Application or Game upload.
714 Example: gammu nokiaaddfile Application Alien will read
716 Alien.JAD and Alien.JAR and add to Applications
717 Example: gammu nokiaaddfile Tones file.mid will read file.mid
719 and add to Tones folder
720 nokiaaddplaylists
723 sendfile name
726 setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]
729 Logo and pictures
733 copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]
734 Allow to convert logos files to another. When give ONLY input‐
735 file, output will be written to stdout using ASCII art. When
736 give output file and format, in some file formats (like NLM)
737 will be set indicator informing about logo type to given.
738 getbitmap DEALER
741 In some models it's possible to save dealer welcome note - text
742 displayed during enabling phone, which can't be edited from
743 phone menu. Here you can get it.
744 getbitmap CALLER location [file]
747 Get caller group logo from phone. Locations 1-5.
748 getbitmap OPERATOR [file]
751 Get operator logo (picture displayed instead of operator name)
752 from phone.
753 getbitmap PICTURE location [file]
756 Get Picture Image from phone.
757 getbitmap STARTUP [file]
760 Get static startup logo from phone. Allow to save it in file.
761 savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read]
764 [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
765 [-smscnumber number] [-reply] [-maxsms num]
766 savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent]
769 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
770 [-reply] [-maxsms num]
771 Save caller logo as sms (Nokia format - size 72x14).
772 savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent]
775 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
776 [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
777 Save operator logo as sms (Nokia format - size 72x14 or 78x21
778 after using -biglogo).
779 savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent]
782 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
783 [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
784 Save Picture Image as sms (Nokia format - size 72x28).
785 sendsms ANIMATION destination frames file1 file2... [-report] [-valid‐
788 ity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset
789 number] [-smscnumber number] [-reply] [-maxsms num]
790 sendsms CALLER destination file [-report] [-validity
793 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
794 ber] [-smscnumber number] [-reply] [-maxsms num]
795 sendsms OPERATOR destination file [-report] [-validity
798 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
799 ber] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode]
800 [-biglogo]
801 sendsms PICTURE destination file [-report] [-validity
804 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
805 ber] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-uni‐
806 code] [-alcatelbmmi]
807 setbitmap CALLER location [file]
810 Set caller logo.
811 setbitmap COLOUROPERATOR [fileID [netcode]]
814 setbitmap COLOURSTARTUP [fileID]
817 setbitmap DEALER text
820 setbitmap OPERATOR [file [netcode]]
823 Set operator logo in phone. When won't give file and netcode,
824 operator logo will be removed from phone. When will give only
825 filename, operator logo will be displayed for your current GSM
826 operator. When give additionaly network code, it will be dis‐
827 played for this operator: gammu setbitmap OPERATOR file "260 02"
828 setbitmap PICTURE file location [text]
831 setbitmap STARTUP file|1|2|3
834 Set startup logo in phone. It can be static (then you will have
835 to give file name) or one of predefined animated (only some
836 phones like Nokia 3310 or 3330 supports it)
837 setbitmap TEXT text
840 setbitmap WALLPAPER fileID
843 Ringtones
847 addnew file [-yes]
848 Adds settings written in file created using backup option. All
849 things backup'ed by backup can be restored (when made backup to
850 Gammu text file).
851 backup file [-yes]
854 Backup your phone to file. It's possible to backup (depends on
855 phone):
856 * phonebook from SIM and phone memory
858 * calendar notes
859 * SMSC settings
860 * operator logo
861 * startup (static) logo or startup text
862 * WAP bookmarks
863 * WAP settings
864 * caller logos and groups
865 * user ringtones BSLen use text backup files. List can be
866 extended on request.
867 TIP: if you will backup settings to Gammu text file, it will be
869 possible to edit it. It's easy: many things in this file will be
870 written double - once in Unicode, once in ASCII. When you will
871 remove Unicode version Gammu will use ASCII on restore (and you
872 can easy edit ASCII text) and will convert it according to your
873 OS locale. When will be available Unicode version of text, it
874 will be used instead of ASCII (usefull with Unicode phones - it
875 isn't important, what locale is set in computer and no conver‐
876 sion Unicode -> ASCII and ASCII -> Unicode is done).
877 TIP: you can use any editor with regular expressions function to
879 edit backup text file. Example: TextPad 4.2.2 from
880 http://www.textpad.com/ with regular expressions based on POSIX
881 standard P1003.2 is OK for it. Few examples for it:
882 * to remove info about voice tags:
884 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
885 TO:
886 * to change all numbers starting from +3620, +3630, +3660, +3670
888 to +3620
889 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
890 "\+36\(20\|30\|60\|70\)
891 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
892 * to change phone numbers type to mobile for numbers starting
894 from +3620, +3630,... and removing the corresponding TextUnicode
895 line
896 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
897 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
898 \([^\n]*\)\n
899 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
900 clearall
903 copyringtone source destination [RTTL|BINARY]
906 Copy source ringtone to destination.
907 getphoneringtone location [file]
910 Get one of "default" ringtones and saves into file
912 getringtone location [file]
915 Get ringtone from phone in RTTL or BINARY format. Locations are
916 numerated from 1.
917 getringtoneslist
920 nokiacomposer file
923 Show, how to enter RTTL ringtone in composer existing in many
924 Nokia phones (and how should it look like).
925 playringtone file
928 Play aproximation of ringtone over phone buzzer. File can be in
929 RTTL or BINARY (Nokia DCT3) format.
930 playsavedringtone number
933 Play one of "built" ringtones. This option is available for DCT4
935 phones. For getting ringtones list use getringtoneslist.
936 restore file [-yes]
939 Restore settings written in file created using backup option.
940 All things backup'ed by backup can be restored (when made backup
941 to Gammu text file).
942 Please note that restoring deletes all current content in phone.
944 If you want only to add entries to phone, use addnew.
945 In some phones restoring calendar notes will not show error, but
947 won't be done, when phone doesn't have set clock inside.
948 savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
951 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
952 [-reply] [-maxsms num] [-long] [-scale]
953 Read RTTL ringtone from file and save as SMS into SIM/phone mem‐
954 ory. Ringtone is saved in Nokia format.
955 -folder number - save to specified folder. Numerate forlders
957 from 1. The most often folder 1 = "Inbox", 2 = "Outbox", etc.
958 -unread - makes message unread. In some phones (like 6210) you
960 won't see unread sms envelope after saving such sms. In some
961 phones with internal SMS memory (like 6210) after using it with
962 folder 1 SIM SMS memory will be used
963 -read - makes message read. In some phones with internal SMS
965 memory (like 6210) after using it with folder 1 SIM SMS memory
966 will be used -unsent - makes message unsent
967 -reply - reply SMSC is set
969 -sender number - set sender number
971 -flash - Class 0 SMS
973 -smscset number - SMSC will be taken from set number. Default
975 set: 1
976 -smscnumber number - SMSC number
978 -long - ringtone is saved using Profile style. It can be longer
980 (and saved in 2 SMS), but decoded only by newer phones (like
981 33xx)
982 -scale - ringtone will have Scale info for each note. It will
984 allow to edit it correctly later in phone composer (for example,
985 in 33xx)
986 sendsms RINGTONE destination file [-report] [-validity
989 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
990 ber] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
991 setringtone file [-location location] [-scale] [-name name]
994 Set ringtone in phone. When don't give location, it will be
995 written "with preview" (in phones supporting this feature like
996 61xx or 6210). When use RTTL ringtones, give location and use
997 -scale, there will be written scale info with each note. It will
998 avoid scale problems available during editing ringtone in com‐
999 poser from phone menu (for example, in N33xx).
1000 TIP: when use ~ char in ringtone name, in some phones (like
1002 33xx) name will blink later in phone menus
1003 Calendar notes
1007 addnew file [-yes]
1008 Adds settings written in file created using backup option. All
1009 things backup'ed by backup can be restored (when made backup to
1010 Gammu text file).
1011 backup file [-yes]
1014 Backup your phone to file. It's possible to backup (depends on
1015 phone):
1016 * phonebook from SIM and phone memory
1018 * calendar notes
1019 * SMSC settings
1020 * operator logo
1021 * startup (static) logo or startup text
1022 * WAP bookmarks
1023 * WAP settings
1024 * caller logos and groups
1025 * user ringtones BSLen use text backup files. List can be
1026 extended on request.
1027 TIP: if you will backup settings to Gammu text file, it will be
1029 possible to edit it. It's easy: many things in this file will be
1030 written double - once in Unicode, once in ASCII. When you will
1031 remove Unicode version Gammu will use ASCII on restore (and you
1032 can easy edit ASCII text) and will convert it according to your
1033 OS locale. When will be available Unicode version of text, it
1034 will be used instead of ASCII (usefull with Unicode phones - it
1035 isn't important, what locale is set in computer and no conver‐
1036 sion Unicode -> ASCII and ASCII -> Unicode is done).
1037 TIP: you can use any editor with regular expressions function to
1039 edit backup text file. Example: TextPad 4.2.2 from
1040 http://www.textpad.com/ with regular expressions based on POSIX
1041 standard P1003.2 is OK for it. Few examples for it:
1042 * to remove info about voice tags:
1044 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
1045 TO:
1046 * to change all numbers starting from +3620, +3630, +3660, +3670
1048 to +3620
1049 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1050 "\+36\(20\|30\|60\|70\)
1051 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
1052 * to change phone numbers type to mobile for numbers starting
1054 from +3620, +3630,... and removing the corresponding TextUnicode
1055 line
1056 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1057 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
1058 \([^\n]*\)\n
1059 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
1060 clearall
1063 deletecalendar start [stop]
1066 getallcalendar
1069 getcalendar start [stop]
1072 getcalendarsettings
1075 restore file [-yes]
1078 Restore settings written in file created using backup option.
1079 All things backup'ed by backup can be restored (when made backup
1080 to Gammu text file).
1081 Please note that restoring deletes all current content in phone.
1083 If you want only to add entries to phone, use addnew.
1084 In some phones restoring calendar notes will not show error, but
1086 won't be done, when phone doesn't have set clock inside.
1087 savefile CALENDAR target.vcs file location
1090 savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
1093 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
1094 number] [-reply] [-maxsms num]
1095 Read calendar note from file created by backup option and saves
1096 in VCALENDAR 1.0 format as SMS
1097 sendsms CALENDAR destination file location [-report] [-validity
1100 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1101 ber] [-smscnumber number] [-reply] [-maxsms num]
1102 To do lists
1106 addcategory TODO|PHONEBOOK text
1107 addnew file [-yes]
1110 Adds settings written in file created using backup option. All
1111 things backup'ed by backup can be restored (when made backup to
1112 Gammu text file).
1113 backup file [-yes]
1116 Backup your phone to file. It's possible to backup (depends on
1117 phone):
1118 * phonebook from SIM and phone memory
1120 * calendar notes
1121 * SMSC settings
1122 * operator logo
1123 * startup (static) logo or startup text
1124 * WAP bookmarks
1125 * WAP settings
1126 * caller logos and groups
1127 * user ringtones BSLen use text backup files. List can be
1128 extended on request.
1129 TIP: if you will backup settings to Gammu text file, it will be
1131 possible to edit it. It's easy: many things in this file will be
1132 written double - once in Unicode, once in ASCII. When you will
1133 remove Unicode version Gammu will use ASCII on restore (and you
1134 can easy edit ASCII text) and will convert it according to your
1135 OS locale. When will be available Unicode version of text, it
1136 will be used instead of ASCII (usefull with Unicode phones - it
1137 isn't important, what locale is set in computer and no conver‐
1138 sion Unicode -> ASCII and ASCII -> Unicode is done).
1139 TIP: you can use any editor with regular expressions function to
1141 edit backup text file. Example: TextPad 4.2.2 from
1142 http://www.textpad.com/ with regular expressions based on POSIX
1143 standard P1003.2 is OK for it. Few examples for it:
1144 * to remove info about voice tags:
1146 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
1147 TO:
1148 * to change all numbers starting from +3620, +3630, +3660, +3670
1150 to +3620
1151 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1152 "\+36\(20\|30\|60\|70\)
1153 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
1154 * to change phone numbers type to mobile for numbers starting
1156 from +3620, +3630,... and removing the corresponding TextUnicode
1157 line
1158 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1159 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
1160 \([^\n]*\)\n
1161 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
1162 clearall
1165 deletetodo start [stop]
1168 getallcategory TODO|PHONEBOOK
1171 getalltodo
1174 getcategory TODO|PHONEBOOK start [stop]
1177 gettodo start [stop]
1180 listtodocategory text|number
1183 restore file [-yes]
1186 Restore settings written in file created using backup option.
1187 All things backup'ed by backup can be restored (when made backup
1188 to Gammu text file).
1189 Please note that restoring deletes all current content in phone.
1191 If you want only to add entries to phone, use addnew.
1192 In some phones restoring calendar notes will not show error, but
1194 won't be done, when phone doesn't have set clock inside.
1195 savefile TODO target.vcs file location
1198 savesms TODO file location [-folder id] [-unread] [-read] [-unsent]
1201 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
1202 number] [-reply] [-maxsms num]
1203 sendsms TODO destination file location [-report] [-validity
1206 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1207 ber] [-smscnumber number] [-reply] [-maxsms num]
1208 Notes
1212 getallnotes
1213 Date, time and alarms
1217 getalarm [start]
1218 Get alarm from phone, if no location is specified, 1 is used.
1219 getdatetime
1222 Get date and time from phone
1223 setalarm hour minute
1226 Sets repeating alarm in phone on selected time.
1227 setdatetime [HH:MM[:SS]] [YYYY/MM/DD]
1229 Set date and time in phone to date and time set in computer.
1230 Please note, that this option doesn't show clock on phone
1231 screen. It only set date and time.
1232 TIP: you can make such synchronization each time, when will con‐
1234 nect your phone and use Gammu. See gammurc for details.
1235 Categories
1239 addcategory TODO|PHONEBOOK text
1240 addnew file [-yes]
1243 Adds settings written in file created using backup option. All
1244 things backup'ed by backup can be restored (when made backup to
1245 Gammu text file).
1246 backup file [-yes]
1249 Backup your phone to file. It's possible to backup (depends on
1250 phone):
1251 * phonebook from SIM and phone memory
1253 * calendar notes
1254 * SMSC settings
1255 * operator logo
1256 * startup (static) logo or startup text
1257 * WAP bookmarks
1258 * WAP settings
1259 * caller logos and groups
1260 * user ringtones BSLen use text backup files. List can be
1261 extended on request.
1262 TIP: if you will backup settings to Gammu text file, it will be
1264 possible to edit it. It's easy: many things in this file will be
1265 written double - once in Unicode, once in ASCII. When you will
1266 remove Unicode version Gammu will use ASCII on restore (and you
1267 can easy edit ASCII text) and will convert it according to your
1268 OS locale. When will be available Unicode version of text, it
1269 will be used instead of ASCII (usefull with Unicode phones - it
1270 isn't important, what locale is set in computer and no conver‐
1271 sion Unicode -> ASCII and ASCII -> Unicode is done).
1272 TIP: you can use any editor with regular expressions function to
1274 edit backup text file. Example: TextPad 4.2.2 from
1275 http://www.textpad.com/ with regular expressions based on POSIX
1276 standard P1003.2 is OK for it. Few examples for it:
1277 * to remove info about voice tags:
1279 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
1280 TO:
1281 * to change all numbers starting from +3620, +3630, +3660, +3670
1283 to +3620
1284 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1285 "\+36\(20\|30\|60\|70\)
1286 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
1287 * to change phone numbers type to mobile for numbers starting
1289 from +3620, +3630,... and removing the corresponding TextUnicode
1290 line
1291 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1292 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
1293 \([^\n]*\)\n
1294 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
1295 clearall
1298 getallcategory TODO|PHONEBOOK
1301 getcategory TODO|PHONEBOOK start [stop]
1304 listmemorycategory text|number
1307 listtodocategory text|number
1310 restore file [-yes]
1313 Restore settings written in file created using backup option.
1314 All things backup'ed by backup can be restored (when made backup
1315 to Gammu text file).
1316 Please note that restoring deletes all current content in phone.
1318 If you want only to add entries to phone, use addnew.
1319 In some phones restoring calendar notes will not show error, but
1321 won't be done, when phone doesn't have set clock inside.
1322 Backing up and restoring
1326 addnew file [-yes]
1327 Adds settings written in file created using backup option. All
1328 things backup'ed by backup can be restored (when made backup to
1329 Gammu text file).
1330 addsms folder file
1333 Adds SMSes from file (format like backupsms uses) to selected
1334 folder in phone.
1335 backup file [-yes]
1337 Backup your phone to file. It's possible to backup (depends on
1338 phone):
1339 * phonebook from SIM and phone memory
1341 * calendar notes
1342 * SMSC settings
1343 * operator logo
1344 * startup (static) logo or startup text
1345 * WAP bookmarks
1346 * WAP settings
1347 * caller logos and groups
1348 * user ringtones BSLen use text backup files. List can be
1349 extended on request.
1350 TIP: if you will backup settings to Gammu text file, it will be
1352 possible to edit it. It's easy: many things in this file will be
1353 written double - once in Unicode, once in ASCII. When you will
1354 remove Unicode version Gammu will use ASCII on restore (and you
1355 can easy edit ASCII text) and will convert it according to your
1356 OS locale. When will be available Unicode version of text, it
1357 will be used instead of ASCII (usefull with Unicode phones - it
1358 isn't important, what locale is set in computer and no conver‐
1359 sion Unicode -> ASCII and ASCII -> Unicode is done).
1360 TIP: you can use any editor with regular expressions function to
1362 edit backup text file. Example: TextPad 4.2.2 from
1363 http://www.textpad.com/ with regular expressions based on POSIX
1364 standard P1003.2 is OK for it. Few examples for it:
1365 * to remove info about voice tags:
1367 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
1368 TO:
1369 * to change all numbers starting from +3620, +3630, +3660, +3670
1371 to +3620
1372 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1373 "\+36\(20\|30\|60\|70\)
1374 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
1375 * to change phone numbers type to mobile for numbers starting
1377 from +3620, +3630,... and removing the corresponding TextUnicode
1378 line
1379 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1380 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
1381 \([^\n]*\)\n
1382 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
1383 backupsms file
1386 Stores all SMSes from phone to file.
1387 restore file [-yes]
1389 Restore settings written in file created using backup option.
1390 All things backup'ed by backup can be restored (when made backup
1391 to Gammu text file).
1392 Please note that restoring deletes all current content in phone.
1394 If you want only to add entries to phone, use addnew.
1395 In some phones restoring calendar notes will not show error, but
1397 won't be done, when phone doesn't have set clock inside.
1398 restoresms file
1401 Restores SMSes from file (format like backupsms uses) to
1402 selected folder in phone. Please note that this overwrites
1403 existing messages in phone (if it supports it).
1404 savefile VCARD10|VCARD21 target.vcf file SM|ME location
1406 savefile BOOKMARK target.url file location
1409 savefile CALENDAR target.vcs file location
1412 savefile TODO target.vcs file location
1415 Nokia specific
1419 nokiaaddfile Gallery|Gallery2|Cam‐
1420 era|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name]
1421 [-protected] [-readonly] [-system] [-hidden] [-newtime]
1422 Install the *.jar/*.jad file pair of a midlet in the application
1423 or game menu of the phone. You have to give the name without the
1424 jar/jad suffix, otherwise you will get the slightly confusing
1425 error message Can't open specified file. Read only ?
1426 The option -overwrite deletes the application's .jad and .jar
1428 files bevor installing, but doesn't delete the application data.
1429 Option -overwriteall will also delete all data. Both these
1430 options work only for Application or Game upload.
1431 Example: gammu nokiaaddfile Application Alien will read
1433 Alien.JAD and Alien.JAR and add to Applications
1434 Example: gammu nokiaaddfile Tones file.mid will read file.mid
1436 and add to Tones folder
1437 nokiaaddplaylists
1440 nokiacomposer file
1443 Show, how to enter RTTL ringtone in composer existing in many
1444 Nokia phones (and how should it look like).
1445 nokiadebug filename [[v11-22] [,v33-44]...]
1448 nokiadisplayoutput
1451 nokiadisplaytest number
1454 nokiagetadc
1457 nokiagetoperatorname
1460 6110.c phones have place for name for one GSM network (of
1461 course, with flashing it's possible to change all names, but
1462 Gammu is not flasher ;-)). You can get this name using this
1463 option.
1464 nokiagetpbkfeatures memorytype
1467 nokiagetscreendump
1470 nokiagett9
1473 nokiagetvoicerecord location
1476 Get voice record from location and save to WAV file. File is
1478 coded using GSM 6.10 codec (available for example in win32).
1479 Name of file is like name of voice record in phone.
1480 nokiamakecamerashoot
1483 nokianetmonitor test
1486 Takes output or set netmonitor for Nokia DCT3 phones.
1487 TIP: For more info about this option, please visit
1489 http://www.mwiacek.com and read netmonitor manual.
1490 TIP: test 243 enables all tests (after using command gammu
1492 nokianetmonitor 243 in some phones like 6210 or 9210 have to
1493 reboot them to see netmonitor menu)
1494 nokianetmonitor36
1497 Reset counters from netmonitor test 36 in Nokia DCT3 phones.
1498 TIP: For more info about this option, please visit
1500 www.mwiacek.com and read netmonitor manual.
1501 nokiasecuritycode
1504 Get/reset to "12345" security code
1505 nokiaselftests
1508 nokiasetlights keypad|display|torch on|off
1511 nokiasetoperatorname [networkcode name]
1514 nokiasetphonemenus
1517 Enable all (?) possible menus for DCT3 Nokia phones:
1518 1. ALS (Alternative Line Service) option menu
1520 2. vibra menu for 3210
1521 3. 3315 features in 3310 5.45 and higher
1522 4. two additional games (React and Logic) for 3210 5.31 and
1523 higher
1524 5. WellMate menu for 6150
1525 6. NetMonitor
1526 and for DCT4:
1528 1. ALS (Alternative Line Service) option menu
1530 2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
1531 3. GPRS Always Online
1532 nokiasetvibralevel level
1535 Set vibra power to "level" (given in percent)
1536 nokiatuneradio
1539 nokiavibratest
1542 Siemens specific
1546 siemensnetmonact netmon_type (1-full, 2-simple)
1547 siemensnetmonitor test
1550 siemenssatnetmon
1553 Network
1557 getgprspoint start [stop]
1558 listnetworks [country]
1561 Show names/codes of GSM networks known for Gammu
1562 monitor [times]
1565 Get phone status and writes continuously to standard output.
1566 Press Ctrl+C to break this state.
1567 networkinfo
1570 nokiadebug filename [[v11-22] [,v33-44]...]
1573 nokiagetoperatorname
1576 6110.c phones have place for name for one GSM network (of
1577 course, with flashing it's possible to change all names, but
1578 Gammu is not flasher ;-)). You can get this name using this
1579 option.
1580 nokianetmonitor test
1583 Takes output or set netmonitor for Nokia DCT3 phones.
1584 TIP: For more info about this option, please visit
1586 http://www.mwiacek.com and read netmonitor manual.
1587 TIP: test 243 enables all tests (after using command gammu
1589 nokianetmonitor 243 in some phones like 6210 or 9210 have to
1590 reboot them to see netmonitor menu)
1591 nokiasetoperatorname [networkcode name]
1594 setautonetworklogin
1597 siemensnetmonact netmon_type (1-full, 2-simple)
1600 siemensnetmonitor test
1603 siemenssatnetmon
1606 WAP settings and bookmarks
1610 addnew file [-yes]
1611 Adds settings written in file created using backup option. All
1612 things backup'ed by backup can be restored (when made backup to
1613 Gammu text file).
1614 backup file [-yes]
1617 Backup your phone to file. It's possible to backup (depends on
1618 phone):
1619 * phonebook from SIM and phone memory
1621 * calendar notes
1622 * SMSC settings
1623 * operator logo
1624 * startup (static) logo or startup text
1625 * WAP bookmarks
1626 * WAP settings
1627 * caller logos and groups
1628 * user ringtones BSLen use text backup files. List can be
1629 extended on request.
1630 TIP: if you will backup settings to Gammu text file, it will be
1632 possible to edit it. It's easy: many things in this file will be
1633 written double - once in Unicode, once in ASCII. When you will
1634 remove Unicode version Gammu will use ASCII on restore (and you
1635 can easy edit ASCII text) and will convert it according to your
1636 OS locale. When will be available Unicode version of text, it
1637 will be used instead of ASCII (usefull with Unicode phones - it
1638 isn't important, what locale is set in computer and no conver‐
1639 sion Unicode -> ASCII and ASCII -> Unicode is done).
1640 TIP: you can use any editor with regular expressions function to
1642 edit backup text file. Example: TextPad 4.2.2 from
1643 http://www.textpad.com/ with regular expressions based on POSIX
1644 standard P1003.2 is OK for it. Few examples for it:
1645 * to remove info about voice tags:
1647 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
1648 TO:
1649 * to change all numbers starting from +3620, +3630, +3660, +3670
1651 to +3620
1652 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1653 "\+36\(20\|30\|60\|70\)
1654 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
1655 * to change phone numbers type to mobile for numbers starting
1657 from +3620, +3630,... and removing the corresponding TextUnicode
1658 line
1659 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1660 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
1661 \([^\n]*\)\n
1662 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
1663 clearall
1666 deletewapbookmark start [stop]
1669 Delete WAP bookmark(s) from phone. Locations are numerated from
1670 1.
1671 getchatsettings start [stop]
1674 getsyncmlsettings start [stop]
1677 getwapbookmark start [stop]
1680 Get WAP bookmark(s) from phone. Locations are numerated from 1.
1681 getwapsettings start [stop]
1684 Get WAP settings from phone. Locations are numerated from 1.
1685 restore file [-yes]
1688 Restore settings written in file created using backup option.
1689 All things backup'ed by backup can be restored (when made backup
1690 to Gammu text file).
1691 Please note that restoring deletes all current content in phone.
1693 If you want only to add entries to phone, use addnew.
1694 In some phones restoring calendar notes will not show error, but
1696 won't be done, when phone doesn't have set clock inside.
1697 savefile BOOKMARK target.url file location
1700 savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
1703 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
1704 number] [-reply] [-maxsms num]
1705 Read WAP bookmark from file created by backup option and saves
1706 in Nokia format as SMS
1707 savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
1710 [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
1711 number] [-reply] [-maxsms num]
1712 savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread]
1715 [-read] [-unsent] [-sent] [-sender number] [-smsname name] [-smscset
1716 number] [-smscnumber number] [-reply] [-maxsms num]
1717 Read WAP settings from file created by backup option and saves
1718 in Nokia format as SMS
1719 sendsms BOOKMARK destination file location [-report] [-validity
1722 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1723 ber] [-smscnumber number] [-reply] [-maxsms num]
1724 sendsms WAPINDICATOR destination URL Title [-report] [-validity
1727 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1728 ber] [-smscnumber number] [-reply] [-maxsms num]
1729 sendsms WAPSETTINGS destination file location DATA|GPRS [-report]
1732 [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]
1733 [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
1734 MMS and MMS settings
1738 getallmms [-save]
1739 geteachmms [-save]
1742 getmmsfolders
1745 getmmssettings start [stop]
1748 readmmsfile file [-save]
1751 savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read]
1754 [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
1755 [-smscnumber number] [-reply] [-maxsms num]
1756 savesms MMSSETTINGS file location [-folder id] [-unread] [-read]
1759 [-unsent] [-sent] [-sender number] [-smsname name] [-smscset number]
1760 [-smscnumber number] [-reply] [-maxsms num]
1761 sendsms MMSINDICATOR destination URL Title Sender [-report] [-validity
1764 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1765 ber] [-smscnumber number] [-reply] [-maxsms num]
1766 sendsms MMSSETTINGS destination file location [-report] [-validity
1769 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1770 ber] [-smscnumber number] [-reply] [-maxsms num]
1771 Phone tests
1775 nokiadisplaytest number
1776 nokiagetadc
1779 nokiaselftests
1782 nokiasetlights keypad|display|torch on|off
1785 nokiavibratest
1788 FM radio
1792 addnew file [-yes]
1793 Adds settings written in file created using backup option. All
1794 things backup'ed by backup can be restored (when made backup to
1795 Gammu text file).
1796 backup file [-yes]
1799 Backup your phone to file. It's possible to backup (depends on
1800 phone):
1801 * phonebook from SIM and phone memory
1803 * calendar notes
1804 * SMSC settings
1805 * operator logo
1806 * startup (static) logo or startup text
1807 * WAP bookmarks
1808 * WAP settings
1809 * caller logos and groups
1810 * user ringtones BSLen use text backup files. List can be
1811 extended on request.
1812 TIP: if you will backup settings to Gammu text file, it will be
1814 possible to edit it. It's easy: many things in this file will be
1815 written double - once in Unicode, once in ASCII. When you will
1816 remove Unicode version Gammu will use ASCII on restore (and you
1817 can easy edit ASCII text) and will convert it according to your
1818 OS locale. When will be available Unicode version of text, it
1819 will be used instead of ASCII (usefull with Unicode phones - it
1820 isn't important, what locale is set in computer and no conver‐
1821 sion Unicode -> ASCII and ASCII -> Unicode is done).
1822 TIP: you can use any editor with regular expressions function to
1824 edit backup text file. Example: TextPad 4.2.2 from
1825 http://www.textpad.com/ with regular expressions based on POSIX
1826 standard P1003.2 is OK for it. Few examples for it:
1827 * to remove info about voice tags:
1829 FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
1830 TO:
1831 * to change all numbers starting from +3620, +3630, +3660, +3670
1833 to +3620
1834 Find: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1835 "\+36\(20\|30\|60\|70\)
1836 Repl: Type = NumberMobile\nEntry\1Text = "\+3620
1837 * to change phone numbers type to mobile for numbers starting
1839 from +3620, +3630,... and removing the corresponding TextUnicode
1840 line
1841 F: Type = NumberGeneral\nEntry\([0-9][0-9]\)Text =
1842 "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode =
1843 \([^\n]*\)\n
1844 R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n
1845 clearall
1848 getfmstation start [stop]
1851 Show info about FM stations in phone
1852 nokiatuneradio
1855 restore file [-yes]
1858 Restore settings written in file created using backup option.
1859 All things backup'ed by backup can be restored (when made backup
1860 to Gammu text file).
1861 Please note that restoring deletes all current content in phone.
1863 If you want only to add entries to phone, use addnew.
1864 In some phones restoring calendar notes will not show error, but
1866 won't be done, when phone doesn't have set clock inside.
1867 Phone information
1871 getdisplaystatus
1872 getsecuritystatus
1875 Show, if phone wait for security code (like PIN, PUK, etc.) or
1876 not
1877 identify
1880 Show the most important phone data.
1881 monitor [times]
1884 Get phone status and writes continuously to standard output.
1885 Press Ctrl+C to break this state.
1886 nokiasecuritycode
1889 Get/reset to "12345" security code
1890 Phone settings
1894 getcalendarsettings
1895 getprofile start [stop]
1898 resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
1901 Reset phone settings. BE CAREFULL !!!!
1902 PHONE:
1904 DEV:
1906 ALL: Clear user settings
1908 * removes or set logos to default
1909 * set default phonebook and other menu settings
1910 * clear T9 words,
1911 * clear call register info
1912 * set default profiles settings
1913 * clear user ringtones
1914 UIF:
1916 * changes like after ALL
1917 * disables netmon and PPS (all "hidden" menus)
1918 FACTORY:
1920 * changes like after UIF
1921 * clear date/time
1922 savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent]
1925 [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
1926 [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ring‐
1927 tone]
1928 Read ringtone (RTTL) format and bitmap (Picture Image size) and
1929 name and save as Nokia profile.
1930 sendsms PROFILE destination [-report] [-validity
1933 HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num‐
1934 ber] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap
1935 bitmap] [-ringtone ringtone]
1936 Dumps decoding
1940 decodebinarydump file [phonemodel]
1941 After using option logfile with name binary (see /readme.txt for
1942 info about this method of reporting bugs) created file can be
1943 decoded using this option. It's available only, if Gammu was
1944 compiled with debug.
1945 decodesniff MBUS2|IRDA file [phonemodel]
1949 Option available only, if Gammu was compiled with debug. Allows
1950 to decode sniffs. See /docs/develop/develop.txt for more
1951 details.
1952 makeconverttable file
1955 Functions that don't fit elsewhere
1959 batch [file]
1960 entersecuritycode PIN|PUK|PIN2|PUK2 code
1963 Allow to enter security code from PC
1964 nokiagetscreendump
1967 nokiagetvoicerecord location
1970 Get voice record from location and save to WAV file. File is
1972 coded using GSM 6.10 codec (available for example in win32).
1973 Name of file is like name of voice record in phone.
1974 nokiamakecamerashoot
1977 nokiasetphonemenus
1980 Enable all (?) possible menus for DCT3 Nokia phones:
1981 1. ALS (Alternative Line Service) option menu
1983 2. vibra menu for 3210
1984 3. 3315 features in 3310 5.45 and higher
1985 4. two additional games (React and Logic) for 3210 5.31 and
1986 higher
1987 5. WellMate menu for 6150
1988 6. NetMonitor
1989 and for DCT4:
1991 1. ALS (Alternative Line Service) option menu
1993 2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
1994 3. GPRS Always Online
1995 nokiasetvibralevel level
1998 Set vibra power to "level" (given in percent)
1999 presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
2002 Press specified key sequence on phone keyboard
2003 mM - Menu
2005 nN - Names key
2006 pP - Power
2007 uU - Up
2008 dD - Down
2009 +- - +-
2010 gG - Green
2011 rR - Red
2012 123456789*0# is numeric keyboard
2013 reset SOFT|HARD
2016 Make phone reset: soft (without asking for PIN) or hard (with
2017 PIN).
2018 Note: some phones will make hard reset even with SOFT option.
2020 searchphone [-debug]
2023 Gammu information
2027 features
2028 help Output help information and exit.
2031 version
2034 Output version information and exit.
2035 SMS daemon
2039 sendsmsdsms TEXT|WAPSETTINGS|... destination FILES|MYSQL|PGSQL config‐
2040 file ... (options like in sendsms)
2041 smsd FILES configfile
2044 SMS Deaemon. See smsdrc config file for more options
2045 smsd MYSQL configfile
2048 smsd PGSQL configfile
2051
2055 ~/.gammurc
2056 /usr/share/doc/gammu/*
2057 /dev/ircomm?
2058 /dev/ttyS?
2059 /dev/ttyACM?
2060
2063 To check it out, edit ~/.gammurc and put there something like
2064 [gammu]
2066 port = /dev/ttyACM0
2067 connection = at
2068 Save text message up to standard 160 chars:
2071 echo "All your base are belong to us" | gammu savesms TEXT
2073 Save long text message:
2076 echo "All your base are belong to us" | gammu savesms TEXT
2078 -maxlen 400
2079 gammu savesms EMS -text "All your base are belong to us"
2081 Save some funky message with predefined sound and animation from 2 bit‐
2084 maps:
2085 gammu savesms EMS -text "Greetings" -defsound 1 -text "from
2087 Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
2088 Save protected message with ringtone:
2091 gammu savesms EMS -protected 2 -variablebitmaplong ala.bmp
2093 -toneSElong axelf.txt -toneSE ring.txt
2094
2097 This program is licensed under GNU/GPL version 2.
2098
2101 There are definitely many bugs, reporting to author is welcome. Please
2102 include some useful information when sending bug reports (especially
2103 debug logs, operating system, it's version and phone information are
2104 needed).
2105 To generate debug log, either enable in gammurc (alternatively you can
2108 do it on command line, but gammurc way allows separating debug log from
2109 other output):
2110 logfile = /tmp/gammu.log
2112 logformat = textall
2113 With this settings, Gammu generates /tmp/gammu.log on each connection
2115 to phone and stores dump of communication there. You can also find some
2116 hints for improving support for your phone in this log.
2117
2120 You can contact authors on <gammu-users@lists.sourceforge.net>.
2121 Michal Cihar <michal@cihar.com> is current project maintainer and con‐
2124 tributor of most of AT and OBEX code.
2125 Marcin Wiacek <marcin@mwiacek.com> is project iniciator and contributor
2128 of most Nokia code.
2129 As this project grew from Gnokii, we would like to thanks all Gnokii
2132 developers, especially Pavel Janik, Pawel Kot and Manfred Jonsson (see
2133 CREDITS from Gnokii for all their contributor).
2134 Many other people have helped with various features, check ChangeLog
2137 for more details.
2138
2141 README
2142 <http://www.gammu.org/> contains wiki with more user hints and further
2144 documentation
2145 cu(1)
2147 gnokii(1)
2149 wammu(1)
2151 gmobilemedia(1)
2153Gammu 1.13.91 Sep 12 2007 GAMMU(1)