Gnome SmsSend Manual

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.


Table of Contents
Introduction
Using Gnome SmsSend
User Interface
Authors
License

Introduction

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.

WarningWarning
 

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.

Figure 1. The Main window

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.


Using Gnome SmsSend

The commandline Options

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...]

optionpurpose
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)


The Menu Bar

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:

File

Figure 2. The File Menu

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.

Settings

Figure 3. The Settings Menu

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.

Help

Figure 4. The Help Menu

This menu contains:

Figure 5. The About box


User Interface

The Provider Interface

Figure 6. The Provider Interface

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.


The Preference Dialog Window

Figure 7. The Preference Dialog 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:

Delay SmsSend calls

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.

OK

This button is used to update the used options in memory, close the dialog window and overwrite the ~/.smssend/smssendrc file.

Apply

This button is used to update the used options in memory and close the dialog window.

Cancel

This button is used to cancel all changes to the options close the dialog window.


The Alias Dialog Window

Figure 8. The Alias 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:

Key Column

This colums shows the Alias_name (that has to be entered prefixed by @ in the parameter text field)

Value Column

This colums shows the value that is used when @Alias_name is entered.

Key Text Field

This text field is used to Add new @Alias_name in the list.

Value Text Field

This text field is used to Add the value of the preceeding @Alias_name.

Add

This button is used to Add the 2 values of the preceeding text fields in the list.

Delete

This button is used to delete the currently selected line of the list.

Up/Down

These buttons are used to move the currently selected line of the list.

OK

This button is used to update the used list in memory, close the dialog window and overwrite the ~/.smssend/aliases file.

Apply

This button is used to update the used list in memory and close the dialog window.

Cancel

This button is used to cancel all changes to the aliases list in memory and close the dialog window.


The Script Dialog Window

Figure 9. The Script 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:

Script Column

The list of all known scripts. By clicking in the columns label you can change the sort mode of the list.

Show Column

This column is used to check the script that you want to have in the main notebook.

Save Column

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.

OK

Save the scripts in ~/.smssend/scripts.

Apply

Show/Hide notetab of provider scripts depending on what is selected.

Cancel

Cancel all changes.

Warning

When using the option --scriptpath or --scriptfile the saved scripts list is not used.


Authors

Gnome SmsSend was written by Eric Lassauge (). 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:


License

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
    BostonMA 02111-1307
    USA