SMSCON Editor
(→Versions: added downloads link.) |
(correct section headings, rearrange changelog section) |
||
| Line 7: | Line 7: | ||
In addition, it provides an interface to initialise (i.e. init, start, stop, reset and set/remove from the device's boot sequence) the <code>smscon_daemon</code>. | In addition, it provides an interface to initialise (i.e. init, start, stop, reset and set/remove from the device's boot sequence) the <code>smscon_daemon</code>. | ||
| - | + | ==Installation== | |
| - | + | ||
| - | =Installation= | + | |
The application can be installed directly by the Application Manager (HAM) and the [[Extras]] repositories. (Check [http://maemo.org/packages/view/smscon-editor/ here] for its status) | The application can be installed directly by the Application Manager (HAM) and the [[Extras]] repositories. (Check [http://maemo.org/packages/view/smscon-editor/ here] for its status) | ||
You can also find the latest version in the [https://garage.maemo.org/frs/?group_id=1848&release_id=4063 garage project page]. | You can also find the latest version in the [https://garage.maemo.org/frs/?group_id=1848&release_id=4063 garage project page]. | ||
| - | |||
| - | |||
===Dependencies=== | ===Dependencies=== | ||
The editor depends to the following packages: | The editor depends to the following packages: | ||
| - | + | * smscon | |
| - | + | * python2.5 | |
| - | + | * python2.5-qt4-gui | |
| - | + | * python2.5-qt4-core | |
| - | + | * python2.5-qt4-maemo5 | |
| - | + | ==Usage== | |
| - | + | ||
| - | =Usage= | + | |
When it starts it loads the current configuration file so that the options already configured to be shown in the appropriate sections of the GUI. | When it starts it loads the current configuration file so that the options already configured to be shown in the appropriate sections of the GUI. | ||
FIXME: add explanations | FIXME: add explanations | ||
| - | |||
| - | |||
===Start up=== | ===Start up=== | ||
| Line 125: | Line 117: | ||
FIXME: add more popups and explanations. | FIXME: add more popups and explanations. | ||
| - | + | ==Changelog== | |
| - | = | + | === 0.7-4 ([http://maemo.org/downloads/product/Maemo5/smscon-editor/ current]) === |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | * Addition of more test options. | |
| - | + | * Modification of the Tests tab to be a scrollable list. | |
| + | * Added a button to restart the daemon when tests complete. | ||
| + | * Password to open the editor will persist updates. | ||
| + | * Removed autocapitalisation of first character in several entry fields. | ||
| + | * Aligned Left all entry fields in the Email and SSH tabs. | ||
| - | + | ==== Known issues ==== | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | * none known/reported. | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | === 0.7-3 === | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | * Addition of five new commands and one new option in the UI and code (support for SMSCON ver. > 0.7) | |
| - | + | * Adddition of scrollable list for the commands editing. All the commands now can be edited from one tab. | |
| - | + | * Improvement in the UI to hide SMS reply options when replies are disabled. | |
| - | + | * Improvement in the change password window. | |
| - | + | * Simplification and cleanup in many parts of the code. | |
| - | + | * New About page with auto rotation. | |
| - | + | * Correction for stackable windows. | |
| - | + | ||
| - | + | === 0.6-1 === | |
| - | + | ||
| - | + | * Correction in copying config file for safe editing. | |
| + | * Added creation of temp config file on first use. | ||
| - | + | === 0.6-0 === | |
| - | + | ||
| - | + | * Added password protection for opening the GUI (default password = 12345). | |
| - | + | * Added two new dialog windows (to enter and change the password respectively). | |
| - | + | * Added new initialisation command to delete the application stored IMSI number. | |
| + | * Added new initialisation command to delete the configuration stored. | ||
| + | * New sudoers file to include two scripts for handling operations that need root privileges. | ||
| + | * Removed indirect dependency to rootsh package (i.e. use of root). | ||
| + | * Changed password fields in email and ssh settings to be hidden. | ||
| + | * Changed privileges for supporting files to be more restrictive. | ||
| - | + | === 0.5-5 === | |
| - | + | ||
| - | + | * Added new code to read and encrypt the sensitive config file parameters (Contribution by Frank Visser). | |
| - | + | * Restructure and heavy cleanup of the code. | |
| - | + | * Some small main GUI corrections and beautifications. | |
| - | + | * Package smscon has been added in the dependencies. | |
| - | + | * Changed the sequence for updating the config file to give better information to the user. | |
| - | + | * Updated several messages to be more descriptive. | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | === 0.4.4-14 === | |
| - | + | ||
| - | + | * Added prefix of a common string to all commands. | |
| - | + | ||
| + | === 0.4.4-12 === | ||
| + | |||
| + | * 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) | ||
| + | |||
| + | === 0.4.4-11 === | ||
| + | |||
| + | * 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. | ||
| + | |||
| + | === 0.4.4-9 === | ||
| + | |||
| + | * 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. | ||
| - | + | === 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 | ||
| - | + | * 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. | |
| - | + | ||
| - | + | === 0.4.3-9 === | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | * 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. | ||
| - | + | === 0.4.3-8 === | |
| - | + | * 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 <code>Create Settings</code> to <code>Update Settings</code>. | ||
| - | =Future Development= | + | '''''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== | ||
* add mailfrom field. | * add mailfrom field. | ||
* do not overwrite the password if it is already defined. | * do not overwrite the password if it is already defined. | ||
| Line 240: | Line 228: | ||
* add option to hide the desktop entry. | * add option to hide the desktop entry. | ||
* protect the installation. | * protect the installation. | ||
| - | |||
| - | =License= | + | ==License== |
This program is free software; you can redistribute it and/or modify | This program is free software; you can redistribute it and/or modify | ||
it under the terms of the GNU General Public License as published | it under the terms of the GNU General Public License as published | ||
by the Free Software Foundation; version 2 only. | by the Free Software Foundation; version 2 only. | ||
| - | + | ==Disclaimer== | |
| - | + | ||
| - | =Disclaimer= | + | |
This program is distributed in the hope that it will be useful, | This program is distributed in the hope that it will be useful, | ||
but WITHOUT ANY WARRANTY; without even the implied warranty of | but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
Revision as of 15:00, 7 February 2011
The SMSCON Editor is a user interface to the configuration 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 to the following packages:
- smscon
- python2.5
- python2.5-qt4-gui
- python2.5-qt4-core
- python2.5-qt4-maemo5
Usage
When it starts it loads the current configuration file so that the options already configured to 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 that it has been successfully loaded by the editor.
(Since version 0.6) a password dialog will open and request the application password (NOTE: the default password is 12345)
General configuration tab
Disable All SMS Replies
Choise can be made to disable all SMS replies. In this case, the relevant options will be hidden, i.e. not selectable.
Send GPS Coordinates Replies
Choice can be made where the replies with the GPS coordinates should be send. It can be either one of:
- SMS
- Both
Email configuration tab
Reverse SSH configuration tab
NOTE: Leaving empty the username and password fields will disable the reverse SSH functionality.
Commands renaming first tab
The Commands can be renamed (it is recommended for maximum safety) to ones preferences.
Prefixing Commands
The "Prefix" functionality 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
Note:
- After each test is executed the daemon is stopped and previous configuration is restored.
- Before exiting the application press the "Tests Done" button to start the daemon again.
Drop down menu
About
The about window provides also buttons to connect in the wikis for both parts of the application and read the latest documentation.
Change Password
Menu for changing the password for opening the Editor application.
Popups
There are several popups triggered on actions and updates that inform the user on the current state of the operation.
FIXME: add more popups and explanations.
Changelog
0.7-4 (current)
- Addition of more test options.
- Modification of the Tests tab to be a scrollable list.
- Added a button to restart the daemon when tests complete.
- Password to open the editor will persist updates.
- Removed autocapitalisation of first character in several entry fields.
- Aligned Left all entry fields in the Email and SSH tabs.
Known issues
- none known/reported.
0.7-3
- Addition of five new commands and one new option in the UI and code (support for SMSCON ver. > 0.7)
- Adddition of scrollable list for the commands editing. All the commands now can be edited from one tab.
- Improvement in the UI to hide SMS reply options when replies are disabled.
- Improvement in the change password window.
- Simplification and cleanup in many parts of the code.
- New About page with auto rotation.
- Correction for stackable windows.
0.6-1
- Correction in copying config file for safe editing.
- Added creation of temp config file on first use.
0.6-0
- Added password protection for opening the GUI (default password = 12345).
- Added two new dialog windows (to enter and change the password respectively).
- Added new initialisation command to delete the application stored IMSI number.
- Added new initialisation command to delete the configuration stored.
- New sudoers file to include two scripts for handling operations that need root privileges.
- Removed indirect dependency to rootsh package (i.e. use of root).
- Changed password fields in email and ssh settings to be hidden.
- Changed privileges for supporting files to be more restrictive.
0.5-5
- Added new code to read and encrypt the sensitive config file parameters (Contribution by Frank Visser).
- Restructure and heavy cleanup of the code.
- Some small main GUI corrections and beautifications.
- Package smscon has been added in the dependencies.
- Changed the sequence for updating the config file to give better information to the user.
- Updated several messages to be more descriptive.
0.4.4-14
- Added prefix of a common string to all commands.
0.4.4-12
- 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)
0.4.4-11
- 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.
0.4.4-9
- 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.
0.4.4-5
Warning: This version (and above) will work only with SMSCON version equal or higher than 0.4.4
- 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.
0.4.3-9
- 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.
0.4.3-8
- 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 SettingstoUpdate Settings.
NOTE: For older versions please see the changelogs in the garage page
Future Development
- add mailfrom field.
- do not overwrite the password if it is already defined.
- add more test commands.
- add option to hide the desktop entry.
- protect the installation.
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.