GAMMU(1) Gammu Documentation GAMMU(1)

NAME Gammu - Does some neat things with your cellular phone or modem.

SYNTAX Usage: gammu [confign] [nothing|text|textall|binary|errors] [options]

DESCRIPTION This program is a tool for mobile phones. Many vendors and phones are supported, for actual listing see http://cihar.com/gammu/phonedb/.

OPTIONS First parameter optionally specifies which config section to use (all are probed by default). Second parameter optionally controls debug level, next one specifies actions.

   Commands can be specified with or without leading --.

Debug levels Parameters, which allow to control debug level:

   nothing - no debug level
   text    - transmission dump in text format
   textall - all possible info in text format
   errors  - errors in text format
   binary  - transmission dump in binary format

SMS and EMS Sending messages might look a bit complicated on first attempt to use. But be patient, the command line has been written in order to allow almost every usage. See EXAMPLES section for some hints on usage.

   addsms folder file
          Adds  SMSes  from  file (format like backupsms uses) to selected
          folder in phone.

   addsmsfolder name


   backupsms file
          Stores all SMSes from phone to file.

   deleteallsms folder
          Delete all SMS from specified SMS folder.


   deletesms folder start [stop]
          Delete SMS from phone. See description for getsms for info about
          sms folders naming convention. Locations are numerated from 1.


   displaysms ... (options like in sendsms)


   getallsms -pbk
          Get  all  SMS  from phone. In some phones you will have also SMS
          templates and info about locations used to save Picture  Images.
          With each sms you will see location. If you want to get such sms
          from phone alone, use gammu getsms 0 location


   geteachsms -pbk
          Similiary to getallsms. Difference is, that links  all  contace?
          nated sms


   getsms folder start [stop]
          Get SMS. Locations are numerated from 1.

          When  give  folder  0,  sms is given from "flat" memory (all sms
          from all folders have unique numbers). It’s  sometimes  emulated
          by Gammu.  You can use it with all phones.

          When  give  folder  1, 2, etc. sms are taken from Inbox, Outbox,
          etc.  and each sms has unique number  in  his  folder.  Name  of
          folders  can  depend  on  your  phone (the most often 1="Inbox",
          2="Outbox", etc.).  This method is not supported by  all  phones
          (for  example, not supported by Nokia 3310, 5110, 6110). If work
          with your phone, use getsmsfolders to get folders list.


   getsmsc [start [stop]]
          Get SMSC settings from SIM card. Numerate locations from 1.


   getsmsfolders
          Get names for SMS folders in phone


   nokiagett9


   restoresms file
          Restores  SMSes  from  file  (format  like  backupsms  uses)  to
          selected  folder  in  phone.  Please  note  that this overwrites
          existing messages in phone (if it supports it).

   savesms VCARD10|VCARD21  file  SM|ME  location  [-nokia]  [-folder  id]
   [-unread]  [-read]  [-unsent]  [-sent] [-sender number] [-smsname name]
   [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
          Read phonebook entry from file  created  by  backup  option  and
          saves  in  VCARD 1.0 (only name and default number) or VCARD 2.1
          (all entry details with all numbers, text and  name)  format  as
          SMS


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


   savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
   [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
   number] [-reply] [-maxsms num]
          Read  WAP  bookmark from file created by backup option and saves
          in Nokia format as SMS


   savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
   [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
   number] [-reply] [-maxsms num]
          Read calendar note from file created by backup option and  saves
          in VCALENDAR 1.0 format as SMS


   savesms  CALLER  file  [-folder id] [-unread] [-read] [-unsent] [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num]
          Save caller logo as sms (Nokia format - size 72x14).


   savesms  EMS  [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
   number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
   [-maxsms  num]  [-unicode]  [-16bit]  [-format  lcrasbiut] [-text text]
   [-unicodefiletext file]  [-defsound  ID]  [-defanimation  ID]  [-tone10
   file]  [-tone10long  file]  [-tone12  file] [-tone12long file] [-toneSE
   file] [-toneSElong file]  [-fixedbitmap  file]  [-variablebitmap  file]
   [-variablebitmaplong  file]  [-animation  frames file1 ...] [-protected
   number]

          Saves  EMS  sequence.  All  parameters after -unread (like -def?
          sound) can be used few times.

          -text - adds text

          -unicodefiletext - adds text from Unicode file

          -defanimation - adds default  animation  with  ID  specified  by
          user.ID for different phones are different.

          -animation - adds "frames" frames read from file1, file2, etc.

          -defsound - adds default sound with ID specified by user. ID for
          different phones are different.

          -tone10 - adds IMelody version 1.0 read from RTTL or other  com?
          patible file

          -tone10long  -  IMelody version 1.0 saved in one of few SMS with
          UPI. Phones compatible with UPI (like SonyEricsson phones)  will
          read such ringtone as one

          -tone12  - adds IMelody version 1.2 read from RTTL or other com?
          patible file

          -tone12long - IMelody version 1.0 saved in one of few  SMS  with
          UPI.  Phones compatible with UPI (like SonyEricsson phones) will
          read such ringtone as one

          -toneSE - adds IMelody in "short" form supported by SonyEricsson
          phones

          -tone10long  - SonyEricsson IMelody saved in one or few SMS with
          UPI

          -variablebitmap - bitmap in any size saved in one SMS

          -variablebitmaplong - bitmap with maximal size 96x128  saved  in
          one or few sms

          -fixedbitmap  - bitmap 16x16 or 32x32

          -protected  -  all  ringtones  and  bitmaps after this parameter
          (excluding default ringtones and logos) will be "protected"  (in
          phones  compatible  with ODI like SonyEricsson products it won’t
          be possible to forward them from phone menu)

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

          will create EMS sequence with text "Greetings" and default sound
          1 and text "from Gammu" and ringtone axelf.txt and 2 frame  ani?
          mation  read  from  (1’st  frame)  file1.bmp  and  (2’nd  frame)
          file2.bmp

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

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


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


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


   savesms  OPERATOR file [-folder id] [-unread] [-read] [-unsent] [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
          Save  operator  logo  as sms (Nokia format - size 72x14 or 78x21
          after using -biglogo).


   savesms PICTURE file [-folder id] [-unread] [-read]  [-unsent]  [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
          Save Picture Image as sms (Nokia format - size 72x28).


   savesms  PROFILE  [-folder  id]  [-unread]  [-read]  [-unsent]  [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num] [-name name] [-bitmap bitmap]  [-ringtone  ring?
   tone]
          Read ringtone (RTTL) format and bitmap (Picture Image size)  and
          name and save as Nokia profile.


   savesms  RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num] [-long] [-scale]
          Read RTTL ringtone from file and save as SMS into SIM/phone mem?
          ory.  Ringtone is saved in Nokia format.

          -folder number - save to  specified  folder.  Numerate  forlders
          from 1.  The most often folder 1 = "Inbox", 2 = "Outbox", etc.

          -unread  -  makes message unread. In some phones (like 6210) you
          won’t see unread sms envelope after saving  such  sms.  In  some
          phones  with internal SMS memory (like 6210) after using it with
          folder 1 SIM SMS memory will be used

          -read - makes message read. In some  phones  with  internal  SMS
          memory  (like  6210) after using it with folder 1 SIM SMS memory
          will be used -unsent - makes message unsent

          -reply - reply SMSC is set

          -sender number - set sender number

          -flash - Class 0 SMS

          -smscset number - SMSC will be taken from  set  number.  Default
          set: 1

          -smscnumber number - SMSC number

          -long  - ringtone is saved using Profile style. It can be longer
          (and saved in 2 SMS), but decoded only  by  newer  phones  (like
          33xx)

          -scale  -  ringtone  will have Scale info for each note. It will
          allow to edit it correctly later in phone composer (for example,
          in 33xx)


   savesms  SMSTEMPLATE  [-folder  id] [-unread] [-read] [-unsent] [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply]  [-maxsms num] [-unicode] [-text text] [-unicodefiletext file]
   [-defsound ID] [-defanimation ID]  [-tone10  file]  [-tone10long  file]
   [-tone12  file]  [-tone12long  file]  [-toneSE file] [-toneSElong file]
   [-variablebitmap file] [-variablebitmaplong  file]  [-animation  frames
   file1 ...]


   savesms  TEXT [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
   number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
   [-maxsms  num]  [-inputunicode]  [-16bit] [-flash] [-len len] [-autolen
   len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax]  [-disable?
   fax]  [-enableemail]  [-disableemail]  [-voidsms] [-replacemessages ID]
   [-replacefile file]
          Take text from stdin and save as text SMS into SIM/phone memory.

          -folder number - save to specified folder. Numerate folders from
          1.   The  most  often  folder 1 = "Inbox", 2 = "Outbox",etc. Use
          getsmsfolders to get folder list.

          -unread - makes message unread. In some phones (like  6210)  you
          won’t  see  unread  sms  envelope after saving such sms. In some
          phones with internal SMS memory (like 6210) after using it  with
          folder 1 SIM SMS memory will be used

          -read  -  makes  message  read. In some phones with internal SMS
          memory (like 6210) after using it with folder 1 SIM  SMS  memory
          will be used

          -unsent - makes message unsent

          -reply - reply SMSC is set

          -sender number - set sender number (default: "Gammu")

          -flash - Class 0 SMS

          -smscset  number  -  SMSC will be taken from set number. Default
          set: 1

          -smscnumber number - SMSC number

          -len len - specify, how many chars will be read. When  use  this
          option and text will be longer than 1 SMS, will be splitted into
          more linked SMS

          -autolen len - specify, how many chars will be  read.  When  use
          this option and text will be longer than 1 SMS, will be splitted
          into more linked SMS.Coding type (SMS default  alphabet/Unicode)
          is set according to input text

          -enablevoice  |  -disablevoice  |  -enablefax   | -disablefax  |
          -enableemail  | -disableemail  - sms will set  such  indicators.
          Text will be cut to 1 sms.

          -voidsms  -  many  phones  after receiving it won’t display any?
          thing, only beep, vibrate or turn on light. Text will be cut  to
          1 sms.

          -unicode - SMS will be saved in Unicode format

          -inputunicode - input text is in Unicode.

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

          -replacemessages  ID  - ID can be 1..7. When you will use option
          and send more single SMS to one recipient with the same ID, each
          another SMS will replace each previous with the same ID

          -replacefile  file   -  when you want, you can make file in such
          format:            src_unicode_char1,dest_unicode_char1,src_uni?
          code_char2,dest_unicode_char2  (everything  in  one line). After
          reading text for SMS from stdin there will be  made  translation
          and  each src char will be converted to dest char. In docs there
          is example file (replace.txt), which will change all  "a"  chars
          to "1"

          TIP:  when  use  ~ char in sms text and -unicode option (Unicode
          coding required), text of sms after ~ char will  blink  in  some
          phones (like N33xx)

          Example: echo some_text | gammu savesms TEXT


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


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


   savesms  WAPSETTINGS  file  location  DATA|GPRS  [-folder id] [-unread]
   [-read] [-unsent] [-sent] [-sender number]  [-smsname  name]  [-smscset
   number] [-smscnumber number] [-reply] [-maxsms num]
          Read  WAP  settings from file created by backup option and saves
          in Nokia format as SMS


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


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


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


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


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


   sendsms       EMS        destination        [-report]        [-validity
   HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num?
   ber] [-smscnumber number] [-reply] [-maxsms  num]  [-unicode]  [-16bit]
   [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID]
   [-defanimation ID] [-tone10 file]  [-tone10long  file]  [-tone12  file]
   [-tone12long  file]  [-toneSE  file]  [-toneSElong  file] [-fixedbitmap
   file] [-variablebitmap  file]  [-variablebitmaplong  file]  [-animation
   frames file1 ...] [-protected number]


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


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


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


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


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


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


   sendsms     SMSTEMPLATE      destination      [-report]      [-validity
   HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]] [-smscset num?
   ber] [-smscnumber number]  [-reply]  [-maxsms  num]  [-unicode]  [-text
   text]   [-unicodefiletext   file]  [-defsound  ID]  [-defanimation  ID]
   [-tone10 file] [-tone10long file]  [-tone12  file]  [-tone12long  file]
   [-toneSE   file]  [-toneSElong  file]  [-variablebitmap  file]  [-vari?
   ablebitmaplong file] [-animation frames file1 ...]


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


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


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


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


   sendsmsdsms TEXT|WAPSETTINGS|... destination FILES|MYSQL|PGSQL  config?
   file ... (options like in sendsms)


   smsd FILES configfile
          SMS Deaemon. See smsdrc config file for more options


   smsd MYSQL configfile


   smsd PGSQL configfile

Memory (phonebooks and calls) addcategory TODO|PHONEBOOK text

   addnew file [-yes]
          Adds settings written in file created using backup  option.  All
          things  backup’ed by backup can be restored (when made backup to
          Gammu text file).


   backup file [-yes]
          Backup your phone to file. It’s possible to backup  (depends  on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          *  user  ringtones  BSLen  use  text  backup  files. List can be
          extended on request.

          TIP: if you will backup settings to Gammu text file, it will  be
          possible to edit it. It’s easy: many things in this file will be
          written double - once in Unicode, once in ASCII. When  you  will
          remove  Unicode version Gammu will use ASCII on restore (and you
          can easy edit ASCII text) and will convert it according to  your
          OS  locale.  When  will be available Unicode version of text, it
          will be used instead of ASCII (usefull with Unicode phones -  it
          isn’t  important,  what locale is set in computer and no conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/ with regular expressions based on  POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:   Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          *  to  change  phone numbers type to mobile for numbers starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:     Type     =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   clearall


   deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]


   getallcategory TODO|PHONEBOOK


   getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL


   getcategory TODO|PHONEBOOK start [stop]


   getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]
          Get memory location from phone. Numerate locations from 1.

          DC = Dialled calls
          MC = Missed calls
          RC = Received calls
          ON = Own numbers
          VM = voice mailbox
          SM = SIM phonebook
          ME = phone internal phonebook
          FD = fixed dialling
          SL = sent SMS log


   getspeeddial start [stop]


   listmemorycategory text|number


   nokiagetpbkfeatures memorytype


   restore file [-yes]
          Restore  settings  written  in file created using backup option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.


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


   savesms  VCARD10|VCARD21  file  SM|ME  location  [-nokia]  [-folder id]
   [-unread] [-read] [-unsent] [-sent] [-sender  number]  [-smsname  name]
   [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
          Read  phonebook  entry  from  file  created by backup option and
          saves in VCARD 1.0 (only name and default number) or  VCARD  2.1
          (all  entry  details  with all numbers, text and name) format as
          SMS


   searchmemory text


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

Filesystem addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT] [-readonly] [-protected] [-system] [-hidden] [-newtime] Add file with specified name to folder with specified folder ID.

          -type  - file type was required for filesystem 1 in Nokia phones
          (current filesystem 2 doesn’t need this)

          -readonly, -protected, -system, -hidden - you can set  readonly,
          protected (file can’t be for example forwarded from phone menu),
          system  and  hidden  (file  is  hidden  from  phone  menu)  file
          attributes

          -newtime - after using it date/time of file modification will be
          set to moment of uploading



   addfolder parentfolderID name


   deletefiles fileID


   deletefolder name


   getfilefolder ID1, ID2, ...


   getfiles ID1, ID2, ...


   getfilesystem [-flatall|-flat]
          Display info about all folders and files in phone  memory/memory
          card. By default there is tree displayed, you can change it:

          -flatall  there  are  displayed full file/folder details like ID
          (first parameter in line)

          -flat

          Please note, that in some phones (like N6230)  content  of  some
          folders (with more files) can be cut (only part of files will be
          displayed) for example on infrared connection. This is not Gammu
          issue, but phone firmware problem.


   getfilesystemstatus


   getfolderlisting folderID

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

          Please note, that in some phones (like N6230)  content  of  some
          folders (with more files) can be cut (only part of files will be
          displayed) for example on infrared connection. This is not Gammu
          issue, but phone firmware problem.


   getrootfolders

          Display info about drives available in phone/memory card.


   nokiaaddfile                                      Gallery|Gallery2|Cam?
   era|Tones|Tones2|Records|Video|Playlist|MemoryCard  file  [-name  name]
   [-protected] [-readonly] [-system] [-hidden] [-newtime]
          Install the *.jar/*.jad file pair of a midlet in the application
          or game menu of the phone. You have to give the name without the
          jar/jad  suffix,  otherwise  you will get the slightly confusing
          error message Can’t open specified file. Read only ?

          Example:  gammu  nokiaaddfile  Application   Alien   will   read
          Alien.JAD and Alien.JAR and add to Applications

          Example:  gammu  nokiaaddfile  Tones file.mid will read file.mid
          and add to Tones folder


   nokiaaddplaylists


   sendfile name


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

Logo and pictures copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]] Allow to convert logos files to another. When give ONLY input? file, output will be written to stdout using ASCII art. When give output file and format, in some file formats (like NLM) will be set indicator informing about logo type to given.

   getbitmap DEALER
          In  some models it’s possible to save dealer welcome note - text
          displayed during enabling phone,  which  can’t  be  edited  from
          phone menu.  Here you can get it.


   getbitmap CALLER location [file]
          Get caller group logo from phone. Locations 1-5.


   getbitmap OPERATOR [file]
          Get  operator  logo (picture displayed instead of operator name)
          from phone.


   getbitmap PICTURE location [file]
          Get Picture Image from phone.


   getbitmap STARTUP [file]
          Get static startup logo from phone. Allow to save it in file.


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


   savesms CALLER file [-folder id] [-unread]  [-read]  [-unsent]  [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num]
          Save caller logo as sms (Nokia format - size 72x14).


   savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent]  [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
          Save operator logo as sms (Nokia format - size  72x14  or  78x21
          after using -biglogo).


   savesms  PICTURE  file [-folder id] [-unread] [-read] [-unsent] [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]
          Save Picture Image as sms (Nokia format - size 72x28).


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


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


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


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


   setbitmap CALLER location [file]
          Set caller logo.


   setbitmap COLOUROPERATOR [fileID [netcode]]


   setbitmap COLOURSTARTUP [fileID]


   setbitmap DEALER text


   setbitmap OPERATOR [file [netcode]]
          Set  operator  logo  in phone. When won’t give file and netcode,
          operator logo will be removed from phone. When  will  give  only
          filename,  operator  logo will be displayed for your current GSM
          operator. When give additionaly network code, it  will  be  dis?
          played for this operator: gammu setbitmap OPERATOR file "260 02"


   setbitmap PICTURE file location [text]


   setbitmap STARTUP file|1|2|3
          Set startup logo in phone. It can be static (then you will  have
          to  give  file  name)  or  one of predefined animated (only some
          phones like Nokia 3310 or 3330 supports it)


   setbitmap TEXT text


   setbitmap WALLPAPER fileID

Ringtones addnew file [-yes] Adds settings written in file created using backup option. All things backup’ed by backup can be restored (when made backup to Gammu text file).

   backup file [-yes]
          Backup your phone to file. It’s possible to backup  (depends  on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          *  user  ringtones  BSLen  use  text  backup  files. List can be
          extended on request.

          TIP: if you will backup settings to Gammu text file, it will  be
          possible to edit it. It’s easy: many things in this file will be
          written double - once in Unicode, once in ASCII. When  you  will
          remove  Unicode version Gammu will use ASCII on restore (and you
          can easy edit ASCII text) and will convert it according to  your
          OS  locale.  When  will be available Unicode version of text, it
          will be used instead of ASCII (usefull with Unicode phones -  it
          isn’t  important,  what locale is set in computer and no conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/ with regular expressions based on  POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:   Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          *  to  change  phone numbers type to mobile for numbers starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:     Type     =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   clearall


   copyringtone source destination [RTTL|BINARY]
          Copy source ringtone to destination.


   getphoneringtone location [file]

          Get one of "default" ringtones and saves into file


   getringtone location [file]
          Get  ringtone from phone in RTTL or BINARY format. Locations are
          numerated from 1.


   getringtoneslist


   nokiacomposer file
          Show, how to enter RTTL ringtone in composer  existing  in  many
          Nokia phones (and how should it look like).


   playringtone file
          Play  aproximation of ringtone over phone buzzer. File can be in
          RTTL or BINARY (Nokia DCT3) format.


   playsavedringtone number

          Play one of "built" ringtones. This option is available for DCT4
          phones. For getting ringtones list use getringtoneslist.


   restore file [-yes]
          Restore  settings  written  in file created using backup option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.


   savesms  RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply] [-maxsms num] [-long] [-scale]
          Read RTTL ringtone from file and save as SMS into SIM/phone mem?
          ory.  Ringtone is saved in Nokia format.

          -folder number - save to  specified  folder.  Numerate  forlders
          from 1.  The most often folder 1 = "Inbox", 2 = "Outbox", etc.

          -unread  -  makes message unread. In some phones (like 6210) you
          won’t see unread sms envelope after saving  such  sms.  In  some
          phones  with internal SMS memory (like 6210) after using it with
          folder 1 SIM SMS memory will be used

          -read - makes message read. In some  phones  with  internal  SMS
          memory  (like  6210) after using it with folder 1 SIM SMS memory
          will be used -unsent - makes message unsent

          -reply - reply SMSC is set

          -sender number - set sender number

          -flash - Class 0 SMS

          -smscset number - SMSC will be taken from  set  number.  Default
          set: 1

          -smscnumber number - SMSC number

          -long  - ringtone is saved using Profile style. It can be longer
          (and saved in 2 SMS), but decoded only  by  newer  phones  (like
          33xx)

          -scale  -  ringtone  will have Scale info for each note. It will
          allow to edit it correctly later in phone composer (for example,
          in 33xx)


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


   setringtone file [-location location] [-scale] [-name name]
          Set  ringtone  in  phone.  When  don’t give location, it will be
          written "with preview" (in phones supporting this  feature  like
          61xx  or  6210).  When use RTTL ringtones, give location and use
          -scale, there will be written scale info with each note. It will
          avoid  scale  problems available during editing ringtone in com?
          poser from phone menu (for example, in N33xx).

          TIP: when use ~ char in ringtone  name,  in  some  phones  (like
          33xx) name will blink later in phone menus

Calendar notes addnew file [-yes] Adds settings written in file created using backup option. All things backup’ed by backup can be restored (when made backup to Gammu text file).

   backup file [-yes]
          Backup  your  phone to file. It’s possible to backup (depends on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          * user ringtones BSLen  use  text  backup  files.  List  can  be
          extended on request.

          TIP:  if you will backup settings to Gammu text file, it will be
          possible to edit it. It’s easy: many things in this file will be
          written  double  - once in Unicode, once in ASCII. When you will
          remove Unicode version Gammu will use ASCII on restore (and  you
          can  easy edit ASCII text) and will convert it according to your
          OS locale. When will be available Unicode version  of  text,  it
          will  be used instead of ASCII (usefull with Unicode phones - it
          isn’t important, what locale is set in computer and  no  conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/  with regular expressions based on POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:    Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text   =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          * to change phone numbers type to mobile  for  numbers  starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:    Type    =     NumberGeneral\nEntry\([0-9][0-9]\)Text     =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   clearall


   deletecalendar start [stop]


   getallcalendar


   getcalendar start [stop]


   getcalendarsettings


   restore file [-yes]
          Restore settings written in file created  using  backup  option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.


   savefile CALENDAR target.vcs file location


   savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
   [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
   number] [-reply] [-maxsms num]
          Read calendar note from file created by backup option and  saves
          in VCALENDAR 1.0 format as SMS


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

To do lists addcategory TODO|PHONEBOOK text

   addnew file [-yes]
          Adds  settings  written in file created using backup option. All
          things backup’ed by backup can be restored (when made backup  to
          Gammu text file).


   backup file [-yes]
          Backup  your  phone to file. It’s possible to backup (depends on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          * user ringtones BSLen  use  text  backup  files.  List  can  be
          extended on request.

          TIP:  if you will backup settings to Gammu text file, it will be
          possible to edit it. It’s easy: many things in this file will be
          written  double  - once in Unicode, once in ASCII. When you will
          remove Unicode version Gammu will use ASCII on restore (and  you
          can  easy edit ASCII text) and will convert it according to your
          OS locale. When will be available Unicode version  of  text,  it
          will  be used instead of ASCII (usefull with Unicode phones - it
          isn’t important, what locale is set in computer and  no  conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/  with regular expressions based on POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:    Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text   =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          * to change phone numbers type to mobile  for  numbers  starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:    Type    =     NumberGeneral\nEntry\([0-9][0-9]\)Text     =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   clearall


   deletetodo start [stop]


   getallcategory TODO|PHONEBOOK


   getalltodo


   getcategory TODO|PHONEBOOK start [stop]


   gettodo start [stop]


   listtodocategory text|number


   restore file [-yes]
          Restore settings written in file created  using  backup  option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.


   savefile TODO target.vcs file location


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


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

Notes getallnotes

Date, time and alarms getalarm [start] Get alarm from phone, if no location is specified, 1 is used.

   getdatetime
          Get date and time from phone


   setalarm hour minute
          Sets repeating alarm in phone on selected time.

   setdatetime [HH:MM[:SS]] [YYYY/MM/DD]
          Set date and time in phone to date and  time  set  in  computer.
          Please  note,  that  this  option  doesn’t  show  clock on phone
          screen. It only set date and time.

          TIP: you can make such synchronization each time, when will con?
          nect your phone and use Gammu. See gammurc for details.

Categories addcategory TODO|PHONEBOOK text

   addnew file [-yes]
          Adds  settings  written in file created using backup option. All
          things backup’ed by backup can be restored (when made backup  to
          Gammu text file).


   backup file [-yes]
          Backup  your  phone to file. It’s possible to backup (depends on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          * user ringtones BSLen  use  text  backup  files.  List  can  be
          extended on request.

          TIP:  if you will backup settings to Gammu text file, it will be
          possible to edit it. It’s easy: many things in this file will be
          written  double  - once in Unicode, once in ASCII. When you will
          remove Unicode version Gammu will use ASCII on restore (and  you
          can  easy edit ASCII text) and will convert it according to your
          OS locale. When will be available Unicode version  of  text,  it
          will  be used instead of ASCII (usefull with Unicode phones - it
          isn’t important, what locale is set in computer and  no  conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/  with regular expressions based on POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:    Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text   =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          * to change phone numbers type to mobile  for  numbers  starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:    Type    =     NumberGeneral\nEntry\([0-9][0-9]\)Text     =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   clearall


   getallcategory TODO|PHONEBOOK


   getcategory TODO|PHONEBOOK start [stop]


   listmemorycategory text|number


   listtodocategory text|number


   restore file [-yes]
          Restore settings written in file created  using  backup  option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.

Backing up and restoring addnew file [-yes] Adds settings written in file created using backup option. All things backup’ed by backup can be restored (when made backup to Gammu text file).

   addsms folder file
          Adds SMSes from file (format like backupsms  uses)  to  selected
          folder in phone.

   backup file [-yes]
          Backup  your  phone to file. It’s possible to backup (depends on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          * user ringtones BSLen  use  text  backup  files.  List  can  be
          extended on request.

          TIP:  if you will backup settings to Gammu text file, it will be
          possible to edit it. It’s easy: many things in this file will be
          written  double  - once in Unicode, once in ASCII. When you will
          remove Unicode version Gammu will use ASCII on restore (and  you
          can  easy edit ASCII text) and will convert it according to your
          OS locale. When will be available Unicode version  of  text,  it
          will  be used instead of ASCII (usefull with Unicode phones - it
          isn’t important, what locale is set in computer and  no  conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/  with regular expressions based on POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:    Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text   =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          * to change phone numbers type to mobile  for  numbers  starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:    Type    =     NumberGeneral\nEntry\([0-9][0-9]\)Text     =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   backupsms file
          Stores all SMSes from phone to file.

   restore file [-yes]
          Restore settings written in file created  using  backup  option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.


   restoresms file
          Restores  SMSes  from  file  (format  like  backupsms  uses)  to
          selected  folder  in  phone.  Please  note  that this overwrites
          existing messages in phone (if it supports it).

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


   savefile BOOKMARK target.url file location


   savefile CALENDAR target.vcs file location


   savefile TODO target.vcs file location

Nokia specific nokiaaddfile Gallery|Gallery2|Cam? era|Tones|Tones2|Records|Video|Playlist|MemoryCard file [-name name] [-protected] [-readonly] [-system] [-hidden] [-newtime] Install the .jar/.jad file pair of a midlet in the application or game menu of the phone. You have to give the name without the jar/jad suffix, otherwise you will get the slightly confusing error message Can’t open specified file. Read only ?

          Example:   gammu   nokiaaddfile   Application  Alien  will  read
          Alien.JAD and Alien.JAR and add to Applications

          Example: gammu nokiaaddfile Tones file.mid  will  read  file.mid
          and add to Tones folder


   nokiaaddplaylists


   nokiacomposer file
          Show,  how  to  enter RTTL ringtone in composer existing in many
          Nokia phones (and how should it look like).


   nokiadebug filename [[v11-22] [,v33-44]...]


   nokiadisplayoutput


   nokiadisplaytest number


   nokiagetadc


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


   nokiagetpbkfeatures memorytype


   nokiagetscreendump


   nokiagett9


   nokiagetvoicerecord location

          Get  voice  record  from  location and save to WAV file. File is
          coded using GSM 6.10 codec (available  for  example  in  win32).
          Name of file is like name of voice record in phone.


   nokiamakecamerashoot


   nokianetmonitor test
          Takes output or set netmonitor for Nokia DCT3 phones.

          TIP:   For   more   info   about   this   option,  please  visit
          http://www.mwiacek.com and read netmonitor manual.

          TIP: test 243 enables  all  tests  (after  using  command  gammu
          nokianetmonitor  243  in  some  phones like 6210 or 9210 have to
          reboot them to see netmonitor menu)


   nokianetmonitor36
          Reset counters from netmonitor test 36 in Nokia DCT3 phones.

          TIP:  For  more   info   about   this   option,   please   visit
          www.mwiacek.com and read netmonitor manual.


   nokiasecuritycode
          Get/reset to "12345" security code


   nokiaselftests


   nokiasetlights keypad|display|torch on|off


   nokiasetoperatorname [networkcode name]


   nokiasetphonemenus
          Enable all (?) possible menus for DCT3 Nokia phones:

          1. ALS (Alternative Line Service) option menu
          2. vibra menu for 3210
          3. 3315 features in 3310 5.45 and higher
          4.  two  additional  games  (React  and Logic) for 3210 5.31 and
          higher
          5. WellMate menu for 6150
          6. NetMonitor

          and for DCT4:

          1. ALS (Alternative Line Service) option menu
          2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
          3. GPRS Always Online


   nokiasetvibralevel level
          Set vibra power to "level" (given in percent)


   nokiatuneradio


   nokiavibratest

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

   siemensnetmonitor test


   siemenssatnetmon

Network getgprspoint start [stop]

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


   monitor [times]
          Get phone status and writes  continuously  to  standard  output.
          Press Ctrl+C to break this state.


   networkinfo


   nokiadebug filename [[v11-22] [,v33-44]...]


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


   nokianetmonitor test
          Takes output or set netmonitor for Nokia DCT3 phones.

          TIP:  For  more   info   about   this   option,   please   visit
          http://www.mwiacek.com and read netmonitor manual.

          TIP:  test  243  enables  all  tests  (after using command gammu
          nokianetmonitor 243 in some phones like 6210  or  9210  have  to
          reboot them to see netmonitor menu)


   nokiasetoperatorname [networkcode name]


   setautonetworklogin


   siemensnetmonact netmon_type (1-full, 2-simple)


   siemensnetmonitor test


   siemenssatnetmon

WAP settings and bookmarks addnew file [-yes] Adds settings written in file created using backup option. All things backup’ed by backup can be restored (when made backup to Gammu text file).

   backup file [-yes]
          Backup  your  phone to file. It’s possible to backup (depends on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          * user ringtones BSLen  use  text  backup  files.  List  can  be
          extended on request.

          TIP:  if you will backup settings to Gammu text file, it will be
          possible to edit it. It’s easy: many things in this file will be
          written  double  - once in Unicode, once in ASCII. When you will
          remove Unicode version Gammu will use ASCII on restore (and  you
          can  easy edit ASCII text) and will convert it according to your
          OS locale. When will be available Unicode version  of  text,  it
          will  be used instead of ASCII (usefull with Unicode phones - it
          isn’t important, what locale is set in computer and  no  conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/  with regular expressions based on POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:    Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text   =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          * to change phone numbers type to mobile  for  numbers  starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:    Type    =     NumberGeneral\nEntry\([0-9][0-9]\)Text     =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   clearall


   deletewapbookmark start [stop]
          Delete WAP bookmark(s) from phone. Locations are numerated  from
          1.


   getchatsettings start [stop]


   getsyncmlsettings start [stop]


   getwapbookmark start [stop]
          Get  WAP bookmark(s) from phone. Locations are numerated from 1.


   getwapsettings start [stop]
          Get WAP settings from phone. Locations are numerated from 1.


   restore file [-yes]
          Restore settings written in file created  using  backup  option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.


   savefile BOOKMARK target.url file location


   savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
   [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
   number] [-reply] [-maxsms num]
          Read WAP bookmark from file created by backup option  and  saves
          in Nokia format as SMS


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


   savesms  WAPSETTINGS  file  location  DATA|GPRS  [-folder id] [-unread]
   [-read] [-unsent] [-sent] [-sender number]  [-smsname  name]  [-smscset
   number] [-smscnumber number] [-reply] [-maxsms num]
          Read  WAP  settings from file created by backup option and saves
          in Nokia format as SMS


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


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


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

MMS and MMS settings getallmms [-save]

   geteachmms [-save]


   getmmsfolders


   getmmssettings start [stop]


   readmmsfile file [-save]


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


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


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


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

Phone tests nokiadisplaytest number

   nokiagetadc


   nokiaselftests


   nokiasetlights keypad|display|torch on|off


   nokiavibratest

FM radio addnew file [-yes] Adds settings written in file created using backup option. All things backup’ed by backup can be restored (when made backup to Gammu text file).

   backup file [-yes]
          Backup your phone to file. It’s possible to backup  (depends  on
          phone):

          * phonebook from SIM and phone memory
          * calendar notes
          * SMSC settings
          * operator logo
          * startup (static) logo or startup text
          * WAP bookmarks
          * WAP settings
          * caller logos and groups
          *  user  ringtones  BSLen  use  text  backup  files. List can be
          extended on request.

          TIP: if you will backup settings to Gammu text file, it will  be
          possible to edit it. It’s easy: many things in this file will be
          written double - once in Unicode, once in ASCII. When  you  will
          remove  Unicode version Gammu will use ASCII on restore (and you
          can easy edit ASCII text) and will convert it according to  your
          OS  locale.  When  will be available Unicode version of text, it
          will be used instead of ASCII (usefull with Unicode phones -  it
          isn’t  important,  what locale is set in computer and no conver?
          sion Unicode -> ASCII and ASCII -> Unicode is done).

          TIP: you can use any editor with regular expressions function to
          edit   backup   text   file.   Example:   TextPad   4.2.2   from
          http://www.textpad.com/ with regular expressions based on  POSIX
          standard P1003.2 is OK for it.  Few examples for it:

          * to remove info about voice tags:
          FROM: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n
          TO:

          * to change all numbers starting from +3620, +3630, +3660, +3670
          to +3620
          Find:   Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
          "\+36\(20\|30\|60\|70\)
          Repl: Type = NumberMobile\nEntry\1Text = "\+3620

          *  to  change  phone numbers type to mobile for numbers starting
          from +3620, +3630,... and removing the corresponding TextUnicode
          line
          F:     Type     =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
          "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
          \([^\n]*\)\n
          R: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n


   clearall


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


   nokiatuneradio


   restore file [-yes]
          Restore  settings  written  in file created using backup option.
          All things backup’ed by backup can be restored (when made backup
          to Gammu text file).

          Please note that restoring deletes all current content in phone.
          If you want only to add entries to phone, use addnew.

          In some phones restoring calendar notes will not show error, but
          won’t be done, when phone doesn’t have set clock inside.

Phone information getdisplaystatus

   getsecuritystatus
          Show,  if  phone wait for security code (like PIN, PUK, etc.) or
          not


   identify
          Show the most important phone data.


   monitor [times]
          Get phone status and writes  continuously  to  standard  output.
          Press Ctrl+C to break this state.


   nokiasecuritycode
          Get/reset to "12345" security code

Phone settings getcalendarsettings

   getprofile start [stop]


   resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
          Reset phone settings. BE CAREFULL !!!!

          PHONE:

          DEV:

          ALL: Clear user settings
          * removes or set logos to default
          * set default phonebook and other menu settings
          * clear T9 words,
          * clear call register info
          * set default profiles settings
          * clear user ringtones

          UIF:
          * changes like after ALL
          * disables netmon and PPS (all "hidden" menus)

          FACTORY:
          * changes like after UIF
          * clear date/time


   savesms  PROFILE  [-folder  id]  [-unread]  [-read]  [-unsent]  [-sent]
   [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
   [-reply]  [-maxsms  num] [-name name] [-bitmap bitmap] [-ringtone ring?
   tone]
          Read  ringtone (RTTL) format and bitmap (Picture Image size) and
          name and save as Nokia profile.


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

Dumps decoding decodebinarydump file [phonemodel] After using option logfile with name binary (see /readme.txt for info about this method of reporting bugs) created file can be decoded using this option. It’s available only, if Gammu was compiled with debug.

   decodesniff MBUS2|IRDA file [phonemodel]
          Option  available only, if Gammu was compiled with debug. Allows
          to  decode  sniffs.  See  /docs/develop/develop.txt   for   more
          details.


   makeconverttable file

Functions that don’t fit elsewhere batch [file]

   entersecuritycode PIN|PUK|PIN2|PUK2 code
          Allow to enter security code from PC


   nokiagetscreendump


   nokiagetvoicerecord location

          Get  voice  record  from  location and save to WAV file. File is
          coded using GSM 6.10 codec (available  for  example  in  win32).
          Name of file is like name of voice record in phone.


   nokiamakecamerashoot


   nokiasetphonemenus
          Enable all (?) possible menus for DCT3 Nokia phones:

          1. ALS (Alternative Line Service) option menu
          2. vibra menu for 3210
          3. 3315 features in 3310 5.45 and higher
          4.  two  additional  games  (React  and Logic) for 3210 5.31 and
          higher
          5. WellMate menu for 6150
          6. NetMonitor

          and for DCT4:

          1. ALS (Alternative Line Service) option menu
          2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
          3. GPRS Always Online


   nokiasetvibralevel level
          Set vibra power to "level" (given in percent)


   presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
          Press specified key sequence on phone keyboard

          mM - Menu
          nN - Names key
          pP - Power
          uU - Up
          dD - Down
          +- - +-
          gG - Green
          rR - Red
          123456789*0# is numeric keyboard


   reset SOFT|HARD
          Make phone reset: soft (without asking for PIN)  or  hard  (with
          PIN).

          Note: some phones will make hard reset even with SOFT option.


   searchphone [-debug]

Gammu information features

   help   Output help information and exit.


   version
          Output version information and exit.

SMS daemon sendsmsdsms TEXT|WAPSETTINGS|… destination FILES|MYSQL|PGSQL config? file … (options like in sendsms)

   smsd FILES configfile
          SMS Deaemon. See smsdrc config file for more options


   smsd MYSQL configfile


   smsd PGSQL configfile

FILES ~/.gammurc /usr/share/doc/gammu/* /dev/ircomm? /dev/ttyS? /dev/ttyACM?

EXAMPLES To check it out, edit ~/.gammurc and put there something like

   [gammu]
   port = /dev/ttyACM0
   connection = at


   Save text message up to standard 160 chars:

          echo "All your base are belong to us" | gammu savesms TEXT


   Save long text message:

          echo  "All  your  base  are  belong  to us" | gammu savesms TEXT
          -maxlen 400

          gammu savesms EMS -text "All your base are belong to us"


   Save some funky message with predefined  sound  and  animation  from  2
   bitmaps:

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


   Save protected message with ringtone:

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

LICENSE This program is licensed under GNU/GPL version 2.

BUGS There are definitely many bugs, reporting to author is welcome. Please include some useful information when sending bug reports (especially debug logs, operating system, it’s version and phone information are needed).

   To  generate debug log, either enable in gammurc (alternatively you can
   do it on command line, but gammurc way allows separating debug log from
   other output):

       logfile = /tmp/gammu.log
       logformat = textall

   With  this  settings, Gammu generates /tmp/gammu.log on each connection
   to phone and stores dump of communication there. You can also find some
   hints for improving support for your phone in this log.

AUTHORS You can contact authors on gammu-users@lists.sourceforge.net.

   Michal  Cihar <michal@cihar.com> is current project maintainer and con?
   tributor of most of AT and OBEX code.


   Marcin Wiacek <marcin@mwiacek.com> is project iniciator and contributor
   of most Nokia code.


   As  this  project  grew from Gnokii, we would like to thanks all Gnokii
   developers, especially Pavel Janik, Pawel Kot and Manfred Jonsson  (see
   CREDITS from Gnokii for all their contributor).


   Many  other  people  have helped with various features, check ChangeLog
   for more details.

SEE ALSO README

   <http://www.gammu.org/> contains wiki with more user hints and  further
   documentation

   cu(1)

   gnokii(1)

   wammu(1)

   gmobilemedia(1)

Gammu 1.12.93 Jul 31 2007 GAMMU(1)