Sublets\015\012\015\012{{>toc}}\015\012\015\012Sublets 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.\015\012\015\012h2. Installation\015\012\015\012h3. Easy\015\012\015\012The easiest way to install a sublet is to let sur do all the dirty work, it's designed to be really easy and works in a rubygems like fashion and since r2138 bundled with subtle.\015\012\015\012Generally sur is the subtle user repository for user contributed sublets, everyone can submit sublets via sur.\015\012\015\012

\015\012sur install clock\015\012sur uninstall clock\015\012sur notes clock\015\012sur config clock\015\012

\015\012\015\012h3. Hard\015\012\015\012Ok, 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:\015\012\015\012# A sublet file (.rb) [$XDG_DATA_HOME/subtle/sublets]\015\012# A specification file (.spec) [$XDG_DATA_HOME/subtle/specifications]\015\012# Zero or more icons (.xbm) [$XDG_DATA_HOME/subtle/icons]\015\012\015\012The 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.\015\012\015\012h2. Configuration\015\012\015\012Since r2222 there are five default sublet properties than can be changed from the config of subtle without ever touching the sublet files:\015\012\015\012# interval Update interval of the sublet\015\012# foreground Default foreground color\015\012# background Default background color\015\012# text_fg Text foreground color (r2694)\015\012# icon_fg Icon foreground color (r2694)\015\012\015\012_The color settings will override the default colors specified in the config._\015\012\015\012To configure a sublet you just need to add a sublet block to your subtle config, similar to the ones for e.g. tags.\015\012\015\012Here is an example how to customize the interval, color and format of the clock sublet:\015\012\015\012

{{hide}}sublet :clock do\015\012  interval      50\015\012  foreground    "#eeeeee"\015\012  background    "#000000"\015\012  format_string "%H:%M"\015\012end

\015\012\015\012Generally 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.\015\012\015\012h2. Grabs\015\012\015\012Sublets 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\015\012\015\012Example:\015\012\015\012

{{hide}}grab "A-b", :SubletTest

\015\012¶