SMSCON Editor

m (Start up)
(Versions:)
Line 87: Line 87:
=Versions:=
=Versions:=
-
==''v.0.4.4-14 (current)''==
+
'''''v.0.4.4-14 (current)'''''
-
* ''changelog'':  
+
  ''changelog'':  
-
** Added prefix of a common string to all commands.
+
  * Added prefix of a common string to all commands.
-
* ''issues'':
+
  ''issues'':
-
** none known/reported.
+
  * none known/reported.
-
==''v.0.4.4-12''==
+
'''''v.0.4.4-12'''''
-
* ''changelog'':  
+
  ''changelog'':  
-
** Added support for new option to send GPS coordinates to both email and sms.
+
  * Added support for new option to send GPS coordinates to both email and sms.
-
** Increased the size of the username fields - useful with gmail and such.
+
  * Increased the size of the username fields - useful with gmail and such.
-
** Removed smscon from the dependencies (to allow promotion in extras)
+
  * Removed smscon from the dependencies (to allow promotion in extras)
-
==''v.0.4.4-11''==
+
'''''v.0.4.4-11'''''
-
* ''changelog'':  
+
  ''changelog'':  
-
** Added tests for receiving GPS coordinates commands  
+
  * Added tests for receiving GPS coordinates commands  
-
** Added tests for phonecall and sms commands  
+
  * Added tests for phonecall and sms commands  
-
** Added information and warning boxes  
+
  * Added information and warning boxes  
-
** Many visibility enhancement changes
+
  * Many visibility enhancement changes
-
** Updated icon to be transparent.
+
  * Updated icon to be transparent.
-
** Added icon for the application manager.
+
  * Added icon for the application manager.
-
** Made MailFrom = MailAddress as a temp solution until dedicated space is made for this field in the GUI.
+
  * Made MailFrom = MailAddress as a temp solution until dedicated space is made for this field in the GUI.
-
** Added the About and Credits dialogs.
+
  * Added the About and Credits dialogs.
-
** Added smscon in the dependencies.
+
  * Added smscon in the dependencies.
-
==''v.0.4.4-9''==
+
'''''v.0.4.4-9'''''
-
* ''changelog'':  
+
  ''changelog'':  
-
** Changes in the postinst script to correct it's execution and privileges  
+
  * Changes in the postinst script to correct it's execution and privileges  
-
** Added checks on the configuration file existence and to provide messages to the user when missing or corrupted.
+
  * Added checks on the configuration file existence and to provide messages to the user when missing or corrupted.
-
==''v.0.4.4-5''==
+
'''''v.0.4.4-5'''''
'''Warning''': This version (and above) will work only with [[SMSCON]] version equal or higher than 0.4.4
'''Warning''': This version (and above) will work only with [[SMSCON]] version equal or higher than 0.4.4
-
* ''changelog'':  
+
  ''changelog'':  
-
** Addition of a new tickbox to provide "Reply On Keybord Open" settings option.
+
  * Addition of a new tickbox to provide "Reply On Keybord Open" settings option.
-
** Update of code reading the config file to include spaces in commands (provided by digitalvoid).
+
  * Update of code reading the config file to include spaces in commands (provided by digitalvoid).
-
** Corrected canvas of the main window to fit better the N900 screenzise.
+
  * Corrected canvas of the main window to fit better the N900 screenzise.
-
** Increased the width of commands line enter.
+
  * Increased the width of commands line enter.
-
** Corrected the .desktop file to point in the correct iconset
+
  * Corrected the .desktop file to point in the correct iconset
-
** Added explicit permissions in the postinst script for the gui elements file.
+
  * Added explicit permissions in the postinst script for the gui elements file.
-
==''v.0.4.3-9''==
+
'''''v.0.4.3-9'''''
-
*''changelog'':
+
  ''changelog'':
-
** added block on starting the UI as root (it should only be started as user)
+
  * added block on starting the UI as root (it should only be started as user)
-
** the editor will quit after calling the init or reset commands (after informing user).
+
  * the editor will quit after calling the init or reset commands (after informing user).
-
** added slightly modified icons.
+
  * added slightly modified icons.
-
** added settings and permissions in sudoers file.
+
  * added settings and permissions in sudoers file.
-
** cleanup of postinst instructions
+
  * cleanup of postinst instructions
-
** cleanup of commented out code.
+
  * cleanup of commented out code.
-
==''v.0.4.3-8''==
+
'''''v.0.4.3-8'''''
-
*''changelog'':
+
  ''changelog'':
-
** The Editor will trigger a reload of the new configuration after every update of the config file.
+
  * The Editor will trigger a reload of the new configuration after every update of the config file.
-
** Temporarily the MailFrom field in the email settings will be filled by the MailAddress (in the future will get its own element in the GUI).
+
  * Temporarily the MailFrom field in the email settings will be filled by the MailAddress (in the future will get its own element in the GUI).
-
** Renamed buttons in the UI from <code>Create Settings</code> to <code>Update Settings</code>.
+
  * Renamed buttons in the UI from <code>Create Settings</code> to <code>Update Settings</code>.
''NOTE'': For older versions please see the changelogs in the [https://garage.maemo.org/frs/?group_id=1848&release_id=4066|project's garage page]
''NOTE'': For older versions please see the changelogs in the [https://garage.maemo.org/frs/?group_id=1848&release_id=4066|project's garage page]
 +
 +
 +
----
=Future Development=
=Future Development=

Revision as of 20:27, 11 October 2010

The SMSCON Editor is a graphical user interface to the configuration file of the SMSCON.

It has been created with PyQT (PyQt v4.7.5 for Python v2.6) and the functionality is provided by Python.

With its assistance the user is able to edit from a GUI all the options and name the secret pass-phrases of the commands used for controlling the device by the SMSCON and are stored at its configuration file, i.e. the /usr/bin/smscon_config file.

In addition, it provides an interface to initialise (i.e. init, start, stop, reset and set/remove from the device's boot sequence) the smscon_daemon.


Contents

Installation

The application can be installed directly by the Application Manager (HAM) and the Extras repositories. (Check here for its status)

You can also find the latest version in the garage project page.

Dependencies

The editor depends (not verified to be complete yet) at:

  • python2.5
  • python2.5-qt4-gui
  • python2.5-qt4-core
  • python2.5-qt4-maemo5

It also suggests:

  • smscon

Usage

When it starts it loads the current configuration file and the options already will be shown in the appropriate sections of the GUI.

FIXME: add explanations

Start up

A banner will popup showing the correct startup, i.e. the smscon_config file is correct and has been successfully loaded.

Then a password dialog will open (default pass is 12345)

General configuration tab

Send GPS Coordinates Replies

Choice can be made where the replies will be send. It can be either SMS, Email or Both.

Email configuration tab

Reverse SSH configuration tab

Commands renaming first tab

The Commands can be renamed (it is recommended for maximum safety) to ones preferences.

Commands renaming second tab

Prefixing Commands

The "Prefix" can be useful in the cases where it is desired all the default names to be prefixed with a common string. Note: The new names (as all other changes) are stored only after the button "Update Settings" is pressed. In addition, the same operation has to be repeated for the second tab of commands renames.

Program Initialisation tab

Invoke program test commands tab

Drop down menu

Popup Menu

FIXME: add functionality

Versions:

v.0.4.4-14 (current)

 changelog: 
 * Added prefix of a common string to all commands.
 issues:
 * none known/reported.

v.0.4.4-12

 changelog: 
 * Added support for new option to send GPS coordinates to both email and sms.
 * Increased the size of the username fields - useful with gmail and such.
 * Removed smscon from the dependencies (to allow promotion in extras)

v.0.4.4-11

 changelog: 
 * Added tests for receiving GPS coordinates commands 
 * Added tests for phonecall and sms commands 
 * Added information and warning boxes 
 * Many visibility enhancement changes
 * Updated icon to be transparent.
 * Added icon for the application manager.
 * Made MailFrom = MailAddress as a temp solution until dedicated space is made for this field in the GUI.
 * Added the About and Credits dialogs.
 * Added smscon in the dependencies.

v.0.4.4-9

 changelog: 
 * Changes in the postinst script to correct it's execution and privileges 
 * Added checks on the configuration file existence and to provide messages to the user when missing or corrupted.

v.0.4.4-5

Warning: This version (and above) will work only with SMSCON version equal or higher than 0.4.4

 changelog: 
 * Addition of a new tickbox to provide "Reply On Keybord Open" settings option.
 * Update of code reading the config file to include spaces in commands (provided by digitalvoid).
 * Corrected canvas of the main window to fit better the N900 screenzise.
 * Increased the width of commands line enter.
 * Corrected the .desktop file to point in the correct iconset
 * Added explicit permissions in the postinst script for the gui elements file.

v.0.4.3-9

 changelog:
 * added block on starting the UI as root (it should only be started as user)
 * the editor will quit after calling the init or reset commands (after informing user).
 * added slightly modified icons.
 * added settings and permissions in sudoers file.
 * cleanup of postinst instructions
 * cleanup of commented out code.

v.0.4.3-8

 changelog:
 * The Editor will trigger a reload of the new configuration after every update of the config file.
 * Temporarily the MailFrom field in the email settings will be filled by the MailAddress (in the future will get its own element in the GUI).
 * Renamed buttons in the UI from Create Settings to Update Settings.

NOTE: For older versions please see the changelogs in the garage page



Future Development

  • add mailfrom field
  • add more test commands
  • password protect the configuration

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; version 2 only.

Disclaimer

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.