Copyright © 2001 by Eric Lassauge
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to: Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.
The gsmssend (GNOMESmsSend) application is a GNOME User Interface to the smssend tool written by Christophe CALMEJANE 'Ze KiLleR / SkyTech' http://zekiller.skytech.org/smssend_menu_en.html.
It will detect the provider script files in the default locations (current dir, ~/.smssend, and smssend default global) and create a small User Interface for each one. When you click on the APPLY button it will fork/exec smssend with proper options.
![]() | Warning |
---|---|
gsmssend isn't a self contained application, smssend MUST be installed on your system. Please refer to the smssend manuals for all terms. |
All options to smssend can be set through the various dialogs.
To run gsmssend, select Network->gSmsSend from the Main Menu, or type gsmssend on the command line.
This document describes version 1.6 of gsmssend.
gsmssend offers a number of command line options similar to those of all GNOME applications. Here is a list of the supported command line arguments:
gsmssend [OPTION...]
option | purpose |
---|---|
GNOME Options | |
--disable-sound | Disable sound server usage |
--enable-sound | Enable sound server usage |
--espeaker=HOSTNAME:PORT | Host:port on which the sound server to use is running |
--version | |
Help options | |
-?, --help | Show this help message |
--usage | Display brief usage message |
GTK options | |
--gdk-debug=FLAGS | Gdk debugging flags to set |
--gdk-no-debug=FLAGS | Gdk debugging flags to unset |
--display=DISPLAY | X display to use |
--sync | Make X calls synchronous |
--no-xshm | Dont't use X shared memory extension |
--name=NAME | Program name as used by the window manager |
--class=CLASS | Program class as used by the window manager |
--gxid_host=HOST | |
--gxid_port=PORT | |
--xim-preedit=STYLE | |
--xim-status=STYLE | |
--gtk-debug=FLAGS | Gtk+ debugging flags to set |
--gtk-no-debug=FLAGS | Gtk+ debugging flags to unset |
--g-fatal-warnings | Make all warnings fatal |
--gtk-module=MODULE | Load an additional Gtk module |
GNOME GUI options | |
--disable-crash-dialog | |
Session management options | |
--sm-client-id=ID | Specify session management ID |
--sm-config-prefix=PREFIX | Specify prefix of saved configuration |
--sm-disable | Disable connection to session manager |
GsmsSend options: | |
-s, --scriptpath=PATH | Path for SmsSend scripts (This can be set with the SMSSEND_SCRIPTPATH environment variable too) |
-f, --scriptfile=FILENAME | Use only one script with this filename |
-u, --user_only | Use only the scripts in current directory or in user directory ($HOME/.smssend) |
When you first start gsmssend you will be presented with the provider notebook (see this figure).
From this window, you can manipulate the provider scripts that are currently installed on the system and that you choose to view. When selecting a provider in this window, you will display the main user interface of the script (see below).
Operations can be performed with the menu items. Their meanings are as follows:
This menu contains:
Add provider File (A) — lets you select a provider script file and opens it, reading its contents and adding a new notetab immediately in the main view.
Go to SmsSend home page for more scripts (G) — will open a browser window to the smssend home page on internet, where you can pick new script files.
Execute SmsSend for delayed connections (E) — lets you throttle all delayed call to smssend if you configured gsmssend to delay all calls. This can be usefull if you want to create all messages and then wait to have your connection with your internet provider established.
Close (Ctrl-W) — hide the currently selected script notetab.
Exit (Ctrl-Q) — This quits the application.
This menu contains:
Manage Aliases… — This opens the Alias Dialog, which allows you to configure the aliases.
Manage Scripts… — This opens the Scripts Dialog, which allows you to configure the scripts you want to see or to save.
Check for updates — This will check, by launching smssend with the -update option, if the installed version of smssend is the latest. Outputs generated by this call can be seen in the status bar of the main window.
Preferences… — This opens the Preferences Dialog, which allows you to configure many settings.
This menu contains:
Help topics — This opens the GNOME Help Browser for the specified topic.
About… — This opens the About box window.
The provider part of the main window is created by parsing a provider script, each parameter of the script is used to create a text field in this window. Each text field as a name and a popup help.
The big text entry on the right is used to enter the SMS message, updating in real time the Remaining characters field.
When the message is ready, smssend is called by pressing the Apply button.
All outputs of smssend can be seen in the status bar of the main window.
This window lets you manage all options that can be set to smssend. All terms here are explained in the smssend manual. The only specific option is in the Usage part of this window:
This checkbox is used if you want to delay all calls to smssend. They can be latter triggered by using File->Execute SmsSend for delayed connections.
This button is used to update the used options in memory, close the dialog window and overwrite the ~/.smssend/smssendrc file.
This button is used to update the used options in memory and close the dialog window.
This button is used to cancel all changes to the options close the dialog window.
This window lets you manage (Add/Edit/Remove) aliases that can be used in every parameter text field of the Provider Interface. This enables the possibility to use aliases (@Alias_name), which are located in the file ~/.smssend/aliases. When using an alias name in a parameter text field it is automatically replaced by its value.
The elements of this window are as follows:
This colums shows the Alias_name (that has to be entered prefixed by @ in the parameter text field)
This colums shows the value that is used when @Alias_name is entered.
This text field is used to Add new @Alias_name in the list.
This text field is used to Add the value of the preceeding @Alias_name.
This button is used to Add the 2 values of the preceeding text fields in the list.
This button is used to delete the currently selected line of the list.
These buttons are used to move the currently selected line of the list.
This button is used to update the used list in memory, close the dialog window and overwrite the ~/.smssend/aliases file.
This button is used to update the used list in memory and close the dialog window.
This button is used to cancel all changes to the aliases list in memory and close the dialog window.
This window lets you manage the scripts that you want to use. You have a 3 columns list with all the known scripts. The elements of this window are as follows:
The list of all known scripts. By clicking in the columns label you can change the sort mode of the list.
This column is used to check the script that you want to have in the main notebook.
This column is used to mark the scripts that you want to be saved in a special file (~/.smssend/scripts) for the next time, you'll have only these scripts shown in the main GUI.
Save the scripts in ~/.smssend/scripts.
Show/Hide notetab of provider scripts depending on what is selected.
Cancel all changes.
![]() | When using the option --scriptpath or --scriptfile the saved scripts list is not used. |
Gnome SmsSend was written by Eric Lassauge (<lassauge@mail.dotcom.fr>). Please send all comments, suggestions, and bug reports to the author.
See updates on the authors web site: http://lassauge.free.fr/smssend_en.html
Many thanks to:
Harm Verhagen <h.verhagen@chello.nl>
Carlo <karlox@libero.it>
Heiko Armbrust <heiko.armbrust@gmx.net>
Petr Blaha <pblaha@suse.cz>
Gorka Olaizola <gorka@escomposlinux.org>
and of course Christophe CALMEJANE 'Ze KiLleR / SkyTech' <zekiller@skytech.org>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
A copy of the GNU General Public License is included as an appendix to the Gnome Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to
Free Software Foundation, Inc.
59 Temple Place - Suite 330
Boston, MA 02111-1307
USA