HomePage > SoftwareIndex Software Index > SoftwareDesktop Desktop

pWidgets


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

pWidgets


Download
username: puppy
password: linux

pwidgets-2.6.0-x86_64 Mirror 182 kb 64 bit 21.Feb 2021
pwidgets-2.6.0-486 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.


Forum thread

xonclock source code and clock skins
More clock skins
PwidgetsWeather


Documentation
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
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki