GAMMU(1)

📦

version 1.45.0 · 6 versions

1.45.0 · arch rolling (latest)
1.43.3 · nixos 26.05
1.44.1 · nixpkgs unstable
1.44.0 · ubuntu stonking
1.42.0 · alpine 3.24, epel 9, fedora 43, fedora 44
1.42.0 · debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute

💖 NAME (GAMMU(1)) 💖

gammu — does some neat things with your cellular phone or modem. no cap, that's literally the whole NAME section, bestie 💅

🌈 SYNOPSIS 🌈

gammu [parameters] <command> [options]

Commands actually indicate which operation should Gammu perform. They can be specified with or without a leading --. either way is giving the same energy, so pick your fighter ✨

💅 DESCRIPTION 💅

Okay so this program is a tool for mobile phones. Many vendors and phones are supported, for actual listing see Gammu Phones Database <https://wammu.eu/phones/>. it's giving "your phone but make it accessible" 💖

🎛️ Options 🎛️

Parameters before command configure gammu behaviour:

-c, --config <filename> — name of configuration file (see Gammu Configuration File <#gammurc>)
-s, --section <confign> — section of config file to use, eg. 42
-d, --debug <level> — debug level (see LogFormat <#option-LogFormat> in Gammu Configuration File <#gammurc> for possible values)
-f, --debug-file <filename> — file for logging debug messages

📱 Phone information commands 📱

battery — Displays information about battery and power source. 🔋
getdisplaystatus — no description in the original, bestie, so I'm not gonna invent one 💀
getsecuritystatus — Show, if phone wait for security code (like PIN, PUK, etc.) or not 🔐
identify — Show the most important phone data. 👑
monitor [times] — Retrieves phone status and writes it continuously to standard output. Press Ctrl+C to interrupt this command.

If no parameter is given, the program runs until interrupted, otherwise only given number of iterations is performed.

This command outputs almost all information Gammu supports:

Number of contacts, calendar and todo entries, messages, calls, etc.
Signal strength.
Battery state.
Currently used network.
Notifications of incoming messages and calls.

📞 Call commands 📞

answercall [id] — Answer incoming call. 📲
cancelcall [id] — Cancel incoming call
canceldiverts — Cancel all existing call diverts.
conferencecall id — Initiates a conference call.
dialvoice number [show|hide] — Make voice call from SIM card line set in phone.

show|hide — optional parameter whether to disable call number indication.

divert get|set all|busy|noans|outofreach all|voice|fax|data [number timeout] — Manage or display call diverts.
- get or set — whether to get divert information or to set it.
- all or busy or noans or outofreach — condition when apply divert
- all or voice or fax or data — call type when apply divert
- number — number where to divert
- timeout — timeout when the diversion will happen
getussd code — Retrieves USSD information - dials a service number and reads response. ☎️
holdcall id — Holds call.
maketerminatedcall number length [show|hide] — Make voice call from SIM card line set in phone which will be terminated after length seconds.
senddtmf sequence — Plays DTMF sequence. In some phones available only during calls
splitcall id — Splits call.
switchcall [id] — Switches call.
transfercall [id] — Transfers call.
unholdcall id — Unholds call.

💌 SMS and EMS commands 💌

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. SMS is lowkey the main character energy of this whole manual 💖

There is also an option to use gammu-smsd <#gammu-smsd> when you want to send or receive more messages and process them automatically. ✨

🧚 Introduction to SMS formats 🧚

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

The way Gammu handles all these formats? Obsessed. But 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. fr fr, check before you send 💀

🎀 Encoding chars in SMS text 🎀

Text in SMS can be coded using two ways:

🌸 GSM Default Alphabet 🌸

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

🦋 Unicode 🦋

With Unicode single SMS can contain at most 70 chars, but these can be any chars including all national and special ones.

Warning: Please note, that some older phones might have problems displaying such message. so cute but maybe not on a museum phone 🙈

💜 Conversion 💜

Gammu tries to do the best to handle non ASCII characters in your message. Everything is internally handled in Unicode (the input is converted depending on your locales configuration) and in case message uses Unicode the text will be given as such to the message.

Should the message be sent in GSM Default Alphabet, Gammu will try to convert all characters to keep message readable. Gammu does support multi byte encoding for some characters in GSM Default Alphabet (it is needed for ^ { } \ [ ] ~ |). The characters which are not present in GSM Default Alphabet are transliterated to closest ASCII equivalent (accents are removed). Remaining not known characters are replaced by question mark. character glow-up, but make it readable ✨

📨 SMS commands 📨

addsmsfolder name — no description in the original, bestie 🫶
deleteallsms folder — Delete all SMS from specified SMS folder.
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.

displaysms ... (options like in sendsms) — Displays PDU data of encoded SMS messages. It accepts same parameters and behaves same like sendsms.
getallsms [-pbk] — Get all SMS from phone. In some phones you will have also SMS templates and info about locations used to save Picture Images. With each sms you will see location. If you want to get such sms from phone alone, use gammu getsms.

The optional -pbk parameter enables phonebook lookup. When specified, Gammu will read phonebook entries from both phone memory and SIM card, then display contact names alongside phone numbers in the SMS output instead of showing only the phone numbers. 📇

geteachsms [-pbk] — Similarly to gammu getallsms. Difference is, that links all concatenated sms.

The optional -pbk parameter works the same as in gammu getallsms, enabling phonebook lookup to display contact names with phone numbers.

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.

getsmsc [start [stop]] — Get SMSC settings from SIM card.

Locations are numerated from 1.

getsmsfolders — Get names for SMS folders in phone
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

-smscnumber number — SMSC number
-reply — reply SMSC is set
-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
-unsent — makes message unsent
-sent — makes message sent
-smsname name — set message name
-sender number — set sender number (default: Gammu)
-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

Reads a calendar note from a file created by the gammu backup command and saves it in VCALENDAR 1.0 format as an SMS. The location tells it which calendar item to read out of the backup file — usually 1, but honestly it's useful when your backup has, like, a whole stack of items in it.

📞 CALLER file

Saves the caller logo as an sms in Nokia (Smart Messaging) format — size 72x14, two colors.

⚠️ Warning: bestie, please note that this isn't designed for colour logos, the kind you get for example in DCT4/TIKU — for those you need to put the bitmap file inside the phone using filesystem commands. No cap.

💬 USSD

Sends a USSD query instead of an SMS.

Added in version 1.38.5. ✨

🎀 EMS [-unicode] [-16bit] [-format lcrasbiut] [-text text] [-textutf8 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 an EMS sequence. All the format-specific parameters (like -defsound) can be used a few times, so go off. 💅

-text — adds text
-textutf8 — adds UTF-8 text
-unicodefiletext — adds text from a Unicode file
-defanimation — adds a default animation with an ID specified by you, the user. The ID for different phones is different (iykyk).
-animation — adds frames frames read from file1, file2, etc.
-defsound — adds a default sound with an ID specified by the user. Again, the ID for different phones is different.
-tone10 — adds IMelody version 1.0 read from RTTL or another compatible file
-tone10long — IMelody version 1.0 saved in one of a few SMS with UPI. Phones compatible with UPI (like Sony-Ericsson phones) will read such a ringtone as one 🎵
-tone12 — adds IMelody version 1.2 read from RTTL or another compatible file
-tone12long — IMelody version 1.2 saved in one of a few SMS with UPI. Phones compatible with UPI (like Sony-Ericsson phones) will read such a ringtone as one
-toneSE — adds IMelody in "short" form supported by Sony-Ericsson phones
-toneSElong — adds Sony-Ericsson IMelody saved in one or a few SMS with UPI
-variablebitmap — bitmap in any size, saved in one SMS
-variablebitmaplong — bitmap with maximum size 96x128, saved in one or a 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 the phone menu. 🔒
-16bit — Gammu uses SMS headers with 16-bit numbers for saving linking info in the SMS (which means less chars available for the user in each SMS)
-format lcrasbiut — the last text will be formatted. You can use combinations of these chars:
- 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 an MMS indication SMS. It contains the URL where the actual MMS payload is stored, and that payload needs to be SMIL encoded. The phone usually downloads the MMS data using a special APN, which does not count toward transmitted data — but there might be limitations on which URLs can be accessed, so heads up. 🙈

⚙️ MMSSETTINGS file location

Saves a message with MMS configuration. The configuration gets read from the Gammu backup file from the given location.

📡 OPERATOR file [-netcode netcode] [-biglogo]

Saves an operator logo as an sms in Nokia (Smart Messaging) format — size 72x14 in two colors.

-biglogo — use a 78x21 formatted logo instead of the standard 72x14

📝 Note: this isn't designed for colour logos, the kind you get for example in newer phones — you need to put the bitmap file inside the phone using filesystem commands. Same energy as before, fr fr.

🎨 PICTURE file [-text text] [-textutf8 text] [-unicode] [-alcatelbmmi]

Reads a bitmap from a 2-colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), formats it into a bitmap in Smart Messaging (72x28, 2 colors, often called Picture Image and saved with text) or Alcatel format, and sends/saves it over SMS. Obsessed with how retro this is. 🦋

👑 PROFILE [-name name] [-bitmap bitmap] [-ringtone ringtone]

Reads ringtone (RTTL) format, bitmap (Picture Image size) and name, formats them into a Smart Messaging profile and sends/saves it as an SMS.

⚠️ Warning: please note, this format is abandoned by Nokia and only supported by some (older) devices, like the Nokia 3310. It's giving vintage, ngl.

🔔 RINGTONE file [-long] [-scale]

Reads an RTTL ringtone from a file and saves it as an SMS into SIM/phone memory. The ringtone is saved in Nokia (Smart Messaging) format.

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

📝 SMSTEMPLATE [-unicode] [-text text] [-textutf8 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 ...]

Saves a SMS template (for Alcatel phones). 💖

✉️ TEXT [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] [-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] [-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file] [-text msgtext] [-textutf8 msgtext]

Takes text from stdin (or from the commandline if -text is specified) and saves it as a text SMS into SIM/phone memory.

Ordinary text messages longer than one SMS are automatically split into linked parts — no length option required, it just handles it. ✨ Use -maxsms with a value of 1 to reject messages that would require multiple parts. Notification, void, and replacement messages retain their single-message behavior.

The default SMS alphabet is used unless -unicode or -autolen is specified. Input decoding is controlled separately by the locale or by -textutf8.

💀 Stdin input is limited to 4,999 bytes, including any trailing newline. Larger input is rejected — even when a length option is specified — rather than sending an incomplete message. So don't try to sneak a novel in there, bestie.

-flash — Class 0 SMS (should be displayed after receiving on recipients' phone display after receiving without entering Inbox)
-len len — Limit the decoded text to at most len UTF-16 code units. The value must be positive. The limit is applied after decoding and trailing-newline handling, for both stdin and command-line text, regardless of option order. Longer text is truncated; shorter text is unchanged. -maxlen is a compatibility alias. If the limit splits a surrogate pair, the entire character is omitted so that the resulting text remains valid Unicode.
-autolen len — Apply the same length limit as -len, and automatically choose the SMS default alphabet or Unicode according to the resulting text. If length options are repeated, the last one determines the limit and whether coding is selected automatically.
-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):

ff fe 61 00 31 00

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).
WAPINDICATOR URL Title — Saves a SMS with a WAP indication for given URL and title.
WAPSETTINGS file location DATA|GPRS — Read WAP settings from file created by gammu backup command and saves in Nokia format as SMS

sendsms TYPE destination [type parameters] [type options] [-smscset number] [-smscnumber number] [-reply] [-report] [-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]

Sends a message to a destination number, most parameters are same as for gammu savesms.

-save — will also save message which is being sent
-report — request delivery report for message
-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX — sets how long will the message valid (SMSC will the discard the message after this time if it could not deliver it).

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.

💖 Memory (phonebooks and calls) commands 💖

🌈 Memory types

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

📞 Memory commands

deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL — Deletes all entries from specified memory type.

For memory types description see Memory types.

deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop] — Deletes entries in specified range from specified memory type.

For memory types description see Memory types.

getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL — Get all memory locations from phone.

For memory types description see Memory types.

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

For memory types description see Memory types.

Locations are numerated from 1.

getspeeddial start [stop] — Gets speed dial choices.
searchmemory text — Scans all memory entries for given text. It performs case insensitive substring lookup. You can interrupt searching by pressing Ctrl+C.

🗂️ Filesystem commands 🗂️

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.

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 — Sets the read only attribute.
- -protected — Sets the protected attribute (file can't be for example forwarded from phone menu).
- -system — Sets the system attribute.
- -hidden — Sets the hidden attribute (file is hidden from phone menu).
- -newtime — After using it date/time of file modification will be set to moment of uploading.
addfolder parentfolderID name — Create a folder in phone with specified name in a folder with specified folder ID.
deletefiles fileID — Delete files with given IDs.
deletefolder name — Delete folder with given ID.
getfilefolder fileID [fileID ...] — Retrieve files or all files from folder with given IDs from a phone filesystem.
getfiles fileID [fileID ...] — Retrieve files with given IDs from a phone filesystem.
getfilesystem [-flatall|-flat] — Display info about all folders and files in phone memory/memory card. By default there is tree displayed, you can change it:
- -flatall — there are displayed full file/folder details like ID (first parameter in line)
- -flat — (the page doesn't elaborate here; it just lists the flag.)

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 — yeets a file over to your phone. Where it actually lands and what the phone does with it? That's the phone's business, not ours 💅 (like, send a vCard or vCalendar and most phones will pop up asking if you wanna import it — cute, right?)
setfileattrib folderID [-system] [-readonly] [-hidden] [-protected] — sets the attributes on a file in that folder. Flags do exactly what they say: -system, -readonly, -hidden, -protected.

🎨 Logo and pictures commands 🎨

okay so these are mainly (with a few exceptions!!) for the monochromatic logos and images living on older phones. Recognized file formats, listen up: xpm (only saving), 2-colors bmp, nlm, nsl, ngg, nol, wbmp, gif (for Samsung).

On the new models, all bitmaps are saved in the filesystem and should go in the filesystem section. periodt ✨

copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]] — converts logo files from one format to another, slay. Give it ONLY inputfile and the output gets written to stdout as ASCII art (yes, art 🎀). Give it an output file and format, and in some file formats (like NLM) it'll set an indicator telling the phone what type of logo this is.
getbitmap TYPE [type options] — reads a bitmap off the phone. Supported types, bestie:
- CALLER location [file] — grabs the caller group logo from the phone. Locations 1-5.
- DEALER — on some models you can save a dealer welcome note, aka the text that shows while the phone is booting, which you literally cannot edit from the phone menu. Here's where you get it 🫶
- OPERATOR [file] — gets the operator logo (the picture shown instead of the operator name) from the phone.
- PICTURE location [file] — gets a Picture Image from the phone.
- STARTUP [file] — gets the static startup logo from the phone. Lets you save it to a file, iconic.
- TEXT — gets the startup text from the phone.
setbitmap TYPE [type options] — puts a bitmap into the phone. Supported types:
- CALLER location [file] — sets the caller logo.
- COLOUROPERATOR [fileID [netcode]] — sets a color operator logo in the phone.
- COLOURSTARTUP [fileID]
- DEALER text — sets the welcome message configured by the dealer, which usually can't be changed anywhere in the phone menus.
- OPERATOR [file [netcode]] — sets the operator logo. No file and no netcode? The operator logo gets removed from the phone 🗑️. Only a filename? Then the logo shows for your current GSM operator. Throw in the network code too and it shows for that operator.
- PICTURE file location [text] — sets a picture image in the phone.
- STARTUP file|1|2|3 — sets the startup logo. Static means you gotta hand over the file name; or pick one of the predefined animated ones (only some phones like Nokia 3310 or 3330 support it — use location 1, 2 or 3 for those).
- TEXT text — sets the startup text in the phone.
- WALLPAPER fileID — sets the wallpaper in the phone.

🔔 Ringtones commands 🔔

Ringtones are mostly a thing only on older phones — for recent ones you usually just upload them into some folder in the phone filesystem. iykyk 😌

Recognized various file formats via the options 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).

copyringtone source destination [RTTL|BINARY] — copies source ringtone to destination.
getphoneringtone location [file] — gets one of the "default" ringtones and saves it into file.
getringtone location [file] — gets a ringtone from the phone in RTTL or BINARY format.

Locations are numerated from 1 💅

getringtoneslist
playringtone file — plays an approximation of the ringtone over the phone buzzer. file can be RTTL or BINARY (Nokia DCT3) format.
playsavedringtone number — plays one of the built-in ringtones. This one's available for DCT4 phones. To get the ringtones list, use gammu getringtoneslist.
setringtone file [-location location] [-scale] [-name name] — sets a ringtone in the phone. Don't give a location and it gets written "with preview" (on phones supporting that feature, like 61xx or 6210).
- -scale — Scale information gets added to each note of the RTTL ringtone. This avoids the scale problems that show up when you edit the ringtone in the composer from the phone menu (for example, on Nokia 33xx).

Note: when you use the ~ char in the ringtone name, on some phones (like 33xx) the name will blink later in the phone menus. not me finding that out the hard way 😭

📅 Calendar notes commands 📅

On the Nokia 3310, 3315 and 3330 these are named "Reminders" and have some limitations (depends on the phone firmware version, fun!).

deletecalendar start [stop] — deletes the selected calendar entries in the phone.
getallcalendar — retrieves all the calendar entries from the phone.
getcalendar start [stop] — retrieves the selected calendar entries from the phone.

✅ To do list commands ✅

deletetodo start [stop] — deletes the selected todo entries in the phone.
getalltodo — retrieves all todo entries from the phone.
gettodo start [stop] — retrieves the selected todo entries from the phone.

📝 Notes commands 📝

getallnotes — reads all notes from the phone.

Note: not all phones support this function — especially most Sony Ericsson phones, even when they literally have notes inside the phone 🙈

⏰ Date, time and alarm commands ⏰

getalarm [start] — gets the alarm from the phone. No location specified? 1 is used.
getdatetime — gets the date and time from the phone.
setalarm hour minute — sets a repeating alarm in the phone at the selected time.
setdatetime [HH:MM[:SS]] [YYYY/MM/DD] — sets the date and time in the phone to the date and time set on the computer. Please note that this option does not show the clock on the phone screen — it only sets the date and time, no cap.

Note: you can make this kind of synchronization each time you connect your phone and use Gammu. See SynchronizeTime <#option-SynchronizeTime> in Gammu Configuration File <#gammurc> for the details 🫶

🗂️ Categories commands 🗂️

Note: categories are supported only on a few phones (Alcatel).

addcategory TODO|PHONEBOOK text
getallcategory TODO|PHONEBOOK
getcategory TODO|PHONEBOOK start [stop]
listmemorycategory text|number
listtodocategory text|number

💾 Backing up and restoring commands 💾

addnew file [-yes] [-memory ME|SM|..] — adds data written in a file created using the gammu backup command. Everything that gammu backup backs up can be restored (when the backup was made to a Gammu text file).

Please note that this adds all the content of the backup file to the phone and does not care about the current data in the phone — no duplicates are detected, so it's just gonna pile it all in there 💀

Use the -yes parameter to answer yes to all the questions (you want to automatically restore all the data).

Use the -memory parameter to force usage of a defined memory type for storing entries, regardless of what the backup format says.

addsms folder file [-yes] — adds SMSes from file (format like gammu backupsms uses) to the selected folder in the phone.
backup file [-yes] — backs up your phone to file. It's possible to back up (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

Various backup formats are supported and the backup format is guessed based on the 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 a Gammu backup file and it supports all the data mentioned above — see Backup Format <#gammu-backup> for the juicy details.

By default this command is interactive and asks which items you want to back up.

Use -yes for answering yes to all the questions.

backupsms file [-yes|-all] — stores all SMSes from the phone into file, in SMS Backup Format <#gammu-smsbackup>.

By default this command is interactive and asks which folders you want to back up and whether you want to remove messages from the phone afterwards.

Use -yes for answering yes to all the questions (back up all messages and delete them from the phone), or -all to just back up all folders while keeping the messages in the phone. very mindful of you 🌸

restore file [-yes]

Warning: please note that restoring deletes all the current content in the phone. If you only want to add entries to the phone, use gammu addnew. do not come for me when your phonebook vanishes 😭

Restores the settings written in file created using the gammu backup command.

In some phones, restoring calendar notes won't show an error but also won't get done — that happens when the phone doesn't have the clock set inside. so it's just silently ghosting you 🫠

restoresms file [-yes]

Warning: please note that this overwrites existing messages in the phone (if it supports it).

Restores SMSes from file (format like gammu backupsms uses) to the selected folder in the phone.

savefile TYPE [type options] — converts between the various file formats supported by Gammu. Supported types:
- BOOKMARK target.url file location — converts a backup format supported by Gammu into a vBookmark file.
- CALENDAR target.vcs file location — lets you convert between the various backup formats that Gammu supports for calendar events. The file type is guessed (for the input file the guess is based on extension and file content, for the output solely on extension).
- TODO target.vcs file location — lets you convert between the various backup formats that Gammu supports for todo events. The file type is guessed (for the input file the guess is based on extension and file content, for the output solely on extension).
VCARD10|VCARD21 target.vcf file SM|ME location — bestie this one lets you convert between all the various backup formats Gammu supports for phonebook events 💅 The file type gets guessed — for the input file the guess is based on the extension and the file content, but for the output file it's based solely on the extension. iykyk, so name your files right ✨

See also: gammu convertbackup

convertbackup source.file output.file — added in version 1.28.94 🎀 Converts a backup between the formats Gammu supports. Unlike gammu savefile, this gives you zero options on what to convert — it literally just takes everything that can be saved and shoves it into the output file. no thoughts, just vibes 🫶

See also: gammu savefile

📱 Nokia specific commands 💙

nokiaaddfile TYPE [type options] — uploads a file to your phone, into the specific location for the type you picked:
- APPLICATION|GAME file [-readonly] [-overwrite] [-overwriteall] — installs the *.jar/*.jad file pair of a midlet into the application or game menu of the phone. You need to specify the filename without the jar/jad suffix — both get added automatically, she's got it covered 💅
  - -overwrite — deletes the application's .jad and .jar files before installing, but does not delete the application data.
  - -overwriteall — deletes the application (same as -overwrite) and all its data. ruthless. iconic.
  - You can use jadmaker to generate a .jad file from a .jar file ✨
- GALLERY|GALLERY2|CAMERA|TONES|TONES2|RECORDS|VIDEO|PLAYLIST|MEMORYCARD file [-name name] [-protected] [-readonly] [-system] [-hidden] [-newtime]
nokiaaddplaylists — goes through the phone memory and generates a playlist for all music files found 🎵 To manually manage playlists:

gammu addfile a:\\predefplaylist filename.m3u

will add playlist filename.m3u 💖

gammu getfilesystem

will get you the list of all files (including the names of files with playlists) 🦋

gammu deletefiles a:\\predefplaylist\\filename.m3u

will delete playlist filename.m3u 💀

The format of an m3u playlist is genuinely easy (it's the standard mp3 playlist): the first line is #EXTM3U, and the next lines contain the names of files (b:\file1.mp3, b:\folder1\file2.mp3, etc.). The file needs to have \r\n terminated lines. So just run unix2dos on the resulting file before uploading it to your phone, bestie 🫶

nokiacomposer file — shows you how to enter an RTTL ringtone in the composer that exists in many Nokia phones (and what it should look like) 🎶
nokiadebug filename [[v11-22] [,v33-44]...]
nokiadisplayoutput
nokiadisplaytest number
nokiagetadc
nokiagetoperatorname — 6110.c phones have a place for a name for one GSM network (of course, with flashing it's possible to change all names, but Gammu is not a flasher ;-)). You can get this name using this option 💅
nokiagetpbkfeatures memorytype
nokiagett9 — this option should display T9 dictionary content from DCT4 phones 🔤
nokiagetvoicerecord location — gets a voice record from location and saves it to a WAV file 🎙️ The file is coded using the GSM 6.10 codec (available for example in win32). The name of the file is like the name of the voice record in the phone.

Created WAV files require the 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 these 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)

nokiamakecamerashoot
nokianetmonitor test — takes output or sets netmonitor for Nokia DCT3 phones 📡

See also: for more info about this option, please visit Marcin's page <http://www.mwiacek.com/> 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 <http://www.mwiacek.com/> and read netmonitor manual there.

nokiasecuritycode — get/reset to "12345" security code 🔐
nokiaselftests — perform tests for Nokia DCT3 phones 🩺

Note: EEPROM test can show an error when your phone has an EEPROM in flash (like 82xx/7110/62xx/33xx). The clock test will show an error when the phone doesn't have an internal battery for the clock (like 3xxx).

nokiasetlights keypad|display|torch on|off 💡
nokiasetoperatorname [networkcode name]
nokiasetphonemenus — enable all (?) possible menus for DCT3 Nokia phones, bestie, go off 👑
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:

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

nokiasetvibralevel level — set vibra power to "level" (given in percent) 📳
nokiatuneradio
nokiavibratest

🧡 Siemens specific commands

siemensnetmonact netmon_type — enables network monitor in a Siemens phone. Currently known values for type are 1 for full and 2 for simple mode 👀
siemensnetmonitor test
siemenssatnetmon

🌐 Network commands 🌈

getgprspoint start [stop]
listnetworks [country] — show names/codes of GSM networks known for Gammu 🌍
networkinfo — show information about network status from the phone 📶
setautonetworklogin

🍓 WAP settings and bookmarks commands

deletewapbookmark start [stop] — delete WAP bookmarks from the phone. Locations are numerated from 1 🔖
getchatsettings start [stop]
getsyncmlsettings start [stop]
getwapbookmark start [stop] — get WAP bookmarks from the phone. Locations are numerated from 1 💖
getwapsettings start [stop] — get WAP settings from the phone. Locations are numerated from 1 ✨

💌 MMS and MMS settings commands

getallmms [-save]
geteachmms [-save]
getmmsfolders
getmmssettings start [stop]
readmmsfile file [-save]

📻 FM radio commands 🎧

getfmstation start [stop] — show info about FM stations in the phone 📡

⚙️ Phone settings commands

getcalendarsettings — displays calendar settings like first day of week or automatic deleting of old entries 🗓️
getprofile start [stop]
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

🔍 Dumps decoding commands

Note: These commands are available only if Gammu was compiled with debugging options. 💀

decodebinarydump file [phonemodel] — decodes a dump made by Gammu with LogFormat set to binary 🧚
decodesniff MBUS2|IRDA file [phonemodel] — allows you to decode sniffs. See Discovering protocol for more details 🦋

🌸 Other commands 🎀

entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|- [newpin|-] — allows you to enter a security code from the PC 🔐 When code is -, it is read from stdin. In case of entering PUK, some phones require you to set a new PIN as well 👑
presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@ — presses the specified key sequence on the phone keyboard 📲
- mM — Menu
- nN — Names key
- pP — Power
- uU — Up
- dD — Down
- +- — +-
- gG — Green
- rR — Red
- 123456789*0# — numeric keyboard
reset SOFT|HARD — make the 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 — added in version 1.33.90 ✨ Turns the phone off or on.

Note: This is usually required for built in modules in notebooks 💻

screenshot filename — captures a phone screenshot and saves it as filename 📸 The extension is automatically appended to filename based on what data the phone provides 🎀

🗂️ Batch mode commands

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 comments 🫶 By default, commands are read from standard input, but you can optionally specify a file from where they'd be read (special case - means standard input) 💅

🔧 Configuration commands

searchphone [-debug] — attempts to search for a connected phone 🔎

⚠️ Warning: lowkey this can take forever, but if you literally have zero clue how to configure your phone connection, it's a super convenient way to find a working setup for Gammu. 💅

install [-minimal] — installs the applet for whatever connection is currently configured to the phone. 🎀

You can configure the search path for installation files with DataPath <#option-DataPath>.

The -minimal parameter forces installation of the applet only, without any possible support libraries — ngl this is useful for updates. ✨

💖 Gammu information commands 💖

checkversion [STABLE] — checks whether there's a newer Gammu version available online (only if Gammu was compiled with CURL, iykyk). If you pass the extra parameter STABLE, only stable versions get checked. 👑
features — prints info about compiled-in features. 🌸
help [topic] — prints help. By default you get the general help, but you can also specify a help category to get more detailed help on some topic. 🦋
version — prints version information and license. 📜

✨ RETURN VALUES ✨

gammu returns 0 on success. If it fails, you get a non-zero code back.

1 — out of memory or other critical error 💀
2 — invalid command line parameters
3 — failed to open file specified on command line
4 — program was interrupted
98 — Gammu library version mismatch
99 — functionality has been moved. For example to gammu-smsd <#gammu-smsd>.

Error codes greater than 100 map to the GSM_Error values increased by 100, fr fr:

101 — no error.
102 — error opening device. Unknown, busy or no permissions.
103 — error opening device, it is locked.
104 — error opening device, it doesn't exist.
105 — error opening device, it is already opened by other application.
106 — error opening device, you don't have permissions.
107 — error opening device. No required driver in operating system.
108 — error opening device. Some hardware not connected/wrongly configured.
109 — error setting device DTR or RTS.
110 — error setting device speed. Maybe speed not supported.
111 — error writing to the device.
112 — error during reading from the device.
113 — can't set parity on the device.
114 — no response in specified timeout. Probably phone not connected.
115 — frame not requested right now. See https://wammu.eu/support/bugs/ for information how to report it.
116 — unknown response from phone. See https://wammu.eu/support/bugs/ for information how to report it.
117 — unknown frame. See https://wammu.eu/support/bugs/ for information how to report it.
118 — unknown connection type string. Check config file.
119 — unknown model type string. Check config file.
120 — some functions not available for your system (disabled in config or not implemented).
121 — function not supported by phone.
122 — empty entry.
123 — security error. Maybe no PIN?
124 — invalid location. Maybe too high?
125 — functionality not implemented. You are welcome to help authors with it. 🫶
126 — memory full.
127 — unknown error.
128 — can not open specified file.
129 — more memory required...
130 — operation not allowed by phone.
131 — no SMSC number given. Provide it manually or use the one configured in phone.
132 — you're inside phone menu (maybe editing?). Leave it and try again.
133 — phone is not connected.
134 — function is currently being implemented. If you want to help, please contact authors.
135 — phone is disabled and connected to charger.
136 — file format not supported by Gammu.
137 — nobody is perfect, some bug appeared in protocol implementation. Please contact authors. 😭
138 — transfer was canceled by phone, maybe you pressed cancel on phone.
139 — phone module need to send another answer frame.
140 — current connection type doesn't support called function.
141 — CRC error.
142 — invalid date or time specified.
143 — phone memory error, maybe it is read only.
144 — invalid data given to phone.
145 — file with specified name already exists.
146 — file with specified name doesn't exist.
147 — you have to give folder name and not file name.
148 — you have to give file name and not folder name.
149 — can not access SIM card.
150 — wrong GNAPPLET version in phone. Use version from currently used Gammu.
151 — only part of folder has been listed.
152 — folder must be empty.
153 — data were converted.
154 — Gammu is not configured.
155 — wrong folder used.
156 — internal phone error.
157 — error writing file to disk.
158 — no such section exists.
159 — using default values.
160 — corrupted data returned by phone.
161 — bad feature string in configuration.
162 — desired functionality has been disabled on compile time.
163 — Bluetooth configuration requires channel option.
164 — service is not running.
165 — service configuration is missing.
166 — command rejected because device was busy. Wait and restart.
167 — could not connect to the server.
168 — could not resolve the host name.
169 — failed to get SMSC number from phone.
170 — operation aborted.
171 — installation data not found, please consult debug log and/or documentation for more details.
172 — entry is read only.

🌈 EXAMPLES 🌈

🌸 Configuration 🌸

To check it out, you need to have a configuration file for gammu, see Gammu Configuration File <#gammurc> for more details about it. 🎀

💌 Sending messages 💌

Note: all messages below are sent to number 123456, replace it with the proper destination. 💅

Send a text message up to the standard 160 chars:

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

gammu sendsms TEXT 123456 -text "All your base are belong to us"

Send a long text message:

echo "All your base are belong to us" | gammu sendsms TEXT 123456 -len 400

gammu sendsms TEXT 123456 -len 400 -text "All your base are belong to us"

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

Send some funky message with a 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 a protected message with ringtone:

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

🦋 Retrieving USSD replies 🦋

For example for retrieving prepaid card status or retrieving various network info:

gammu getussd '#555#'

🎀 Uploading files to Nokia 🎀

Add Alien to applications in your phone (you need to have files Alien.JAD and Alien.JAR in the current directory):

gammu nokiaaddfile APPLICATION Alien

Add file.mid to the ringtones folder:

gammu nokiaaddfile TONES file.mid

⭐ Setting operator logo ⭐

Set logo for network 230 03 (Vodafone CZ):

gammu setbitmap OPERATOR ala.bmp "230 03"

🧚 Converting file formats 🧚

The formats conversion can be done using gammu savefile or gammu convertbackup commands.

Convert a single entry (at position 260) from Backup Format <#gammu-backup> to vCalendar:

gammu savefile CALENDAR output.vcs myCalendar.backup 260

Convert the first phonebook entry from Backup Format <#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

🙈 Reporting bugs 🙈

There are definitely many bugs, reporting to the author is welcome. 🫶 Please include some useful information when sending bug reports (especially debug logs, operating system, its version and phone information are needed — like, actually needed, no cap).

To generate a debug log, enable it in Gammu Configuration File <#gammurc>:

[gammu]
YOUR CONNECTION SETTINGS
logfile = /tmp/gammu.log
logformat = textall

Alternatively you can specify logging on the command line:

gammu -d textall -f /tmp/gammu.log ...

With these settings, Gammu generates /tmp/gammu.log on each connection to the phone and stores a dump of the 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 <https://github.com/gammu/gammu/issues>. 👑

💜 Author 💜

Michal Čihař <michal@cihar.com>

💜 Copyright 💜

2009-2015, Michal Čihař <michal@cihar.com>

okay that's literally the whole page bestie, you ate that 🍓 this was GAMMU(1), version 1.45.0, dated Sep 16, 2026 — go forth and slay your phone connection 💅✨👑

📦 where this page comes from

arch rolling: gammu 1.45.0-1 · GPL-2.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms