This program is a tool for mobile phones. Many vendors and phones
are supported, for actual listing see Gammu Phones Database.
Parameters before command configure gammu behaviour:
- dialvoice number
[show|hide]
- Make voice call from SIM card line set in phone.
show|hide - optional parameter whether to disable call
number indication.
- getussd
code
- Retrieves USSD information - dials a service number and reads
response.
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.
Gammu has 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
- MMS
notifications
- contains links where phone should download MMS
- Alcatel logo
messages
- 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.
Text in SMS can be coded using two ways:
With GSM Default Alphabet 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
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.
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.
- deletesms folder
start [stop]
- Delete SMS from phone. See description for gammu getsms for info
about sms folders naming convention.
Locations are numerated from 1.
- getallsms
-pbk
- Get all SMS from phone. In some phones you will have also SMS templates
and info about locations used to save Picture Images. With each sms you
will see location. If you want to get such sms from phone alone, use
gammu getsms.
- geteachsms
-pbk
- Similiary to gammu getallsms. Difference is, that links all
concatenated sms
- getsms folder start
[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 gammu getsmsfolders to get folders list.
- savesms TYPE [type
parameters] [type options] [-folder id] [-unread] [-read] [-unsent] [-sent]
[-sender number] [-smsname name] [-smscset number] [-smscnumber number]
[-reply] [-maxsms num]
- Saves SMS to phone, see below for TYPE options.
- -smscset
number
- SMSC number will be taken from phone stored SMSC configuration
number.
Default: 1
- -folder
number
- save to specified folder.
Folders are numerated from 1.
The most often folder 1 = "Inbox", 2 =
"Outbox",etc. Use gammu 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
- -maxsms
num
- Limit maximum number of messages which will be created. If there are more
messages, Gammu will terminate with failure.
Types of messages:
- ANIMATION frames
file1 file2...
- 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...).
- BOOKMARK file
location
- Read WAP bookmark from file created by gammu backup command and
saves in Nokia format as SMS
- CALENDAR file
location
- Read calendar note from file created by gammu backup 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).
- CALLER
file
- 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.
- EMS [-unicode] [-16bit] [-format lcrasbiut] [-text text]
[-unicodefiletext file] [-defsound ID] [-defanimation ID] [-tone10 file]
[-tone10long file] [-tone12 file] [-tone12long file] [-toneSE file]
[-toneSElong file] [-fixedbitmap file] [-variablebitmap file]
[-variablebitmaplong file] [-animation frames file1 ...] [-protected
number]
- Saves EMS sequence. All format specific parameters (like -defsound)
can be used few times.
- -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
- -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)
- -format
lcrasbiut
- last text will be formatted. You can use combinations of chars:
| Character |
Formating |
| 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 |
- MMSINDICATOR
URL Title Sender
- 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.
- MMSSETTINGS
file location
- Saves a message with MMS configuration. The configuration will be read
from Gammu backup file from given location.
- OPERATOR file
[-netcode netcode] [-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.
- PICTURE file [-text
text] [-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 [-name name]
[-bitmap bitmap] [-ringtone ringtone]
- 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.
- RINGTONE file
[-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)
- TEXT [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len]
[-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax]
[-enableemail] [-disableemail] [-voidsms] [-replacemessages ID]
[-replacefile file] [-text msgtext] [-textutf8 msgtext]
- 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)
- -len len
- 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
- -autolen
len
- 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)
- -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
- 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):
- TODO file
location
- Saves a message with a todo entry. The content will be read from any
backup format which Gammu supports and from given location.
- VCARD10|VCARD21
file SM|ME location [-nokia]
- Read phonebook entry from file created by gammu backup 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).
- setsmsc location
number
- Set SMSC settings on SIM card. This keeps all SMSC configuration intact,
it just changes the SMSC number.
Locations are numerated from 1.
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
- searchmemory
text
- Scans all memory entries for given text. It performs case insensitive
substring lookup. You can interrupt searching by pressing
Ctrl+C.
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.
- 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)
NOTE:
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.
- getfolderlisting
folderID
- 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.
- sendfile
name
- 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.
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
- getbitmap TYPE
[type options]
- Reads bitmap from phone, following types are supported:
- 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.
- STARTUP
[file]
- Get static startup logo from phone. Allow one to save it in file.
- TEXT
- Get startup text from phone.
- setbitmap TYPE
[type options]
- Sets bitmap in phone, following types are supported:
- DEALER text
- 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.
- STARTUP
file|1|2|3
- Set startup logo in phone. It can be static (then you will have to give
file name) or one of predefined animated (only some phones like Nokia 3310
or 3330 supports it, use location 1, 2 or 3 for these).
- TEXT text
- Sets startup text in phone.
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).
- playringtone
file
- Play approximation of ringtone over phone buzzer. File can be in RTTL or
BINARY (Nokia DCT3) format.
- playsavedringtone
number
- Play one of built-in ringtones. This option is available for DCT4 phones.
For getting ringtones list use gammu getringtoneslist.
- setringtone
file [-location location] [-scale] [-name name]
- Set ringtone in phone. When don't give location, it will be written
"with preview" (in phones supporting this feature like 61xx or
6210).
- -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.
In Nokia 3310, 3315 and 3330 these are named "Reminders"
and have some limitations (depending on phone firmware version).
- getallnotes
- 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.
- 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.
NOTE:
Categories are supported only on few phones
(Alcatel).
- addnew file [-yes]
[-memory ME|SM|..]
- Adds data written in file created using gammu backup command. All
things backed up gammu backup 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.
- backup file
[-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.
- backupsms file
[-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.
- restore file
[-yes]
-
WARNING:
Please note that restoring deletes all current content in
phone. If you want only to add entries to phone, use gammu
addnew.
Restore settings written in file created using gammu backup
command.
In some phones restoring calendar notes will not show error, but
won't be done, when phone doesn't have set clock inside.
- restoresms file
[-yes]
-
WARNING:
Please note that this overwrites existing messages in
phone (if it supports it).
Restores SMSes from file (format like gammu backupsms uses)
to selected folder in phone.
- savefile TYPE [type
options]
- Converts between various file formats supported by Gammu, following types
are supported:
- CALENDAR
target.vcs file location
- 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).
- TODO target.vcs file
location
- 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|VCARD21
target.vcf file SM|ME location
- 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).
SEE ALSO:
- convertbackup
source.file output.file
- New in version 1.28.94.
Converts backup between formats supported by Gammu. Unlike
gammu savefile, this does not give you any options what to
convert, it simply takes converts all what can be saved into output
file.
SEE ALSO:
- nokiaaddfile
TYPE [type options]
- Uploads file to phone to specific location for the type:
- APPLICATION|GAME
file [-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.
- 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
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.
- nokiacomposer
file
- Show, how to enter RTTL ringtone in composer existing in many Nokia phones
(and how should it look like).
- nokiagetoperatorname
- 6110.c phones have place for name for one GSM network (of course, with
flashing it's possible to change all names, but Gammu is not flasher ;-)).
You can get this name using this option.
- nokiagett9
- This option should display T9 dictionary content from DCT4 phones.
- nokiagetvoicerecord
location
- Get voice record from location and save to WAV file. File is coded using
GSM 6.10 codec (available for example in win32). Name of file is like name
of voice record in phone.
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)
- nokianetmonitor
test
- Takes output or set netmonitor for Nokia DCT3 phones.
SEE ALSO:
For more info about this option, please visit Marcin's
page and read netmonitor manual there.
NOTE:
test 243 enables all tests (after using command
gammu nokianetmonitor 243 in some phones like 6210 or 9210 have to
reboot them to see netmonitor menu)
- nokianetmonitor36
- Reset counters from netmonitor test 36 in Nokia DCT3 phones.
SEE ALSO:
For more info about this option, please visit Marcin's
page and read netmonitor manual there.
- 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).
- 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...
- siemensnetmonact
netmon_type
- Enables network monitor in Siemens phone. Currently known values for type
are 1 for full and 2 for simple mode.
- networkinfo
- Show information about network status from the phone.
- battery
- Displays information about battery and power source.
- 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.
- getcalendarsettings
- Displays calendar settings like first day of week or automatic deleting of
old entries.
- resetphonesettings
PHONE|DEV|UIF|ALL|FACTORY
-
WARNING:
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
NOTE:
These commands are available only if Gammu was compiled
with debugging options.
- reset
SOFT|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.
- setpower
ON|OFF
- New in version 1.33.90.
Turns off or on the phone.
NOTE:
This is usually required for built in modules in
notebooks.
- screenshot
filename
- Captures phone screenshot and saves it as filename. The extension is
automatically appended to filename based on what data phone provides.
- batch [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).
- searchphone
[-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.
- checkversion
[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.
To check it out, you need to have configuration file for gammu,
see gammurc for more details about it.
NOTE:
All messages below are sent to number 123456, replace it
with proper destination.
Send text message up to standard 160 chars:
echo "All your base are belong to us" | gammu sendsms TEXT 123456
or
gammu sendsms TEXT 123456 -text "All your base are belong to us"
Send long text message:
echo "All your base are belong to us" | gammu sendsms TEXT 123456 -len 400
or
gammu sendsms TEXT 123456 -len 400 -text "All your base are belong to us"
or
gammu sendsms EMS 123456 -text "All your base are belong to us"
Send some funky message with predefined sound and animation from 2
bitmaps:
gammu sendsms EMS 123456 -text "Greetings" -defsound 1 -text "from Gammu -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
Send protected message with ringtone:
gammu sendsms EMS 123456 -protected 2 -variablebitmaplong ala.bmp -toneSElong axelf.txt -toneSE ring.txt
For example for retrieving prepaid card status or retrieving
various network info:
Add Alien to applications in your phone (you need to have files
Alien.JAD and Alien.JAR in current directory):
gammu nokiaaddfile APPLICATION Alien
Add file.mid to ringtones folder:
gammu nokiaaddfile TONES file.mid
Set logo for network 230 03 (Vodafone CZ):
gammu setbitmap OPERATOR ala.bmp "230 03"
The formats conversion can done using gammu savefile or
gammu convertbackup commands.
Convert single entry (at position 260) from gammu-backup to
vCalendar:
gammu savefile CALENDAR output.vcs myCalendar.backup 260
Convert first phonebook entry from gammu-backup to vCard:
gammu savefile VCARD21 output.vcf phone.backup ME 1
Convert all contacts from backup to vCard:
gammu convertbackup phone.backup output.vcf
There are definitely many bugs, reporting to author is welcome.
Please include some useful information when sending bug reports (especially
debug logs, operating system, it's version and phone information are
needed).
To generate debug log, enable it in gammurc:
[gammu]
YOUR CONNECTION SETTINGS
logfile = /tmp/gammu.log
logformat = textall
Alternatively you can specify logging on command line:
gammu -d textall -f /tmp/gammu.log ...
With this settings, Gammu generates /tmp/gammu.log on each
connection to phone and stores dump of communication there. You can also
find some hints for improving support for your phone in this log.
See <https://wammu.eu/support/bugs/> for more
information on reporting bugs.
Please report bugs to Gammu bug tracker.