Sublets are small Ruby scripts written in a small DSL that can provide things like system information for the panel. They are well included in the main loop of subtle and can be used in various ways. Further information about writing a sublet can be found here.
sur install clock sur uninstall clock sur notes clock sur config clock
Ok, you asked for it: Point your browser to http://sur.subforge.org/ and download a sublet. Then you need to unpack the sublet - they are just tarballs. Once unpacked you will probably find three types of files:
- A sublet file (.rb) [
- A specification file (.spec) [
- Zero or more icons (.xbm) [
The files need to be installed in the appropriate folders in
$XDG_DATA_HOME/subtle and after a reload of either the config or the sublets you are done.
sublet :clock do interval 50 style :foobar format_string "%H:%M" end
Generally sublets can provide further properties, but it's up to the author to use this and to add either notes or config information about it.
Sublets can also provide grabs (since r2608), that are just added to the supported types and can be used like all other from the config. Like notes and config it's up to the author to supply information, sur shows of list of grabs with following command:
sur grabs subletname
grab "A-b", :SubletTest