[[HomePage]] > [[SoftwareIndex Software Index]] > [[SoftwareDesktop Desktop]]

====pWidgets====

pWidgets is a tool to show transparent information widgets on your Puppy desktop.

{{image url="http://www.01micko.com/zigbert/pwidgets.png" title="pWidgets" alt="pWidgets" width="500"}}


=={{color text="Download" c="green"}}==
username: ''//puppy//''
password: ''//linux//''

||[[http://www.01micko.com/zigbert/pwidgets-2.6.0-x86_64.pet pwidgets-2.6.0-x86_64]] || [[http://www.smokey01.com/zigbert/pwidgets-2.6.0-x86_64.pet Mirror]] || 182 kb ||64 bit || 21.Feb 2021 ||
||[[http://www.01micko.com/zigbert/pwidgets-2.6.0-486.pet pwidgets-2.6.0-486]] || [[http://www.smokey01.com/zigbert/pwidgets-2.6.0-486.pet Mirror]]|| 321 kb || 32 bit || 21.Feb 2021 ||

The packages contains all dependencies to get you going in most Puppies.
After Installation you'll find the widget manager (pWidget gui) in the Desktop menu.


=={{color text="Links" c="green"}}==
[[https://forum.puppylinux.com/viewtopic.php?f=95&t=322 Forum thread]]

[[https://github.com/01micko/xonclock/tree/master/src xonclock source code and clock skins]]
[[http://www.murga-linux.com/puppy/viewtopic.php?t=39200 More clock skins]]
[[PwidgetsWeather]]


=={{color text="Documentation" c="green"}}==
==How to create a widget==

Simple widget
Take a look at /usr/local/pwidgets/configs/ScrollText. Change the text at bottom of the file. Save new file with another name (keep it in /usr/local/pwidgets/configs). Restart pWidgets, and your new widget is available.

A more complex widget
1.) ENGINE
pWidgets engine is a modified Conky for the Rox desktop. In addition it includes a modified xonclock for the analog clock.

2.) CONFIG
A widget MUST have a config file in /usr/local/pwidgets/configs/ (See examples). Normally this is a ordinary conky config file. The config filename will be the widgets name. Content of this directory shows up in 'Available widgets' list in the pWidgets gui.

3.) SCRIPTS
If external code needs to be run to fetch new info for the widget, call up the widgets script in /usr/local/pwidgets/scripts/. The script should have the same name as the config file. It is also possible to run a specified script before reading config file. 'Downspeed' is an example of this. The script file has the same name as the config file with a -pre ending (Downspeed-pre), and is placed in /usr/local/pwidgets/scripts/.

4.) THEME
Your new widget will follow the global theme settings. If you want to override this you can hardcode colors in config files. Though, the best solution is to make a unique theme for your widget. Themes are placed in /usr/local/pwidgets/themes/THEME/main. The main file works for all widgets. If a unique theme is specified, this one overrides the main theme. The unique theme should have the same name as the config file (widget name).

5.) PLUGIN
If the new widget requires user configuration to works properly, a plugin may do the job. A plugin is a small gui that edits the widget config file. Plugins are stored in /usr/local/pwidgets/plugins/, and has the same name as the config file. It will show up automatically when user adds your widget from 'Available widgets' to 'Widget list'. After user input, let the plugin execute:
. /usr/local/pwidgets/func -apply
fixwidgets
This builds the chosen widget tree including the changed info from this plugin.


==Not working / Older widgets==
Widgets that are not working and not maintained are moved to /usr/local/pwidgets/configs_not_working.
Please hack on these to make them work, and we'll add them to the good-list.



----
==Categories==
CategorySoftware