This program is a tool for mobile phones. Many vendors and phones are supported, for actual listing see
GammuPhonesDatabase.
Options
Parameters before command configure gammu behaviour:
-c,--config<filename>
name of configuration file (see gammurc)
-s,--section<confign>
section of config file to use, eg. 42
-d,--debug<level>
debug level (see LogFormat in gammurc for possible values)
-f,--debug-file<filename>
file for logging debug messages
Callcommandsanswercall[id]
Answer incoming call.
cancelcall[id]
Cancel incoming call
canceldiverts
Cancel all existing call diverts.
conferencecallid
Initiates a conference call.
dialvoicenumber[show|hide]
Make voice call from SIM card line set in phone.
show|hide - optional parameter whether to disable call number indication.
divertget|setall|busy|noans|outofreachall|voice|fax|data[numbertimeout]
Manage or display call diverts.
getorset
whether to get divert information or to set it.
allorbusyornoansoroutofreach
condition when apply divert
allorvoiceorfaxordata
call type when apply divert
number number where to divert
timeout
timeout when the diversion will happen
getussdcode
Retrieves USSD information - dials a service number and reads response.
holdcallid
Holds call.
maketerminatedcallnumberlength[show|hide]
Make voice call from SIM card line set in phone which will be terminated after length seconds.
senddtmfsequence
Plays DTMF sequence. In some phones available only during calls
splitcallid
Splits call.
switchcall[id]
Switches call.
transfercall[id]
Transfers call.
unholdcallid
Unholds call.
SMSandEMScommands
Sending messages might look a bit complicated on first attempt to use. But be patient, the command line
has been written in order to allow almost every usage. See EXAMPLE section for some hints on usage.
There is also an option to use gammu-smsd when you want to send or receive more messages and process them
automatically.
IntroductiontoSMSformats
Gammu has support for many SMS formats like:
NokiaSmartMessaging
used for monochromatic picture images, downloadable profiles, monochromatic operator logos,
monochromatic caller logos and monophonic ringtones
LinkedSMS
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
MMSnotifications
contains links where phone should download MMS
Alcatellogomessages
proprietary format for logos
You need to ensure that the target phone supports message type you want to send. Otherwise the phone will
not be able to display it or will even crash, because firmware of phone did not expect this possibility.
EncodingcharsinSMStext
Text in SMS can be coded using two ways:
GSMDefaultAlphabet
With GSMDefaultAlphabet you can fit at most 160 chars into single SMS (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 and large
• all digits
• some Greek
• some other national
• some symbols like @ ! " # & / ( ) % * + = - , . : ; < > ?
• few others
Unicode
With Unicode single SMS can contain at most 70 chars, but these can be any chars including all national
and special ones.
WARNING:
Please note, that some older phones might have problems displaying such message.
Conversion
Gammu tries to do the best to handle non ASCII characters in your message. Everything is internally
handled in Unicode (the input is converted depending on your locales configuration) and in case message
uses Unicode the text will be given as such to the message.
Should the message be sent in GSM Default Alphabet, Gammu will try to convert all characters to keep
message readable. Gammu does support multi byte encoding for some characters in GSM Default Alphabet (it
is needed for ^{}\[]~|). The characters which are not present in GSM Default Alphabet are
transliterated to closest ASCII equivalent (accents are removed). Remaining not known characters are
replaced by question mark.
SMScommandsaddsmsfoldernamedeleteallsmsfolder
Delete all SMS from specified SMS folder.
deletesmsfolderstart[stop]
Delete SMS from phone. See description for gammugetsms for info about sms folders naming
convention.
Locations are numerated from 1.
displaysms...(optionslikeinsendsms)
Displays PDU data of encoded SMS messages. It accepts same parameters and behaves same like
sendsms.
getallsms-pbk
Get all SMS from phone. In some phones you will have also SMS templates and info about locations
used to save Picture Images. With each sms you will see location. If you want to get such sms from
phone alone, use gammugetsms.
geteachsms-pbk
Similarly to gammugetallsms. Difference is, that links all concatenated sms
getsmsfolderstart[stop]
Get SMS.
Locations are numerated from 1.
Folder 0 means that sms is being read from "flat" memory (all sms from all folders have unique
numbers). It's sometimes emulated by Gammu. You can use it with all phones.
Other folders like 1, 2, etc. match folders in phone such as 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 gammugetsmsfolders to get folders list.
getsmsc[start[stop]]
Get SMSC settings from SIM card.
Locations are numerated from 1.
getsmsfolders
Get names for SMS folders in phone
savesmsTYPE[typeparameters][typeoptions][-folderid][-unread][-read][-unsent][-sent][-sendernumber][-smsnamename][-smscsetnumber][-smscnumbernumber][-reply][-maxsmsnum]
Saves SMS to phone, see below for TYPE options.
-smscsetnumber
SMSC number will be taken from phone stored SMSC configuration number.
Default: 1
-smscnumbernumber
SMSC number
-reply reply SMSC is set
-foldernumber
save to specified folder.
Folders are numerated from 1.
The most often folder 1 = "Inbox", 2 = "Outbox",etc. Use gammugetsmsfolders 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
-smsnamename
set message name
-sendernumber
set sender number (default: Gammu)
-maxsmsnum
Limit maximum number of messages which will be created. If there are more messages,
Gammu will terminate with failure.
Types of messages:
ANIMATIONframesfile1file2...
Save an animation as a SMS. You need to give number of frames and picture for each
frame. Each picture can be in any picture format which Gammu supports (B/W bmp, gif,
wbmp, nol, nlm...).
BOOKMARKfilelocation
Read WAP bookmark from file created by gammubackup command and saves in Nokia format as
SMS
CALENDARfilelocation
Read calendar note from file created by gammubackup command and saves in VCALENDAR 1.0
format as SMS. The location identifies position of calendar item to be read in backup
file (usually 1, but can be useful in case the backup contains more items).
CALLERfile
Save caller logo as sms in Nokia (Smart Messaging) format - size 72x14, two colors.
WARNING:
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.
USSD Send USSD query instead of SMS.
New in version 1.38.5.
EMS[-unicode][-16bit][-formatlcrasbiut][-texttext][-unicodefiletextfile][-defsoundID][-defanimationID][-tone10file][-tone10longfile][-tone12file][-tone12longfile][-toneSEfile][-toneSElongfile][-fixedbitmapfile][-variablebitmapfile][-variablebitmaplongfile][-animationframesfile1...][-protectednumber]
Saves EMS sequence. All format specific parameters (like -defsound) can be used few
times.
-text adds text
-unicodefiletext
adds text from Unicode file
-defanimation
adds default animation with ID specified by user. ID for different phones are
different.
-animation
adds "frames" frames read from file1, file2, etc.
-defsound
adds default sound with ID specified by user. ID for different phones are
different.
-tone10
adds IMelody version 1.0 read from RTTL or other compatible file
-tone10long
IMelody version 1.0 saved in one of few SMS with UPI. Phones compatible with UPI
(like Sony-Ericsson phones) will read such ringtone as one
-tone12
adds IMelody version 1.2 read from RTTL or other compatible file
-tone12long
IMelody version 1.2 saved in one of few SMS with UPI. Phones compatible with UPI
(like Sony-Ericsson phones) will read such ringtone as one
-toneSE
adds IMelody in "short" form supported by Sony-Ericsson phones
-toneSElong
add Sony-Ericsson IMelody saved in one or few SMS with UPI
-variablebitmap
bitmap in any size saved in one SMS
-variablebitmaplong
bitmap with maximum size 96x128 saved in one or few sms
-fixedbitmap
bitmap 16x16 or 32x32
-protected
all ringtones and bitmaps after this parameter (excluding default ringtones and
logos) will be "protected" (in phones compatible with ODI like SonyEricsson
products it won't be possible to forward them from phone menu)
-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)
-formatlcrasbiut
last text will be formatted. You can use combinations of chars:
┌───────────┬────────────────────┐
│ Character │ Formatting │
├───────────┼────────────────────┤
│ l │ left aligned │
├───────────┼────────────────────┤
│ c │ centered │
├───────────┼────────────────────┤
│ r │ right aligned │
├───────────┼────────────────────┤
│ a │ large font │
├───────────┼────────────────────┤
│ s │ small font │
├───────────┼────────────────────┤
│ b │ bold font │
├───────────┼────────────────────┤
│ i │ italic font │
├───────────┼────────────────────┤
│ u │ underlined font │
├───────────┼────────────────────┤
│ t │ strikethrough font │
└───────────┴────────────────────┘
MMSINDICATORURLTitleSender
Creates a MMS indication SMS. It contains URL where the actual MMS payload is stored
which needs to be SMIL encoded. The phone usually downloads the MMS data using special
APN, which does not count to transmitted data, however there might be limitations which
URLs can be accessed.
MMSSETTINGSfilelocation
Saves a message with MMS configuration. The configuration will be read from Gammu backup
file from given location.
OPERATORfile[-netcodenetcode][-biglogo]
Save operator logo as sms in Nokia (Smart Messaging) format - size 72x14 in two colors.
-biglogo
Use 78x21 formatted logo instead of standard 72x14.
NOTE:
This isn't designed for colour logos available for example in newer phones - you
need to put bitmap file there inside phone using filesystem commands.
PICTUREfile[-texttext][-unicode][-alcatelbmmi]
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.
PROFILE[-namename][-bitmapbitmap][-ringtoneringtone]
Read ringtone (RTTL) format, bitmap (Picture Image size) and name, format into Smart
Messaging profile and send/save as SMS.
WARNING:
Please note, that this format is abandoned by Nokia and supported by some (older)
devices only like Nokia 3310.
RINGTONEfile[-long][-scale]
Read RTTL ringtone from file and save as SMS into SIM/phone memory. Ringtone is saved in
Nokia (Smart Messaging) format.
-long ringtone is saved using Profile style. It can be longer (and saved in 2 SMS), but
decoded only by newer phones (like 33xx)
-scale ringtone will have Scale info for each note. It will allow one to edit it
correctly later in phone composer (for example, in 33xx)
SMSTEMPLATE[-unicode][-texttext][-unicodefiletextfile][-defsoundID][-defanimationID][-tone10file][-tone10longfile][-tone12file][-tone12longfile][-toneSEfile][-toneSElongfile][-variablebitmapfile][-variablebitmaplongfile][-animationframesfile1...]
Saves a SMS template (for Alcatel phones).
TEXT[-inputunicode][-16bit][-flash][-lenlen][-autolenlen][-unicode][-enablevoice][-disablevoice][-enablefax][-disablefax][-enableemail][-disableemail][-voidsms][-replacemessagesID][-replacefilefile][-textmsgtext][-textutf8msgtext]
Take text from stdin (or commandline if -text specified) and save as text SMS into
SIM/phone memory.
-flash Class 0 SMS (should be displayed after receiving on recipients' phone display
after receiving without entering Inbox)
-lenlen
specify, how many chars will be read. When use this option and text will be
longer than 1 SMS, will be split into more linked SMS
-autolenlen
specify, how many chars will be read. When use this option and text will be
longer than 1 SMS, will be split into more linked SMS.Coding type (SMS default
alphabet/Unicode) is set according to input text
-enablevoice
sms will set voice mail indicator. Text will be cut to 1 sms.
-disablevoice
sms will not set voice mail indicator. Text will be cut to 1 sms.
-enablefax
sms will set fax indicator. Text will be cut to 1 sms.
-disablefax
sms will not set fax indicator. Text will be cut to 1 sms.
-enableemail
sms will set email indicator. Text will be cut to 1 sms.
-disableemail
sms will not set email indicator. Text will be cut to 1 sms.
-voidsms
many phones after receiving it won't display anything, only beep, vibrate or turn
on light. Text will be cut to 1 sms.
-unicode
SMS will be saved in Unicode format
NOTE:
The ~ char in SMS text and -unicode option (Unicode coding required) can
cause text of SMS after ~ char blink in some phones (like Nokia 33xx).
-inputunicode
input text is in Unicode.
NOTE:
You can create Unicode file using WordPad in Windows (during saving select
"Unicode Text Document" format). In Unix can use for example YUdit or vim.
-text get text from command line instead of stdin.
-textutf8
get text in UTF-8 from command line instead of stdin.
NOTE:
Gammu detects your locales and uses by default encoding based on this. Use
this option only when you know the input will be in UTF-8 in all cases.
-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)
-replacemessagesIDID 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
-replacefilefile
File with replacement table in unicode (UCS-2), preferably with byte order mark
(BOM). It contains pairs of chars, first one is to replace, second is replacement
one. The replacement is done after reading text for the message.
For example replacement 1 (0x0061) with a (0x0031) would be done by file with
following content (hex dump, first two bytes is BOM):
ff fe 61 00 31 00
TODOfilelocation
Saves a message with a todo entry. The content will be read from any backup format which
Gammu supports and from given location.
VCARD10|VCARD21fileSM|MElocation[-nokia]
Read phonebook entry from file created by gammubackup command and saves in VCARD 1.0
(only name and default number) or VCARD 2.1 (all entry details with all numbers, text
and name) format as SMS. The location identifies position of contact item to be read in
backup file (usually 1, but can be useful in case the backup contains more items).
WAPINDICATORURLTitle
Saves a SMS with a WAP indication for given URL and title.
WAPSETTINGSfilelocationDATA|GPRS
Read WAP settings from file created by gammubackup command and saves in Nokia format as
SMS
sendsmsTYPEdestination[typeparameters][typeoptions][-smscsetnumber][-smscnumbernumber][-reply][-report][-validityHOUR|6HOURS|DAY|3DAYS|WEEK|MAX][-save[-foldernumber]]
Sends a message to a destination number, most parameters are same as for gammusavesms.
-save will also save message which is being sent
-report
request delivery report for message
-validityHOUR|6HOURS|DAY|3DAYS|WEEK|MAX
sets how long will be the message valid (SMSC will the discard the message after this time
if it could not deliver it).
setsmsclocationnumber
Set SMSC settings on SIM card. This keeps all SMSC configuration intact, it just changes the SMSC
number.
Locations are numerated from 1.
Memory(phonebooksandcalls)commandsMemorytypes
Gammu recognizes following memory types:
DC Dialled calls
MC Missed calls
RC Received calls
ON Own numbers
VM voice mailbox
SM SIM phonebook
ME phone internal phonebook
FD fixed dialling
SL sent SMS log
MemorycommandsdeleteallmemoryDC|MC|RC|ON|VM|SM|ME|MT|FD|SL
Deletes all entries from specified memory type.
For memory types description see Memorytypes.
deletememoryDC|MC|RC|ON|VM|SM|ME|MT|FD|SLstart[stop]
Deletes entries in specified range from specified memory type.
For memory types description see Memorytypes.
getallmemoryDC|MC|RC|ON|VM|SM|ME|MT|FD|SL
Get all memory locations from phone.
For memory types description see Memorytypes.
getmemoryDC|MC|RC|ON|VM|SM|ME|MT|FD|SLstart[stop[-nonempty]]
Get memory location from phone.
For memory types description see Memorytypes.
Locations are numerated from 1.
getspeeddialstart[stop]
Gets speed dial choices.
searchmemorytext
Scans all memory entries for given text. It performs case insensitive substring lookup. You can
interrupt searching by pressing Ctrl+C.
Filesystemcommands
Gammu allows one to access phones using native protocol (Nokias) or OBEX. Your phone can also support usb
storage, which is handled on the operating system level and Gammu does not use that.
addfilefolderIDname[-typeJAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT][-readonly][-protected][-system][-hidden][-newtime]
Add file with specified name to folder with specified folder ID.
-type File type was required for filesystem 1 in Nokia phones (current filesystem 2 doesn't need
this).
-readonly
Sets the read only attribute.
-protected
Sets the protected attribute (file can't be for example forwarded from phone menu).
-system
Sets the system attribute.
-hidden
Sets the hidden attribute (file is hidden from phone menu).
-newtime
After using it date/time of file modification will be set to moment of uploading.
addfolderparentfolderIDname
Create a folder in phone with specified name in a folder with specified folder ID.
deletefilesfileID
Delete files with given IDs.
deletefoldername
Delete folder with given ID.
getfilefolderfileID,fileID
Retrieve files or all files from folder with given IDs from a phone filesystem.
getfilesfileID,fileID
Retrieve files with given IDs from a phone filesystem.
getfilesystem[-flatall|-flat]
Display info about all folders and files in phone memory/memory card. By default there is tree
displayed, you can change it:
-flatall
there are displayed full file/folder details like ID (first parameter in line)
-flatNOTE:
In some phones (like N6230) content of some folders (with more files) can be cut (only part of
files will be displayed) for example on infrared connection. This is not Gammu issue, but phone
firmware problem.
getfilesystemstatus
Display info filesystem status - number of bytes available, used or used by some specific content.
getfolderlistingfolderID
Display files and folders available in folder with given folder ID. You can get ID's using
getfilesystem -flatall.
WARNING:
Please note, that in some phones (like N6230) content of some folders (with more files) can be
cut (only part of files will be displayed) for example on infrared connection. This is not
Gammu issue, but phone firmware problem.
getrootfolders
Display info about drives available in phone/memory card.
sendfilename
Sends file to a phone. It's up to phone to decide where to store this file and how to handle it
(for example when you send vCard or vCalendar, most of phones will offer you to import it.
setfileattribfolderID[-system][-readonly][-hidden][-protected]Logoandpicturescommands
These options are mainly (there are few exceptions) for monochromatic logos and images available in older
phones. Recognized file formats: xpm (only saving), 2-colors bmp, nlm, nsl, ngg, nol, wbmp, gif (for
Samsung).
In new models all bitmaps are saved in filesystem and should go into filesystem section
copybitmapinputfile[outputfile[OPERATOR|PICTURE|STARTUP|CALLER]]
Allow one to convert logos files to another. When give ONLY inputfile, output will be written to
stdout using ASCII art. When give output file and format, in some file formats (like NLM) will be
set indicator informing about logo type to given.
getbitmapTYPE[typeoptions]
Reads bitmap from phone, following types are supported:
CALLERlocation[file]
Get caller group logo from phone. Locations 1-5.
DEALER In some models it's possible to save dealer welcome note - text displayed during enabling
phone, which can't be edited from phone menu. Here you can get it.
OPERATOR[file]
Get operator logo (picture displayed instead of operator name) from phone.
PICTURElocation[file]
Get Picture Image from phone.
STARTUP[file]
Get static startup logo from phone. Allow one to save it in file.
TEXT Get startup text from phone.
setbitmapTYPE[typeoptions]
Sets bitmap in phone, following types are supported:
CALLERlocation[file]
Set caller logo.
COLOUROPERATOR[fileID[netcode]]
Sets color operator logo in phone.
COLOURSTARTUP[fileID]DEALERtext
Sets welcome message configured by dealer, which usually can not be changed in phone menus.
OPERATOR[file[netcode]]
Set operator logo in phone. When won't give file and netcode, operator logo will be removed
from phone. When will give only filename, operator logo will be displayed for your current
GSM operator. When you give additionally network code, it will be displayed for this
operator.
PICTUREfilelocation[text]
Sets picture image in phone.
STARTUPfile|1|2|3
Set startup logo in phone. It can be static (then you will have to give file name) or one
of predefined animated (only some phones like Nokia 3310 or 3330 supports it, use location
1, 2 or 3 for these).
TEXTtext
Sets startup text in phone.
WALLPAPERfileID
Sets wallpaper in phone.
Ringtonescommands
Ringtones are mostly supported only for older phones. For recent phones you usually just upload them to
some folder in phone filesystem.
There are recognized various file formats by options described below: rttl, binary format created for
Gammu, mid (saving), re (reading), ott, communicator, ringtones format found in fkn.pl, wav (saving),
ime/imy (saving), rng, mmf (for Samsung).
copyringtonesourcedestination[RTTL|BINARY]
Copy source ringtone to destination.
getphoneringtonelocation[file]
Get one of "default" ringtones and saves into file
getringtonelocation[file]
Get ringtone from phone in RTTL or BINARY format.
Locations are numerated from 1.
getringtoneslistplayringtonefile
Play approximation of ringtone over phone buzzer. File can be in RTTL or BINARY (Nokia DCT3)
format.
playsavedringtonenumber
Play one of built-in ringtones. This option is available for DCT4 phones. For getting ringtones
list use gammugetringtoneslist.
setringtonefile[-locationlocation][-scale][-namename]
Set ringtone in phone. When don't give location, it will be written "with preview" (in phones
supporting this feature like 61xx or 6210).
-scale Scale information will be added to each note of RTTL ringtone. It will avoid scale problems
available during editing ringtone in composer from phone menu (for example, in Nokia 33xx).
NOTE:
When use ~ char in ringtone name, in some phones (like 33xx) name will blink later in phone
menus.
Calendarnotescommands
In Nokia 3310, 3315 and 3330 these are named "Reminders" and have some limitations (depending on phone
firmware version).
deletecalendarstart[stop]
Deletes selected calendar entries in phone.
getallcalendar
Retrieves all calendar entries from phone.
getcalendarstart[stop]
Retrieves selected calendar entries from phone.
Todolistcommandsdeletetodostart[stop]
Deletes selected todo entries in phone.
getalltodo
Retrieves all todo entries from phone.
gettodostart[stop]
Retrieves selected todo entries from phone.
Notescommandsgetallnotes
Reads all notes from the phone.
NOTE:
Not all phones supports this function, especially most Sony Ericsson phones even if they have
notes inside phone.
Date,timeandalarmcommandsgetalarm[start]
Get alarm from phone, if no location is specified, 1 is used.
getdatetime
Get date and time from phone
setalarmhourminute
Sets repeating alarm in phone on selected time.
setdatetime[HH:MM[:SS]][YYYY/MM/DD]
Set date and time in phone to date and time set in computer. Please note, that this option doesn't
show clock on phone screen. It only set date and time.
NOTE:
You can make such synchronization each time, when will connect your phone and use Gammu. See
SynchronizeTime in gammurc for details.
CategoriescommandsNOTE:
Categories are supported only on few phones (Alcatel).
addcategoryTODO|PHONEBOOKtextgetallcategoryTODO|PHONEBOOKgetcategoryTODO|PHONEBOOKstart[stop]listmemorycategorytext|numberlisttodocategorytext|numberBackingupandrestoringcommandsaddnewfile[-yes][-memoryME|SM|..]
Adds data written in file created using gammubackup command. All things backed up gammubackup
can be restored (when made backup to Gammu text file).
Please note that this adds all content of backup file to phone and does not care about current
data in the phone (no duplicates are detected).
Use -yes parameter to answer yes to all questions (you want to automatically restore all data).
Use -memory parameter to force usage of defined memory type for storing entries regardless what
backup format says.
addsmsfolderfile[-yes]
Adds SMSes from file (format like gammubackupsms uses) to selected folder in phone.
backupfile[-yes]
Backup your phone to file. It's possible to backup (depends on phone and backup format):
• 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
There are various backup formats supported and the backup format is guessed based on file
extension:
• .lmb - Nokia backup, supports contacts, caller logos and startup logo.
• .vcs - vCalendar, supports calendar and todo.
• .vcf - vCard, supports contacts.
• .ldif - LDAP import, supports contacts.
• .ics - iCalendar, supports calendar and todo.
• Any other extension is Gammu backup file and it supports all data mentioned above, see
gammu-backup for more details.
By default this command is interactive and asks which items tou want to backup.
Use -yes for answering yes to all questions.
backupsmsfile[-yes|-all]
Stores all SMSes from phone to file into gammu-smsbackup.
By default this command is interactive and asks which folders you want to backup and whether you
want to remove messages from phone afterwards.
Use -yes for answering yes to all questions (backup all messages and delete them from phone), or
-all to just backup all folders while keeping messages in phone.
restorefile[-yes]WARNING:
Please note that restoring deletes all current content in phone. If you want only to add
entries to phone, use gammuaddnew.
Restore settings written in file created using gammubackup command.
In some phones restoring calendar notes will not show error, but won't be done, when phone doesn't
have set clock inside.
restoresmsfile[-yes]WARNING:
Please note that this overwrites existing messages in phone (if it supports it).
Restores SMSes from file (format like gammubackupsms uses) to selected folder in phone.
savefileTYPE[typeoptions]
Converts between various file formats supported by Gammu, following types are supported:
BOOKMARKtarget.urlfilelocation
Converts backup format supported by Gammu to vBookmark file.
CALENDARtarget.vcsfilelocation
Allows one to convert between various backup formats which gammu supports for calendar
events. The file type is guessed (for input file guess is based on extension and file
content, for output solely on extension).
TODOtarget.vcsfilelocation
Allows one to convert between various backup formats which gammu supports for todo events.
The file type is guessed (for input file guess is based on extension and file content, for
output solely on extension).
VCARD10|VCARD21target.vcffileSM|MElocation
Allows one to convert between various backup formats which gammu supports for phonebook
events. The file type is guessed (for input file guess is based on extension and file
content, for output solely on extension).
SEEALSO:gammuconvertbackupconvertbackupsource.fileoutput.file
New in version 1.28.94.
Converts backup between formats supported by Gammu. Unlike gammusavefile, this does not give you
any options what to convert, it simply takes converts all what can be saved into output file.
SEEALSO:gammusavefileNokiaspecificcommandsnokiaaddfileTYPE[typeoptions]
Uploads file to phone to specific location for the type:
APPLICATION|GAMEfile[-readonly][-overwrite][-overwriteall]
Install the *.jar/*.jad file pair of a midlet in the application or game menu of the phone.
You need to specify filename without the jar/jad suffix, both will be added automatically.
-overwrite
Delete the application's .jad and .jar files before installing, but doesn't delete
the application data.
-overwriteall
Delete the application (same as -overwrite) and all it's data.
You can use jadmaker to generate a .jad file from a .jar file.
GALLERY|GALLERY2|CAMERA|TONES|TONES2|RECORDS|VIDEO|PLAYLIST|MEMORYCARDfile[-namename][-protected][-readonly][-system][-hidden][-newtime]nokiaaddplaylists
Goes through phone memory and generated playlist for all music files found.
To manually manage playlists:
gammu addfile a:\\predefplaylist filename.m3u
Will add playlist filename.m3u
gammu getfilesystem
Will get list of all files (including names of files with playlists)
gammu deletefiles a:\\predefplaylist\\filename.m3u
Will delete playlist filename.m3u
Format of m3u playlist is easy (standard mp3 playlist):
First line is #EXTM3U, next lines contain names of files (b:\file1.mp3, b:\folder1\file2.mp3,
etc.). File needs t have \r\n terminated lines. So just run unix2dos on the resulting file before
uploading it your your phone.
nokiacomposerfile
Show, how to enter RTTL ringtone in composer existing in many Nokia phones (and how should it look
like).
nokiadebugfilename[[v11-22][,v33-44]...]nokiadisplayoutputnokiadisplaytestnumbernokiagetadcnokiagetoperatorname
6110.c phones have place for name for one GSM network (of course, with flashing it's possible to
change all names, but Gammu is not flasher ;-)). You can get this name using this option.
nokiagetpbkfeaturesmemorytypenokiagett9
This option should display T9 dictionary content from DCT4 phones.
nokiagetvoicerecordlocation
Get voice record from location and save to WAV file. File is coded using GSM 6.10 codec (available
for example in win32). Name of file is like name of voice record in phone.
Created WAV files require GSM 6.10 codec to be played. In Win XP it's included by Microsoft. If
you deleted it by accident in this operating system, make such steps:
1. Control Panel
2. Add hardware
3. click Next
4. select "Yes. I have already connected the hardware
5. select "Add a new hardware device
6. select "Install the hardware that I manually select from a list
7. select "Sound, video and game controllers
8. select "Audio codecs
9. select "windows\system32" directory and file "mmdriver.inf
10. if You will be asked for file msgsm32.acm, it should unpacked from Windows CD
11. now You can be asked if want to install unsigned driver (YES), about select codec
configuration (select what you want) and rebotting PC (make it)
nokiamakecamerashootnokianetmonitortest
Takes output or set netmonitor for Nokia DCT3 phones.
SEEALSO:
For more info about this option, please visit Marcin'spage and read netmonitor manual there.
NOTE:
test 243 enables all tests (after using command gammunokianetmonitor243 in some phones like
6210 or 9210 have to reboot them to see netmonitor menu)
nokianetmonitor36
Reset counters from netmonitor test 36 in Nokia DCT3 phones.
SEEALSO:
For more info about this option, please visit Marcin'spage and read netmonitor manual there.
nokiasecuritycode
Get/reset to "12345" security code
nokiaselftests
Perform tests for Nokia DCT3 phones.
NOTE:
EEPROM test can show an error when your phone has an EEPROM in flash (like
82xx/7110/62xx/33xx). The clock test will show an error when the phone doesn't have an internal
battery for the clock (like 3xxx).
nokiasetlightskeypad|display|torchon|offnokiasetoperatorname[networkcodename]nokiasetphonemenus
Enable all (?) possible menus for DCT3 Nokia phones:
1. ALS (Alternative Line Service) option menu
2. vibra menu for 3210
3. 3315 features in 3310 5.45 and higher
4. two additional games (React and Logic) for 3210 5.31 and higher
5. WellMate menu for 6150
6. NetMonitor
and for DCT4:
1. ALS (Alternative Line Service) option menu
2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
3. GPRS Always Online
4. and others...
nokiasetvibralevellevel
Set vibra power to "level" (given in percent)
nokiatuneradionokiavibratestSiemensspecificcommandssiemensnetmonactnetmon_type
Enables network monitor in Siemens phone. Currently known values for type are 1 for full and 2 for
simple mode.
siemensnetmonitortestsiemenssatnetmonNetworkcommandsgetgprspointstart[stop]listnetworks[country]
Show names/codes of GSM networks known for Gammu
networkinfo
Show information about network status from the phone.
setautonetworkloginWAPsettingsandbookmarkscommandsdeletewapbookmarkstart[stop]
Delete WAP bookmarks from phone.
Locations are numerated from 1.
getchatsettingsstart[stop]getsyncmlsettingsstart[stop]getwapbookmarkstart[stop]
Get WAP bookmarks from phone.
Locations are numerated from 1.
getwapsettingsstart[stop]
Get WAP settings from phone.
Locations are numerated from 1.
MMSandMMSsettingscommandsgetallmms[-save]geteachmms[-save]getmmsfoldersgetmmssettingsstart[stop]readmmsfilefile[-save]FMradiocommandsgetfmstationstart[stop]
Show info about FM stations in phone
Phoneinformationcommandsbattery
Displays information about battery and power source.
getdisplaystatusgetsecuritystatus
Show, if phone wait for security code (like PIN, PUK, etc.) or not
identify
Show the most important phone data.
monitor[times]
Retrieves phone status and writes it continuously to standard output. Press Ctrl+C to interrupt
this command.
If no parameter is given, the program runs until interrupted, otherwise only given number of
iterations is performed.
This command outputs almost all information Gammu supports:
• Number of contacts, calendar and todo entries, messages, calls, etc.
• Signal strength.
• Battery state.
• Currently used network.
• Notifications of incoming messages and calls.
Phonesettingscommandsgetcalendarsettings
Displays calendar settings like first day of week or automatic deleting of old entries.
getprofilestart[stop]resetphonesettingsPHONE|DEV|UIF|ALL|FACTORYWARNING:
This will delete user data, be careful.
Reset phone settings.
PHONE Clear phone settings.
DEV Clear device settings.
ALL Clear user settings.
• removes or set logos to default
• set default phonebook and other menu settings
• clear T9 words,
• clear call register info
• set default profiles settings
• clear user ringtones
UIF Clear user settings and disables hidden menus.
• changes like after ALL
• disables netmon and PPS (all "hidden" menus)
FACTORY
Reset to factory defaults.
• changes like after UIF
• clear date/time
DumpsdecodingcommandsNOTE:
These commands are available only if Gammu was compiled with debugging options.
decodebinarydumpfile[phonemodel]
Decodes a dump made by Gammu with LogFormat set to binary.
decodesniffMBUS2|IRDAfile[phonemodel]
Allows one to decode sniffs. See Discovering protocol for more details.
OthercommandsentersecuritycodePIN|PUK|PIN2|PUK2|PHONE|NETWORKcode|-[newpin|-]
Allow one to enter security code from PC. When code is -, it is read from stdin.
In case entering PUK, some phones require you to set new PIN as well.
presskeysequencemMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
Press specified key sequence on phone keyboard
mM Menu
nN Names key
pP Power
uU Up
dD Down
+- +-
gG Green
rR Red
123456789*0#
numeric keyboard
resetSOFT|HARD
Make phone reset:
SOFT without asking for PIN
HARD with asking for PIN
NOTE:
Some phones will ask for PIN even with SOFT option.
WARNING:
Some phones will reset user data on HARD reset.
setpowerON|OFF
New in version 1.33.90.
Turns off or on the phone.
NOTE:
This is usually required for built in modules in notebooks.
screenshotfilename
Captures phone screenshot and saves it as filename. The extension is automatically appended to
filename based on what data phone provides.
Batchmodecommandsbatch[file]
Starts Gammu in a batch mode. In this mode you can issue several commands each on one line. Lines
starting with # are treated as a comments.
By default, commands are read from standard input, but you can optionally specify a file from
where they would be read (special case - means standard input).
Configurationcommandssearchphone[-debug]
Attempts to search for a connected phone.
WARNING:
Please note that this can take a very long time, but in case you have no clue how to configure
phone connection, this is a convenient way to find working setup for Gammu.
install[-minimal]
Installs applet for currently configured connection to the phone.
You can configure search path for installation files by DataPath.
The -minimal parameter forces installation of applet only without possible support libraries, this
can be useful for updates.
Gammuinformationcommandscheckversion[STABLE]
Checks whether there is newer Gammu version available online (if Gammu has been compiled with
CURL). If you pass additional parameter STABLE, only stable versions will be checked.
features
Print information about compiled in features.
help[topic]
Print help. By default general help is printed, but you can also specify a help category to get
more detailed help on some topic.
version
Print version information and license.
Install Now
PNG Icons
Emojis
