Gammu:Full reference manual

Calls

--monitor [times]

--getussd code

--dialvoice number [show|hide]

--maketerminatedcall number length [show|hide]

--getspeeddial start [stop]

--cancelcall [ID]

--answercall [ID]

--unholdcall ID

--holdcall ID

--conferencecall ID

--splitcall ID

--switchcall [ID]

--transfercall [ID]

--divert get|set all|busy|noans|outofreach all|voice|fax|data [number timeout]

--canceldiverts

--senddtmf sequence

SMS and EMS

Introduction to SMS formats

These commands are provided for SMS. Gammu has got support for many SMS formats like:

• Nokia Smart Messaging (used for monochromatic picture images, downloadable profiles, monochromatic operator logos, monochromatic caller logos and monophonic ringtones)
• linked SMS (both with 8 and 16-bit identification numbers in headers)
• EMS (this is SMS format used for saving monochromatic images, monophonic ringtones, animations, text formatting and others)

Encoding chars in SMS text

Text in SMS can be coded using two ways:

• with GSM Default Alphabet - in single SMS you can have maximally 160 chars (Gammu doesn't support compressing such texts according to GSM standards, but it isn't big limit, because there are no phones supporting them), but they're from limited set:
  • all Latin small (abcdefghjklmnopqrstuvwxyz) and large (ABCDEFGHIJKLMNOPQRSTUVWXYZ)
  • all digits (1234567890)
  • some Greek (Φ Γ Λ Ω Π Ψ Σ Θ Ξ)
  • some other national (æ Æ ß à è É é ù ì ò ç Å å Ä ä Ö ö Ñ ñ Ü ü)
  • § £ ¥ @ ! " # & / ( ) % * + = - , . : ; < > ?
  • few other
• with Unicode - in single SMS you can save maximally 70 chars, but these can be any chars including all national and special. Please note, that problems with receiving/displaying such SMS can be sometimes connected with limits existing in (recipient's) phone firmware.

Gammu tries to give solution for some issues connected with translating chars between phone and computer. If you copy text into SMS:

1. all chars are internally converted into Unicode:
   • if they were given using standard input, there are used operating system functions (you need to have correctly set national support for Greek chars to have Greek chars conversion, etc.)
   • if you gave Unicode coded file to Gammu, chars from it are simply copied
2. if SMS will use:
   • GSM Default Alphabet, Gammu will:
     • check, if some Unicode chars can be saved in GSM Default Alphabet using two chars only and will create such sequences (it's done for ^ { } \ [ ] ~ | € chars)
     • put all chars available in GSM Default Alphabet into SMS
     • try to save into SMS all other national chars (with dashes, dots, double dots, etc.) after replacing them with Latin
     • use "?" for all other chars
   • Unicode, Gammu will copy all chars into SMS

TIP: You can create Unicode file using WordPad in Win32 (during saving select "Unicode Text Document" format). In Unix can use for example YUdit.

TIP: when use ~ char in sms text and Unicode coding, text of sms after ~ char will blink in some DCT3 phones (like Nokia 3310)

SMS folders and locations

When you use SMS folder 0, SMS location 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.

Commands to get messages from phone

--getsmsfolders

Get list of SMS folders in phone and SIM.

--getsms folder start [stop]

Get SMS from specified locations. Option display SMS location like available in folder 0.

--getallsms

Get all possible SMS from phone and SIM. Each SMS is displayed just after getting from device (because of it please don't expect correct displaying linked SMS or EMS sequences). Option display SMS location like available in folder 0.

--geteachsms

Get all possible SMS from phone and SIM. Option get all of them, tries to find sequences (and link them) and display final content (texts, ringtones, bitmaps, etc.) to user. Option display SMS location like available in folder 0.

Commands to delete messages from phone

--deletesms folder start [stop]

--deleteallsms folder

Commands to send messages/save messages to phone

General format for sending messages is easy:

--sendsms SMSFORMAT destination options_specific_for_sms_format [switches_specific_for_sms_format] [switches_specific_for_sending_sms]

where:

• instead of SMSFORMAT you should put selected by you SMS format (they're descibed later)
• destination - recipient's phone number
• options_specific_for_sms_format - some parameters required for used SMSFORMAT
• switches_specific_for_sms_format - optional switches available for used SMSFORMAT
• switches_specific_for_sending_sms - optional switches available for --sendsms:
  • -report - add requests for delivery report (it's the most often offered by cellular network operators for free and allows to check, if SMS were received by recipients' phone. Please note, that receiving such report doesn't mean, that SMS was READ on recipients' phone)
  • -validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX - set SMS validity. Default it's taken from SMSC settings (set 1 on SIM card or other specified by -smscset)
  • -save [-folder number] -
  • -smscset number - SMSC and validity settings will be taken from set number on SIM card. If not specified, there will be used set 1.
  • -smscnumber number - SMSC number. If not specified, SMSC number is taken from set 1 on SIM card or specified by -smscset.
  • -reply - when used, you allow recipient to answer on SMS using your SMSC. The most often you will pay for his SMS then.
  • -maxsms num - Gammu will take such part of SMS text, which can be saved in maximally num SMS

Similiary it's possible to save sms:

--savesms SMSFORMAT options_specific_for_sms_format [switches_specific_for_sms_format] [switches_specific_for_saving_sms]

where switches_specific_for_saving_sms:

• -folder id - 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.
• -sent - makes message sent.
• -sender number - set sender number (default: "Gammu")
• -smscset number - SMSC number will be taken from set number on SIM card. If not specified, there will be used set 1.
• -smscnumber number - SMSC number. If not specified, SMSC number is taken from set 1 on SIM card or specified by -smscset.
• -reply - this will set indicator, that SMS sender allowed recipient to answer on SMS using his SMSC.
• -maxsms num - Gammu will take such part of SMS text, which can be saved in maximally num SMS

For each saved SMS there is displayed info about folder. Location is given like in SMS folder "0".

Now we will describe available SMSFORMATs:

format TEXT

Used for single/linked text SMS. Gammu reads SMS text, format according to used command line switches and send/save.

--sendsms TEXT destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file]

--savesms TEXT [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file]

Switches specific for this option:

• -inputunicode - input text is in Unicode.
• -16bit - Gammu uses SMS headers with 16-bit numbers for saving linking info in SMS (it means less chars available for user in each SMS)
• -flash - SMS will use Class 0 (should be displayed after receiving on recipients' phone display after receiving without entering Inbox)
• -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.
• -unicode - SMS will be saved in Unicode format
• -enablevoice, -disablevoice, -enablefax, -disablefax, -enableemail, -disableemail - SMS for setting voice mail, email or fax on phone display
• -voidsms - many phones after receiving it won't display anything, only beep, vibrate or turn on light. Text will be cut to 1 sms.
• -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_unicode_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"

Example usages:

echo "I hate mondays" | gammu --savesms TEXT

saves SMS with text "I hate mondays"

gammu --savesms TEXT -maxlen 40 < file.txt

get maximally 40 chars from text file and save them into text sms

TIP: you can use format EMS with -text switch to have the same effect too.

format EMS

Used for EMS sequences. Please note, that currently bitmaps, ringtones, text formatting compatible with this standard it's not supported by Nokia phones and don't expect it there.

--sendsms EMS destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-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]

--savesms EMS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-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]

Switches specific for this option:

• -unicode - all texts will be coded using Unicode
• -16bit - Gammu uses SMS headers with 16-bit numbers for saving linking info in SMS (it means less chars available for user in each SMS)
• -format lcrasbiut - last text will be formatted. You can use combinations of chars:
  • l - left aligned
  • c - centered
  • r - right aligned
  • a - large font
  • s - small font
  • b - bold font
  • i - italic font
  • u - underlined
  • t - strikethrough
• -text text - add text as sequence part
• -unicodefiletext file - read text from Unicode file and add as sequence part
• -defsound ID - adds default sound with ID specified by user as sequence part. ID for different phones are different.
• -defanimation ID - adds default animation with ID specified by user as sequence part. ID for different phones are different.
• -tone10 file - add IMelody version 1.0 read from RTTL or other compatible file
• -tone10long file - add 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 file - add IMelody version 1.2 read from RTTL or other compatible file
• -tone12long file - add 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 file - add IMelody in "short" form supported by SonyEricsson phones
• -toneSElong file - add SonyEricsson IMelody saved in one or few SMS with UPI
• -fixedbitmap file - add bitmap read from 2 colors bitmap file (BMP, NOL, NGG,...). It's saved in 16x16 or 32x32 size.
• -variablebitmap file - add bitmap read from 2 colors bitmap file (BMP, NOL, NGG,...). It's saved in original size in one SMS.
• -variablebitmaplong file - add bitmap read from 2 colors bitmap file (BMP, NOL, NGG,...). It's saved as bitmap with original size (but there is maximal size limit equal 96x128) saved in one or few sms.
• -animation frames file1 ... - adds "frames" frames read from file1, file2, etc.
• -protected number - number of 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). It's kind of DRM.

All switches after "-16bit" (like "-defsound") can be used few times (they're connected with sequence parts).

Example usages:

gammu --savesms EMS -text "I hate mondays"

will save simple SMS with text "I hate mondays"

gammu --savesms EMS -text "Greetings" -defsound 1 -text "from Gammu"
-tone10 axelf.txt -animation 2 file1.bmp file2.bmp

will save EMS sequence with text "Greetings", default sound 1, text "from Gammu", ringtone axelf.txt and 2 frames animation read from (1'st frame) file1.bmp and (2'nd frame) file2.bmp

gammu --savesms EMS -protected 2 -variablebitmaplong ala.bmp
-toneSElong axelf.txt -toneSE ring.txt

ala.bmp and axelf.txt will be "protected"

format RINGTONE

Used for ringtones in Smart Messaging format.

--sendsms RINGTONE destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Switches specific for this option:

• -long - ringtone is saved using Profile style. It can be longer (and saved in 2 SMS), but decoded only by newer phones (like Nokia 3310)
• -scale - ringtone will have Scale info for each note. It will allow to edit it correctly later in phone composer (for example, in Nokia 3310)

format OPERATOR

Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format into operator logo in Smart Messaging format (72x14 or 78x21, 2 colors) and send/save over SMS.

Please note, that it isn't designed for colour logos available for example in DCT4/TIKU - you need to put bitmap file there inside phone using filesystem commands.

--sendsms OPERATOR destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode] [-biglogo]

--savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode] [-biglogo]

Switches specific for this option:

• -netcode netcode -
• -biglogo - there will be used 78x21 size instead of 72x14 (bigger size is supported by Nokia 6210, 7110 and so on)

format CALLER

Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format into caller group logo in Smart Messaging format (72x14, 2 colors) and send/save over SMS.

Please note, that it isn't designed for colour logos available for example in DCT4/TIKU - you need to put bitmap file there inside phone using filesystem commands.

--sendsms CALLER destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms CALLER file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

format PROFILE

Read ringtone (RTTL) format, bitmap (Picture Image size) and name, format into Smart Messaging profile and send/save as SMS. Please note, that this format is abandomed by Nokia and supported by some (older) devices only like Nokia 3310.

--sendsms PROFILE destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ringtone]

--savesms PROFILE [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-name name] [-bitmap bitmap] [-ringtone ringtone]

Switches specific for this option:

• -name name -
• -bitmap bitmap -
• -ringtone ringtone -

format PICTURE

Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format into bitmap in Smart Messaging (72x28, 2 colors, called often Picture Image and saved with text) or Alcatel format and send/save over SMS.

--sendsms PICTURE destination file [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

--savesms PICTURE file [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

Switches specific for this option:

• -text text -
• -unicode -
• -alcatelbmmi -

format ANIMATION

--sendsms ANIMATION destination frames file1 file2... [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms ANIMATION frames file1 file2... [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

format SMSTEMPLATE

--sendsms SMSTEMPLATE destination [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-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 SMSTEMPLATE [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-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 ...]

format MMSINDICATOR

--sendsms MMSINDICATOR destination URL Title Sender [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms MMSINDICATOR URL Title Sender [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

format WAPINDICATOR

--sendsms WAPINDICATOR destination URL Title [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

format BOOKMARK

--sendsms BOOKMARK destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read WAP bookmark from file created by --backup option and saves in SMS.

format WAPSETTINGS

--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]

--savesms WAPSETTINGS file location DATA|GPRS [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read WAP settings from file created by --backup option and saves in SMS.

format MMSSETTINGS

--sendsms MMSSETTINGS destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms MMSSETTINGS file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

format CALENDAR

--sendsms CALENDAR destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Read calendar note from file created by --backup option and saves in VCALENDAR 1.0 format.

format TODO

Read todo from file created by --backup option and send/save using SMS.

--sendsms TODO destination file location [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

--savesms TODO file location [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

format VCARD10|VCARD21

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.

--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]

--savesms VCARD10|VCARD21 file SM|ME location [-nokia] [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender number] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]

Other commands

Phonebook memories (phonebook, calls history and others)

Memory Types

• DC = Dialled calls
• MC = Missed calls
• RC = Received calls
• ON = Own numbers
• VM = voice mailbox
• SM = SIM phonebook
• ME = phone internal phonebook

Commands to get contents of memory

--getmemory DC|MC|RC|ON|VM|SM|ME|FD start [stop [-nonempty]]
Note: Memory locations are numbered from 1

--getallmemory DC|MC|RC|ON|VM|SM|ME|FD

--searchmemory text

--listmemorycategory text|number

--getspeeddial start [stop]

--getcategory TODO|PHONEBOOK start [stop]

--getallcategory TODO|PHONEBOOK

Other commands

Filesystem

These commands are provided for manupulating phone memory/memory card filesystem. Currently there are supported filesystems in Nokia Series 40 phones (at least versions 1.0 and 2.0 in DCT4/TIKU devices) and OBEX filesystem.

--getfilesystemstatus

--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 -
• -flat -

--getfilefolder ID1, ID2, ...

--addfolder parentfolderID name

--deletefolder name

--getfolderlisting folderID

Display files and folders available in folder with given folderID. You can get ID's using --getfilesystem -flatall.

--getrootfolders

Display info about drives available in phone/memory card.

--setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]

--getfiles ID1, ID2, ...

--addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT] [-readonly] [-protected] [-system] [-hidden] [-newtime]

--deletefiles fileID

--nokiaaddfile Application|Game file [-readonly] [-overwrite]

--nokiaaddfile Gallery|Gallery2|Camera|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name] [-protected] [-readonly] [-system] [-hidden] [-newtime]

Logos and pictures

Commands to get logos from phone

--getbitmap STARTUP [file]

--getbitmap CALLER location [file]

--getbitmap OPERATOR [file]

--getbitmap PICTURE location [file]

--getbitmap TEXT

--getbitmap DEALER

Commands to write logos to phone

--setbitmap STARTUP file|1|2|3

--setbitmap COLOURSTARTUP [fileID]

--setbitmap WALLPAPER fileID

--setbitmap CALLER location [file]

--setbitmap OPERATOR [file [netcode]]

--setbitmap COLOUROPERATOR [fileID [netcode]]

--setbitmap PICTURE file location [text]

--setbitmap TEXT text

--setbitmap DEALER text

Commands to converting logos from one type to another

--copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]

Converts one type of logo files to another. When only input-file is given, output will be written to stdout using ASCII art. When output file and format are given, in some file formats (like NLM) an indicator will be set informing you about the logo type which will be output.

Other commands

Command line options for sending logos over SMS are described in SMS section.

Ringtones

Command line options for sending ringtones over SMS are described in SMS section.

Command line options for making backup, restore are described in Backup section.

--playringtone file

Play aproximation of ringtone over phone buzzer.

--playsavedringtone number

--getringtone location [file]

Get ringtone from phone in RTTL or BINARY format. Locations are numbered from 1.

--getphoneringtone location [file]

--getringtoneslist

--setringtone file [-location location][-scale][-name name]

Set ringtone in phone. When you don’t give the location, it will be written "with preview" (in phones supporting this feature like61xx or 6210). When using RTTL ringtones, giving location and using -scale, scale info will be written with each note. It will avoid possible scale problems during editing the ringtone in composer from phone menu (e.g., in N33xx).

Tip: when you use the ~ char in the ringtone name, with some phones (like 33xx), the name will blink in the phone menus

--nokiacomposer file

Shows how to enter RTTL ringtone in the composer found in many Nokia phones (and what it should it look like).

--copyringtone source destination [RTTL|BINARY]

Calendar notes

In Nokia 3310, 3315 and 3330 these are named "Reminders" and have some limitations (depending on phone firmware version).

Command line options for sending calendar notes over SMS are described in SMS section.

Command line options for making backup, restore are described in Backup section.

--getcalendarsettings

--deletecalendar start [stop]

--getallcalendar

--getcalendar start [stop]

--savefile CALENDAR target.vcs file location

ToDo lists

--getalltodo

--listtodocategory text|number

--gettodo start [stop]

--deletetodo start [stop]

--getcategory TODO|PHONEBOOK start [stop]

--getallcategory TODO|PHONEBOOK

--savefile TODO target.vcs file location

Notes

--getallnotes

Date, time and alarms

--getdatetime

Get the date and time from the phone

--setdatetime

Set the date and time in the phone to the date and time set in the computer.

Note: this option doesn’t show the clock on phone screen. It only sets the date and time.

--getalarm

Get the alarm from the phone

--setalarm hour minute

Backing up and restoring phone data

--savefile CALENDAR target.vcs file location

--savefile TODO target.vcs file location

--savefile VCARD10|VCARD21 target.vcf file SM|ME location

--savefile BOOKMARK target.url file location

--backup file [-yes]
Backup your phone to file. Depending on the phone, it’s possible to backup:

• 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

The items being backed up depend on the extension of the file name you provide. The extensions handled in a special way are as follows:

• .lmb
• .vcs - only calendar items are backed up. The result is an iCal file
• .vcf - only contact items are backed up. The result is in VCard format
• .ldif - only contact items are backed up. The result is in ldif (LDAP import) format
• .ics - only calendar items are backed up. The result is an iCal file (non-functional, results in an empty file)

when you use text backup files. List can be extended on request.
Tip: if you backup settings to a Gammu text file, it will be possible to edit it. It’s easy - many things in this file will be written twice, once in Unicode, once in ASCII. When you remove the Unicode version Gammu will use the ASCII one on --restore (you can easily edit the ASCII text) and will convert it according to the locale set in your computer. When the Unicode version of the text is available, it will be used instead of the ASCII version. This is useful with Unicode phones - it isn’t important, what locale is set in the computer and no conversion Unicode -> ASCII and ASCII -> Unicode is done.

Specific to Nokia phones

--getgprspoint start [stop]

--nokiagetoperatorname
6110.c phones have a space for the name for one GSM network (of course, with flashing it’s possible to change all names, but Gammu is not a flasher ;-)). You can get this name using this option.

--nokiasetoperatorname [networkcode name]

--nokiadisplayoutput

--nokianetmonitor test

Takes output or set netmonitor for Nokia DCT3 phones.

Specific to Siemens phones

--siemenssatnetmon

--siemensnetmonact netmon_type (1-full, 2-simple)

--siemensnetmonitor test

Network

--monitor [times]
Gets the phone status and writes it continuously to standard output.
Press Ctrl+C to exit the monitor.

--setautonetworklogin

--listnetworks [country]
Show names/codes of GSM networks known to Gammu

--getgprspoint start [stop]

--networkinfo

--siemenssatnetmon

--siemensnetmonact netmon_type (1-full, 2-simple)

--siemensnetmonitor test

--nokiagetoperatorname
6110.c phones have a space for the name for one GSM network (of course, with flashing it’s possible to change all names, but Gammu is not a flasher ;-)). You can get this name using this option.

--nokiasetoperatorname [networkcode name]

WAP settings and bookmarks

--deletewapbookmark start [stop]

Delete WAP bookmark(s) from phone. Locations are numbered from 1.

--getwapbookmark start [stop]

Get WAP bookmark(s) from phone. Locations are numbered from 1.

--getwapsettings start [stop]

Get WAP settings from phone. Locations are numbered from 1.

--getsyncmlsettings start [stop]

--getchatsettings start [stop]

--savefile BOOKMARK target.url file location

--backup file [-yes]

--restore file

--addnew file

--clearall

MMS and MMS settings

--getmmssettings start [stop]

--savemmsfile file [-subject text][-text text]

FM radio

--getfmstation start [stop]
Show info about FM stations in phone

Phone information

--identify
Shows the most important phone data.

--getdisplaystatus

--monitor [times]
Gets phone status and writes it continuously to standard output. Press Ctrl+C to quit the monitor.

--getsecuritystatus
Shows whether the phone requires a security code to be entered (like PIN, PUK, etc).

--nokiasecuritycode
Allows you to enter a security code from the computer.

Phone settings

--resetphonesettings PHONE|DEV|UIF|ALL|FACTORY

--savesms PROFILE [-folder id][-unread][-read][-unsent][-sent][-sender number][-smscset number][-smscnumber number][-reply][-maxsms num][-name name][-bitmap bitmap][-ringtone ringtone]

--sendsms PROFILE destination [-report][-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX][-save [-folder number][-smscset number][-smscnumber number][-reply][-maxsms num][-name name][-bitmap bitmap][-ringtone ringtone]

--getcalendarsettings

--getprofile start [stop]

Commands that don't fit anywhere else

--version
Output version information and exit.