Queen BeeCon Widget

2010-05-18T18:47:25Z

164.58.145.60: /* Features List */

[[Category:Software]][[Category:Power users]][[Image:Qbw1.png|500px]]

[[Image:Qbw.png|left|logo]]

'''''Queen BeeCon Widget'''''
('''''[http://talk.maemo.org/showthread.php?t=45388 See Talk Thread]''''') is a highly customizable and flexible '''widget-based multi-instance monitoring, alerting and interactive tool''' for Maemo 5 Fremantle and the N900.

The Widget is based on the execution of external Shell/OS Commands which can be either as simple as one-liner statements or as complex as articulated shell scripts, which, for example, fetch, parse and aggregate contents retreived from the system, other applications or the Internet.

There are two basic Widget types, '''Beecons''' and '''Snippets''':

'''''Beecons''''' are small hexagonal cells whose background color or associated image/icon changes according to the executed Command Exit Status.

Beecons can handle '''virtually unlimited Command Exit Status''':

:* '''<0''' Normally notifying '''system errors''' in esecuting the script/command
:* '''0''' Returned when script/command '''successfully completes'''
:* '''1''' Used to report a '''warning condition'''
:* '''2''' If script/command needs to notify some '''application error conditions'''
:* '''<=126''' Other exit status which can be handled for displaying '''user defined icons/images'''

'''''Snippets''''' are normal text/graphic boxes with fixed background color and images which is not influenced by the executed Command Exit Status.

== Current Status in Maemo Repositories ==

'''[http://maemo.org/packages/view/queen-beecon/ (v0.1.4 extras-devel / v0.1.4 extras-testing / v0.1.4 EXTRAs on 26/4/2010)]'''
----

= Features List =

* Widget can be multi-instantiated, disabled and minimized on desktop (click on minimized icon on desktop will wakeup and maximize instance)
* Possibility to define multiple commands and command labels to be displayed inside the Widget
* Different types of Widget layouts and behaviours (currently Beecons and Snippets)
* Possibility to hide the background Canvas both for Beecons and Snippets
* Possibility to use icons/images instead of text both for Beecons/Snippets command title and output (with high positioning, zooming/scaling 5%-200%-FitToWidget versatility) ;)
* It is possible to independently show or hide both snippet's images/texts and beecon images/texts. This way you can have two images and two text placeholders on widget, for more flexibility in graphic layout
* Independent images/icons for Command Exit Statuses >=3 can also been specified. The display of this extended statuses is driven by Command Exit Status. Useful, for example, for displaying different icons according to percentages values returned by command.
* Possibility to use different icons/images for Beecon's status output instead of just specific background color (Ex. 0=green led, 1=yellow led, 2=red led) (with high positioning versatility) ;)
* Nice gummy "button-press"-like visual feedback using Gradient fill
* Widget relies also on a private general purpose directories "~/.queen_beecon_dir/" & "..../MyDocs/.images/queen_beecon_dir/" as images/icons/etc. immediate storage. For easier population via USB of BLUETOOTH File Services.
* Widget texts can be formatted through '''[http://maemo.org/api_refs/5.0/5.0-final/pango/PangoMarkupFormat.html Pango Markup Language''']
* Widget Size can be customized (Width: 10-800, Height: 10-420) and position can be fine tuned (X,Y +/- 5pix); Tweaking '''/usr/share/hildon-desktop/transitions.ini''' may also help. (''snap_grid_size = 1 & snap_to_grid_while_move = 1'')
* Background color for Beecons can be customized for each 4 Command Exit Statuses
* Background color for Snippets can be customized
* Font Color of both command label and results can be configured
* Position and Visibility of both command label and results can be configured (Hidden, Top L, Top C, Top R, Center L, Center, Center R, Bottom L, Bottom C, Bottom R)
* Font Face of both command label and results can be configured (Nokia Sans, NewCourier, NewTimes, Monospace, Nokia Sans Cn, Nokia Sans Maps, Nokia Sans SemiBold, Sans, Serif, SwissA, Tanseek Pro Arabic, Univers OTS Arabic)
* Font Style of both command label and results can be configured (Regular, Italic, Bold, Italic Bold)
* Text Justification of both command label and results can be configured (Left, Center, Right, Fill)
* Font Size of both command label and results can be configured (8->48)
* Command execution can be triggered optionally on widget startup, by manual pressing on Widget, by desktop switching, by periodic updates (0=Manual, 30s, 1m, 5m, 30m, 1h, 6h, 12h, 1d)
* Command execution can be subject to network connection status.
* Tool includes a powerful Advanced Maintenance Dialog Box for command development and testing (TestDrive mode to display raw output of predefined or user-defined commands)
* Advanced Maintenance Dialog Box includes extended functionalities like: instance export/import w/ checksum, command export/import w/ checksum, command update with current Test Drive buffer, clipboard operations.
* A set of basic Images/Icons for Snippets and Beecon Statuses is included inside the distribution package and installed inside canonical hildon hicolor 48x48 directory
* For Web and Proxy related issue please have a look to [http://talk.maemo.org/showpost.php?p=544591&postcount=12 THIS] post.
----
== Icons in Package ==
{|
|-
|[[Image:Queen-beecon.png]]
queen-beecon.png
|[[Image:Queen-beecon-resimg.png]]
queen-beecon-resimg.png
|[[Image:Queen-beecon-noimg.png]]
queen-beecon-noimg.png
|[[Image:Queen-beecon-zzz.png]]
queen-beecon-zzz.png
|-
|[[Image:Queen-beecon-syserr.png]]
queen-beecon-syserr.png
|[[Image:Queen-beecon-appok.png]]
queen-beecon-appok.png
|[[Image:Queen-beecon-appwrn.png]]
queen-beecon-appwrn.png
|[[Image:Queen-beecon-apperr.png]]
queen-beecon-apperr.png
|-
|[[Image:Queen-beecon-index.png.3.png]]
queen-beecon-index.png.3
|[[Image:Queen-beecon-index.png.4.png]]
queen-beecon-index.png.4
|[[Image:Queen-beecon-index.png.5.png]]
queen-beecon-index.png.5
|[[Image:Queen-beecon-index.png.6.png]]
queen-beecon-index.png.6
|-
|[[Image:Queen-beecon-index.png.7.png]]
queen-beecon-index.png.7
|[[Image:Queen-beecon-index.png.8.png]]
queen-beecon-index.png.8
|[[Image:Queen-beecon-index.png.9.png]]
queen-beecon-index.png.9
|[[Image:Queen-beecon-index.png.10.png]]
queen-beecon-index.png.10
|-
|[[Image:Queen-beecon-index.png.11.png]]
queen-beecon-index.png.11
|[[Image:Queen-beecon-index.png.12.png]]
queen-beecon-index.png.12
|[[Image:Queen-beecon-index.png.13.png]]
queen-beecon-index.png.13
|
|}

----

= Settings and Tools =

== Standard Settings and Configuration File ==

Global and per-instance QBW parameters are stored in this file:

/home/user/.queen_beecon

=== Configuration Parameters and Type ===

These are the parameters stored inside the configuration file for each Instance.

These reference is also useful for '''[[#Inter_Process.2FInstance_Communication_over_DBUS|DBUS Inter Process/Instance Communication over DBUS]]''' and in particular for parameters amendments methods

int32 widgetType
int32 operationalStatus
boolean hideCanvas
int32 snippetBgRGB
string beecon_lt0_ImgFilename
int32 beecon_lt0_ImgZoom
int32 beecon_lt0_BgRGB
string beecon_eq0_ImgFilename
int32 beecon_eq0_ImgZoom
int32 beecon_eq0_BgRGB
string beecon_eq1_ImgFilename
int32 beecon_eq1_ImgZoom
int32 beecon_eq1_BgRGB
string beecon_ge2_ImgFilename
int32 beecon_ge2_ImgZoom
int32 beecon_ge2_BgRGB
string beecon_idxge2_ImgFilename
int32 beecon_idxge2_ImgZoom
int32 beecon_idxge2_BgRGB
double widWidth
double widHeight
string cmdImgFilename
int32 cmdImgZoom
int32 cmdFgRGB
int32 cmdVisibilityPosition
int32 cmdImgVisibilityPosition
int32 cmdJustify
int32 cmdFontName
double cmdFontSize
string resImgFilename
int32 resImgZoom
int32 resFgRGB
int32 resVisibilityPosition
int32 resImgVisibilityPosition
int32 resJustify
int32 resFontName
double resFontSize
string instanceTitle
string instanceCmd
boolean updOnStartup
boolean updOnClick
boolean updOnDesktop
uint32 delayIndex
uint32 updNeworkPolicy

== Advanced Settings and Tools ==

Dialog can be reached via QBW Settings:

[[image:169rlh2.png]]

[[image:29q0575.png]]

[[image:Qbwasathsl.jpg|350px]]

;'''Section A: (Command TestDrive)'''

: '''1)''' This is the '''list of Stored Commands''' that you can Test Drive; upon entering the dialog box, [1] & [6] are initialized with current Instance command.
: '''2)''' Use this button to '''Test Drive''' the command currently typed in [6]
: '''3)''' This button will '''update''' current instance '''command''' with the content of [6] (use it when command is working and thoroughly tested)
: '''4)''' Will '''copy to clipboard''' the command currently in [6]
: '''5)''' Will p'''aste the clipboard''' into [6]
: '''6)''' Read-Write text field; this is the '''"command input buffer"''', it is used as extended Test Drive tool for troubleshooting commands with issues
: '''7)''' Read-Only text field; will display the '''Exit Status & Raw Output''' of the command in [6] executed by pressing button [2]

;'''Section B: (Commands/Beecons Import/Export processing)'''

: '''8)''' Button will '''export''' the '''command''' currently in [6]. Result of the export will be stored into [14] text buffer
: '''9)''' Button will '''import''' the '''command''' currently in [14].
: '''10)''' Will '''paste the clipboard''' into [14]
: '''11)''' Will '''copy to clipboard''' the [14] text buffer
: '''12)''' Button will '''import''' the '''Beecon/Snippet Instance Data''' currently in [14]; useful for restoring Beecons of for importing Beecons created by others.
: '''13)''' Button will '''export''' the '''Beecon/Snippet Instance Data''' for the current instance. Result of the export will be stored into [14] text buffer; useful for backup of Beecons of for exporting Beecons to others.
: '''14)''' Read-Write text field; used for temporarily processing '''export/import of commands and Beecon/Snippet Instance Data'''
----

= Inter Process/Instance Communication over DBUS =
==Overview==
As of release '''''>= 0.1.7''''' a new Inter Process Communication mechanism among QBW instances and with other Applications has been implemented.

Through the standard DBUS interface, both at the OS-shell and at different programming environments level, QBW instances can be controlled/accessed and mutual interaction can be guaranteed, thus allowing a set of extended functionalities like:

* Give impulse to a Beecon for content update
* Give impulse to a Beecon for layout update
* Give other beecons one-shot alternative scripts to execute
* Remotely change QBW settings
* Retrieve other beecon's last executed commands exit status
* Provide to non graphical programs and daemons a suitable interface for displaying information on precustomized beecons on screen (for example Dbus Scripts for displaying events on the system/session DBUS like cell IDs changes, available WLANs and the like)

==QBW Instance ID==
Queen Beecon Widget's '''''Instance Id''''', needed for every reference in DBUS method calls, can be found at the very top of the Settings dialog box:

[[Image:Snap017.png|400px]]

==DBUS Specifications==
QBW_DBUS_SERVICE ="oh.no.more.qbw" [Name of D-Bus service]
QBW_DBUS_PATH ="/oh/no/more/qbw'''<idX>'''" [Name of Object Path]
QBW_DBUS_IFACE ="oh.no.more.qbw" [Name of D-Bus interface]

* '''<idX>''' is the '''[[#QBW_Instance_ID|QBW Instance ID]]'''

==DBUS Methods==
'''''wakeup'''''
:Give wake up impulse to a Beecon and updates content and layout

'''''sleep'''''
:Give sleep/disabled impulse to a Beecon (Minimize and Disable)

;'''''update_content'''''
:Give impulse to a Beecon for content update

;'''''update_layout'''''
:Give impulse to a Beecon for layout update

;'''''exec''''' <code>string:'<Alternative command/script>'</code>
:Give other beecons one-shot alternative scripts/commands to execute and update content accordingly

;'''''set_param_string''''' <code>string:'<param name as of settings in QBW file>' string:'<new value>'</code>
;'''''set_param_int32''''' <code>string:'<param name as of settings in QBW file>' int32:'<new value>'</code>
;'''''set_param_uint32''''' <code>string:'<param name as of settings in QBW file>' uint32:'<new value>'</code>
;'''''set_param_double''''' <code>string:'<param name as of settings in QBW file>' double:'<new value>'</code>
;'''''set_param_boolean''''' <code>string:'<param name as of settings in QBW file>' boolean:'<new value>'</code>
:Change and store QBW settings parameter

;'''''get_param''''' <code>string:'<param name as of settings in QBW file>'</code>
:Get QBW settings parameter

;'''''get_exit_status'''''
:Retrieve other beecon's last executed commands exit status

==Interacting with QBW from the Shell==
This is the template to use for calling the QBW instance methods:
run-standalone.sh dbus-send --session --print-reply --type=method_call --dest=oh.no.more.qbw /oh/no/more/qbw'''<idX>''' oh.no.more.qbw.'''<method>''' '''<type1>''':"'''<param1>'''" '''<type2>''':"'''<param2>'''" ... '''<typeN>''':"'''<paramN>'''"

Where:

* '''<idX>''' is the '''[[#QBW_Instance_ID|QBW Instance ID]]'''
* '''<method>''' is the '''[[#DBUS_Methods|Method]]''' to be called for the specific QBW Instance
* '''<typeX>''' & '''<paramX>''' are the parameter '''type''' and '''value''' as per the specific '''[[#DBUS_Methods|Method Synopsis]]'''

For example:
run-standalone.sh dbus-send --session --print-reply --type=method_call --dest=oh.no.more.qbw /oh/no/more/qbwid0 oh.no.more.qbw.update string:"cmdImgFilename" string:"new_image_filename.png"
----

= Known Issues =

TBD
----

= Bug Tracker =

'''[https://garage.maemo.org/tracker/?atid=4848&group_id=1295&func=browse See HERE]'''
----

= Feature Requests =

'''[https://garage.maemo.org/tracker/?atid=4851&group_id=1295&func=browse Apply HERE]'''
----

= Now-Brewing =
Current developments are now focused on providing '''Inter Process Communication among QBW instances and with other Applications'''.

This feature is under design/development as I would like to release the much complete and customizable IPC mechanism possible, like for example:

* '''Give impulse to a Beecon for content update'''
* '''Give impulse to a Beecon for layout update'''
* '''Give other beecons one-shot alternative scripts to execute'''
* '''Remotely change QBW settings'''
* '''Retrieve other beecon's last executed commands exit status'''
* '''Provide to non graphical programs and daemons a suitable interface for displaying information on precustomized beecons on screen''' (for example '''[[DbusScripts]]''' for displaying events on the system/session DBUS like cell IDs changes, available WLANs and the like)

'''''I encourage you to suggest possible enhancements or wishlists in this area.'''''

There are infinite possibilities ... just stay tuned!!!

'''''queen-beecon (0.1.7)'''''
* Changed: Enhanced DBUS implementation for Widget2Widget & System2Widget Inter Process Communication
* Respect: To querty12@talk.maemo.org Many, many, many, many, many thanks for supporting QBW IPC implementation
*Major & Minor Bugfixing
----

= Change Log =
'''''queen-beecon (0.1.6)'''''
* New: Simple DBUS implementation for Widget2Widget & System2Widget Inter Process Communication
* New: Added Widget Instance ID in Settings Dialog Title
* Changed: Compiled Vs. PR1.2

'''''queen-beecon (0.1.5)'''''
* Changed: Thanks "qwerty12" disabled automatic capitalization for all text entry fields

'''''queen-beecon (0.1.4)'''''
* New: Implementation of Widget Instance disabling and minimizing on desktop (click on minimized icon on desktop will wakeup and maximize instance)
* New: Implementation of image/icon scaling function for all images used (Zoom In/Out from 5% to 200% or Fit to Widget Width/Height)
* Bugfixing: In Advanced Maintenance Dialog Box several bugfixes for Import/Export commands and instances,

'''''queen-beecon (0.1.3)'''''
* New: Added possibility to show or hide both snippet's image/text and beecon image/text. This way you can have two images and two text placeholders on widget, for more flexibility in graphic layout
* New: Added supplementary images/icons directory storage "~/Mydocs/.images/queen_beecon_dir". If images/icons without path are not found here then they are searched in "~/.queen_beecon_dir". For easier population via USB of BLUETOOTH File Services.
* New: Added functions in Advanced Maintenance Dialog Box: instance export/import w/ checksum, command export/import w/ checksum, command update with current Test Drive buffer, clipboard operations
* New: Added some confirmation dialogs for critical operations and some notification messages
* New: Added possibility to use different images/icons for Command Exit Statuses >=3 . Basically the Exit Status value will be appended to a fixed image filename and relevant image will be loaded (ex. "queen-beecon-status.png.3" ... 4 ... 5 ...)
* New: Basic Images/Icons for Snippets and Beecon Statuses incorporated into .deb package and installed inside canonical hildon hicolor 48x48 directory
* Bugfixing: Fixed size and positioning of controls in Advanced Maintenance Dialog Box
* Bugfixing: Removed directory purge in "rmnobraco.sh" script
* Bugfixing: Checked and removed some memory leaks and resources deallocation (were causing hildon-home desktop to crash on instance disposal)
* Changed: Restyle and lots of optimization in Settings Dialog Box UI layout
* Changed: Widget's fill gradients when background is enabled
* Changed: Restyle in Advanced Maintenance Dialog Box interface, now more functional and user friendly
* Changed: When opening Advanced Maintenance Dialog Box, command in current instance is automatically copied to the TestDrive command text box
* Changed: Advanced Maintenance Dialog Box changed font to Monospace Bold for the three text views for inproved visibility

'''''queen-beecon (0.1.2)'''''
* New: Implemented Pango Markup Language support for both Command Title and Output Results text ([http://maemo.org/api_refs/5.0/5.0-final/pango/PangoMarkupFormat.html Description HERE])
* New: Basic implementation of Advanced Maintenance Dialog Box (For future use like export/import ...)
* New: Advanced Maintenance Dialog Box: TestDrive mode (to display raw output of predefined or user-defined commands)
* Changed: Had to change description in debian "control" file (Testers Karma-- me for this)
* Changed: Changed logic in settings dialog box, now it doesn't redraw unless strictly necessary and just content and controls which need it. Also quicker transition to main settings when back from child dialog boxes.

'''''queen-beecon (0.1.1)'''''
* Changed: Visual feedback for widget pressure is now also provided for Canvas-less beecons and snippets (button down canvas is displayed when pressed)
* Changed: Changed default size for newly created instances (50px=>100px)
* Changed: Housekeeping for dead/disposed instances is now run on each instance initialization and on class termination (should be more accurate now)
* Bugfixing: Writing/Reading configuration file inconsistencies fixed
* Bugfixing: Correction in images (status/results/title) hide/show logic. If images displayed and then commented out, they kept showing! - FIXED

'''''queen-beecon (0.1.0)'''''
* WARNING! Architecture and readibility of code has been heavily revised for implementing the new functionalities...
* WARNING! Please bear with possible regressions and report bugs to the Maintainer
* New: Implemented the possibility to hide the background Canvas both for Beecons and Snippets
* New: Implemented the possibility to use different icons/images for Beecon's status output instead of just specific background color (Ex. 0=green led, 1=yellow led, 2=red led) (with high positioning versatility)
* New: Implemented the possibility to use icons/images instead of text both for Beecons/Snippets command title and output (with high positioning versatility)
* New: Implemented creation and management of private general purpose directory "~/.queen_beecon_dir" for widget (images/icons/etc.)
* New: Implemented "Update on widget Startup" option for every instance
* New: Implemented basic management/deletion of dead/disposed instances configurations data from config file
* New: Added button "Save & Run" settings dialog which saves settings and contextually triggers command execution
* Changed: Widget Layout is now nicer with better gummy "button-press" like visual feedback using Gradient fill
* Changed: Button Save in settings dialog does not trigger a command execution any more
* Changed: Now command do not get updated after getting back from settings dialog (even after "save"); relevant event only drives updates (manual, timer, desktop, network)

'''''queen-beecon (0.0.3)'''''
* Bugfixing for widget resize(dimensions) and positioning
* Bugfixing for general network related behaviours and content update, even after settings change
* Bugfixing for Command Edit and blank command selector after returning from command edit dialog
* Changed Exit Code output for command from !?0000xxxx to !?xxxx
* Changed Command Output is returned, if any, even if Exit Code less then 0

'''''queen-beecon (0.0.2)'''''
* First Extras-devel release

'''''queen-beecon (0.0.1)'''''
* Initial Basic Queen BeeCon Implementation
----

= TODO list =

*Bugfixing and Improving Stability
*Instance Import/Export optimization and simplification
----

= HOW-TOs =

== Create a new Basic Instance of QBW ==
After you have installed QBW package, these are the steps to '''create''' and start customizing a '''new Instance''' of the widget.

* Tap on an empty area of the Desktop and gear icon for configuration will pop up in the upper right area of the screen
:[[Image:Qbwinst1.png]]
* Click on the "Add widget" button
:[[Image:Qbwinst2.png]]
* Scroll selector till you find "Queen Beecon Widget" and click on it
:[[Image:Qbwinst3.png]]
* A new instance of the widget will be created with very basic default configuration
:[[Image:Qbwinst4.png]]
* Now if you click on the Settings Wrench Icon you'll reach the '''Settins Dialog''' for customization
----

== How and Where to store Icons and Images for your Beecons ==
'''If no PATH is specified in the Settings for Icons & Images''', QBW will look in directories on the phone's internal memories in the following '''order''':

* '''First''', the directory accessible via Bluetooth/PC Suite/OVI Suite or USB (Storage Mode).

/home/user/MyDocs/.images/queen_beecon_dir/

:[[Image:Qbwwtsi.png]]

:'''WARNING!!! When phone is connected via USB in Storage Mode this directory is not available to the Widget'''; so if you plan to use QBW when in Storage Mode use directory in '''"Second"''' point.

* '''Second''', the directory:
/home/user/.queen_beecon_dir

* '''Third''', the directory where QBW's '''[[#Icons_in_Package|Package Icons]]''' are stored:
/usr/share/icons/hicolor/48x48/hildon/

If you want '''to replace a partial/complete set of QBW's [[#Icons_in_Package|Package Icons]]''' just create Icons/Images with same name in directories '''"First"''' or '''"Second"'''

If specified '''image''' is '''not found''', following icon will appear:

[[Image:Queen-beecon-noimg.png]]
----

== Create an Exit Status driven Multi Images Beecon ==
'''[http://talk.maemo.org/showthread.php?p=576408#post576408 Naive Dice Roller]''' is a good place to start looking for such implementation.
----

== Scripts/Commands with long output ==

Some scripts/commands may create multiple lines which are too long to be displayed on a single line. The widget will not wrap these. In order to wrap them you can use the fold command:

command-that-produces-long-lines | fold -s -w 80

The 80 in that instance is the maximum length of the line, which you can change. The -s option makes fold word wrap with spaces. More information is available from the [http://unixhelp.ed.ac.uk/CGI/man-cgi?fold fold man page].
----

== Backup all Widget Instances ==
Apply '''[[#Export.2FSave.2FBackup_Procedure_for_Beecon_Instance_Data|Export/Save/Backup Procedure for Beecon Instance Data]]''' for every Widget Instance you want to Backup

Save content (Beecons' Images) of directories:
/home/user/.queen_beecon_dir
/home/user/MyDocs/.images/queen_beecon_dir/
----

== Restore all Widget Instances ==
Apply '''[[#Import.2FLoad.2FRestore_Procedure_for_Beecon_Exported_Instance_Data|Import/Load/Restore Procedure for Beecon Exported Instance Data]]''' for every Widget Instance you want to Restore

Restore content (Beecons' Images) of directories:
/home/user/.queen_beecon_dir
/home/user/MyDocs/.images/queen_beecon_dir/
----

== Import/Load/Restore Procedure for Beecon Exported Instance Data ==
'''[http://talk.maemo.org/showthread.php?p=572028#post572028 See HERE]'''
----

== Export/Save/Backup Procedure for Beecon Instance Data ==
'''[http://talk.maemo.org/showthread.php?p=613152#post613152 See HERE]'''
----

== Copy Exported Instance Data from Browser to Phone's Clipboard ==
'''[http://talk.maemo.org/showthread.php?p=575685&post575685 See HERE]'''
----

== Reset QBW to Default Configuration/Commands ==
* Open up [[terminal|X-Terminal]] (or SSH/Putty into N900) and issue the following command
sudo gainroot (only if you are not already root)
rm /home/user/.queen_beecon
killall hildon-home
----

== Completely remove QBW from your N900 ==
* Open up [[terminal|X-Terminal]] (or SSH/Putty into N900) and issue the following command
sudo gainroot ''(only if you are not already root)''
dpkg -P queen-beecon
rm /home/user/.queen_beecon
rm -r /home/user/.queen_beecon_dir
rm -r /home/user/MyDocs/.images/queen_beecon_dir/
----

= Easter Eggs =

== Magic Word for bypassing Export/Import Instance Data CheckSum protection ==
[[Image:Qbwlsowk.jpg]]

'''Use the Source ... Luke! ;)''' or ask politely!!!
----

= Troubleshooting =

== Startup ==
If you are having '''issues at widget startup''' because of '''improper "Update on Widget/System Startup"''' settings:

* Open up [[terminal|X-Terminal]] (or SSH/Putty into N900) and issue the following commands:
sudo gainroot ''(only if you are not already root)''
vi /home/user/.queen_beecon

* find '''updOnStartup=true''' (all instances supposed to be culprits)

* Set it to false ('''updOnStartup=false''')

* Save file

* Immediately issue:
killall hildon-home

* hildon-home will automatically restart and widgets won't run any more at startup
----

== Running ==

=== "No Output" is displayed inside Widget instead of expected output ===
If you are using '''[http://maemo.org/api_refs/5.0/5.0-final/pango/PangoMarkupFormat.html Pango Markup Language'''] Tags as output from your scripts, make sure all Tags are correctly written/spelled and terminated.

If you need to display the following special characters:

These '''NEED''' to be escaped:

*The '''less-than character (<)''' starts element markup (the first character of a start-tag or an end-tag). ''Escape'': '''&lt;'''

*The '''greater-than character (>)''' ends a start-tag or an end-tag. ''Escape'': '''&gt;'''

These '''MIGHT NEED''' to be escaped:

*The '''ampersand character (&)''' starts entity markup (the first character of a character entity reference). ''Escape'': '''&amp;'''

*The '''double-quote character (")''' can be symbolised with this character entity reference when you need to embed a double-quote inside a string which is already double-quoted. ''Escape'': '''&quot;'''

*The '''apostrophe or single-quote character (')''' can be symbolised with this character entity reference when you need to embed a single-quote or apostrophe inside a string which is already single-quoted. ''Escape'': '''&apos;'''
----

=== Beecon seems to hang when fetching data or accessing the Internet/Network ===
Please have a look to '''[http://talk.maemo.org/showthread.php?p=544591#post544591 THIS]''' post for '''Timeout and Proxy related issues'''.
----

= Published Beecons, Scripts & Commands =

== Beecons ==

=== N900 Overclocking (Thanks [http://talk.maemo.org/member.php?u=23878 Jakiman] and all contributors) ===
[[Image:Qbwn900oc.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=595582#post595582 Guide]''' will give you a thorough insight of the N900 overclocking methods with plenty of instructions and tutorials. QBW will provide a GUI Button for switching OC Frequencies

=== Random Images/Photos Slideshow (4x3 and 16x9 frames) ===
[[Image:Qbwrips1.jpg|200px]] [[Image:Qbwrips2.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=630492#post630492 Beecon]''' will display random photos/images from a specified directory. Both 4x3 and 16x9 aspect ratios white frames are provided. Change update policies as per your taste.

=== N900 Mini Monitor (Extras Admission Celebration Edition)!!! ===
[[Image:Qbwnmmeace.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=629644#post629644 Beecon]''' will show System Information relevant to Battery, CPU and Load, Uptime, Network/Internet, WIFI and File Systems.

=== Zodiac Personal Horoscope (Italian + Bonus Read [http://talk.maemo.org/showthread.php?p=626316#post626316 Talk]) ===
[[Image:Qbwzph.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=626316#post626316 Beecon]''' will show your horoscope for the day. It will be personalized with the image/icon of the sign you specify.

=== Lunar Phases ===
[[Image:Qbwlf.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=625611#post625611 Beecon]''' will show the current phase of the moon.

=== Ebay Item Watcher ===
[[Image:Qbwebay.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=620123#post620123 Beecon]''' will watch an item that you specify and will provide a small Photo, Item Number, Current Bid or Buy It Now Price, Time Left for bidding, Bid Count, High Bidder and Quantity.

=== Internet Traffic Report Live Graphs ===
[[Image:Qbwitr1.jpg|200px]] [[Image:Qbwitr2.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=619178#post619178 Beecons]''' will fetch some Graphs from the [http://www.internettrafficreport.com Internet Traffic Report] website. The Internet Traffic Report monitors the flow of data around the world. It then displays a value between zero and 100. Higher values indicate faster and more reliable connections. See [http://www.internettrafficreport.com/faq.htm ITR FAQs] to learn more.

=== Today Schedules for TVRage.com Favourites TV Serials ===
[[Image:Qbwststvr.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=616496#post616496 Beecon]''' will also provide a small miniature if your most favourite Show is aired on the day.

=== N900 Hard Sleep Mode ===
[[Image:Qbwn900hsm.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=610074#post610074 Beecon]''' will put the N900 into Hard Sleep Mode. When pressed, it'll perform the following actions: Set WIFI OFF, Change phone network mode to GSM, Shutdown all network connections, Blank the screen, Lock device

=== European Soccer Leagues Live Results and Next Matches Beecon ===
[[Image:Qbwesllrnm.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=571270#post571270 Beecon]''' will also be able to highlight the match of your favourite Team and display a Green ball if it is winning, Yellow ball if match is tied, Red ball if team is losing, White ball if match is still not currently being played.

=== World Cup 2010 South Africa - Live Results, News and Next Matches ===
[[Image:Qbwwc2010sa.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=612646#post612646 Beecon]''' will also provide the most recent WC2010 news and will be able to highlight the match of your favourite Team and display, behind mascot, a Green ball if it is winning, Yellow ball if match is tied, Red ball if team is losing, White ball if match is still not currently being played.

=== Naive Dice Roller ===
[[Image:Qbwndr.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=576408#post576408 Beecon]''' will show a dice that you'll be able to roll by clicking on it.

=== World Day & Night Zones ===
[[Image:Qbwwdanz.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=576390#post576390 Beecon]''' will display a map of the '''world''' and current position of the '''Sun''', indicating which parts of the Earth are in '''day''' and which are in '''night'''.

=== European Accuweather Meteo ===
[[Image:Qbwamb.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=573590#post573590 Beecon]''' will display the meteo graphs provided by Accuweather.com for Western Europe

=== MRTG The Multi Router Traffic Grapher ===
[[Image:Qbwmrtg.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=573426#post573426 Beecon]''' will display the graphs provided by the uber-famous MRTG - The Multi Router Traffic Grapher

=== GMail: New Mail Notifier Beecon ===
[[Image:Qbwgmn.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=572068#post572068 Beecon]''' will display an empty mailbox icon or a yellow full mailbox icon and the number of new unread messages of the specified GMail account

=== Italian Ringroads (Tangenziali) Live Traffic Beecon ===
[[Image:Qbwmrltb.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=569345#post569345 Beecon]''' is configured to display Live Traffic graphic status of Milan Ringroads System. Other major cities in Italy are also available: ROME, TURIN, FLORENCE, NAPLES, BOLOGNA!

=== MLB Major League Baseball Matches of the Day (+tutorial/walkthrough) ===
[[Image:Qbwmlbmotd.jpg|200px]]

The '''[http://talk.maemo.org/showthread.php?p=563906#post563906 Beecon]''' will display near Real Time MLB Major League Baseball Matches results. The Widget is also capable of showing different icons/images/emoticons according to the result of a Favourite Team.

== Scripts & Commands ==

'''[[Desktop Command Execution Widget scripts]]''' '''''Warning:''''' This are scripts for Desktop Command Execution Widget; QBW has extended functionalities so it might be needed to tweak scripts or commands a little bit for both cosmetic and functional improvements.
----

== Useful References ==

'''[[DbusScripts]]''' is a daemon that can execute a command when various actions occurs on DBus

'''[[Phone_control]]''' D-Bus commands can be run from terminal or as shell scripts. Useful for scheduling events with fcron, executing commands, , startup events, install scripts, etc.
----

Maemo Wiki Mirror - User contributions [en]

Queen BeeCon Widget