Please note that BBbin 1.2.1 requires xoblite bb1 or
later / Blackbox for Windows 0.0.91 or later.

Enjoy! :D

Today is yesterday's tomorrow.

qwilk

BBbin 1.2 (2003-09-03) / qwilk

BBbin 1.0 (2003-01-23) / qwilk

BBBIN IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE AUTHOR DISCLAIM ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF THE AUTHOR OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

If you are using xoblite:
To load BBbin, you simply need to select Load plugin... in the Configuration/Plugins menu
(this item is also available in the Slit menu), locate BBbin.dll, and click "Open". Simple, eh? :)

If you are using Blackbox for Windows:
To load BBbin you need to add the relative path of the plugin (from your Blackbox directory) to the Blackbox configuration file plugins.rc (located in the Blackbox directory). For example, if you installed Blackbox into c:\Blackbox, and BBbin.dll is located in c:\Blackbox\plugins\BBbin, you should add the line...

plugins\BBbin\BBbin.dll

...to plugins.rc.

how to use bbbin...

Just three things really: All configuration (except for setting the alpha transparency value, see below) is performed using the right-click plugin menu (it should be pretty self-explanatory what each menu item does). Second, you can doubleclick on the BBbin window to empty the recycle bin. Third, you can X click the window to dock to / undock from the slit.

bbbin.rc settings

I have included a default configuration file (bbbin.rc) in the .zip, but if a configuration file for some reason (e.g. you deleted it <g>) can not be found at startup (BBbin will first search for it in the same directory as the plugin, then in the Blackbox directory), BBbin will automatically create one for you in the same directory as the plugin. Normally, you do not need to edit this file manually, however you may want to tweak the alpha transparency value (see below) to your liking.

bbbin.x: 0    X position
bbbin.y: 0    Y position
bbbin.alwaysontop: false    AlwaysOnTop?
bbbin.snapwindow: true    Snap BBbin window to screen edges?
bbbin.transparency: false    Enable transparency?
bbbin.transparency.alpha: 60    Alpha transparency value
bbbin.dockedtoslit: false    Docked to the slit? (ie. slit mode if true, plugin mode if false)

Finally, you can control BBbin using the following broadcast messages (bro@ms)...

@BBbin OpenRecycleBin
@BBbin EmptyRecycleBin
@BBbin ToggleDockedToSlit
@BBbin ToggleAlwaysOnTop
@BBbin ToggleSnapWindowToEdge
@BBbin ToggleTransparency

...which are equivalent to the items in the BBbin plugin menu. Hmm, I guess that's it! :D