uberbox_lite 1.2
description
uberbox_lite is a command line plugin for Blackbox for Windows that enables you to execute any command in your flavour of bb4win, be it:
  • a bro@m, or
  • shell command
uberbox_lite 1.2 requires any Blackbox for Windows flavour issued since 2005
initial setup
  • Use the load plugin menus provided in your flavour of bb4win and browse to the location of the uberbox dll
  • OR add the relative path of the plugin to the BB configuration file plugins.rc
    • located in the Blackbox directory
    • OR accessed by Win+P with bbKeys
    For example, if Blackbox is installed in c:\Blackbox, and uberbox.dll is located in c:\Blackbox\plugins\uberbox\, you should add the line...

    plugins\uberbox\uberbox.dll ...to plugins.rc.

    • revision history

    uberbox_lite 1.2 (2009-06-01) / unkamunka

  • Alias input form fixed
  • Styling options
  • Bugfixes, updates & enhancements

    • uberbox 0.1.1 (2005-01-25) / tzec

  • Alias listing

    • BBZCdEx 0.1 (2004-01-25) / Procic Konstantin

  • Stylistic input only

    • broambox 0.01.1 (2003-11-01) / Tres'ni

  • Original release
    • future releases?
  • handling of variables
  • post your ideas to the uberbox forum thread
  • tell us about them at irc://irc.freenode.net/bb4win
    • known issues
  • new settings may require a reload of uberbox
  • xoblite - scrolling issue for listings on Vista
  • exiting the Slit places uberbox in top left corner
  • not always on top - use bbSlit
  • non-classic autohide behaviour on right & bottom screen edges
  • possible to drag window partly offscreen
    • license information
    © 2003-2009 Brian Hartvigsen, John Williamson All rights reserved.

    Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • The name of the author nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission.

    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    • using uberbox...

    Mouse Input

    Once the plugin is loaded, several things can be done with a simple click on the UberBox:

    LeftClick + Ctrl  - this lets you drag UberBox around
    RightClick + Ctrl  - access the plugin Menu
    RightClick + Shift  - listing of current aliases (handy!)

    Drag & Drop

    Dragging & dropping files on UberBox pops up a dialog to create an alias - with optional <args>

    Keyboard Input

    Make UberBox the focused window (by clicking on the Box) & it can accept keyboard input.

    Up|Down|MouseWheel  scroll through history|auto-complete if text already in the Box
    Tab  Autocomplete current entry if matched in the history
    Shift + Tab  Autocomplete current path (bash|csh). Repeated pressing cycles options
    Escape  switch back to the window that previously had focus if the Box was focused with a @broambox.focus command
    Ctrl + L  Pop up a dialog to create an alias for the current text in the Box
    Ctrl + E  Open aliases.rc for editing
    Ctrl + I  Create a bbInterface button for the current text in the Box
    Ctrl + A  Autohide

    Miscellaneous Notes

  • "aliases.rc" controls aliases used in UberBox - a sample is in the zip file
  • A single space is needed to separate an alias from its command - such as:
    vi gvim.exe
    ie "c:\program files\internet explorer\iexplore.exe"
  • '?' before the alias - with "<args>" at the very end will create a web query:
    ?dict http://www.dictionary.com/search?q=<args>

    Autohide: Enabling autohide when UberBox is not on a screen edge will cause the uberbox window to be rolled up

    Why can't I set the height? Height of UberBox is determined by "fontHeight:" for the chosen UberBox style

    uberbox.rc settings

    uberbox.rc is created on first load - with default settings:

    broambox.X: 595  X position of the uberbox
    broambox.Y: 30  Y position of the uberbox
    broambox.width: 200  Length of the uberbox
    broambox.alpha:  Value of transparency -> default is Menu.alpha
    broambox.style: toolbar button pressed  Sets the style
    broambox.bevelStyle: sunken bevel  Sunken, Flat, Raised or Default?
    broambox.location: com  Default territory for Google searches - de? se? ca? ru? co.uk?
    broambox.borderStyle: false  Outer border same style as the EditBox?
    broambox.autoHide: false  Toggle autohide mode for the uberbox
    broambox.visible: true  Option to hide - see bro@ms
    broambox.inSlit: false  Position via the Slit?
    broambox.regex: false  Enable RegEx matching?
    broambox.regexdebug: false  For debugging RegEx syntax

    uberbox bro@ms

    @BBShowPlugins  Standard BB bro@m to show all plugins
    @BBHidePlugins  Standard BB bro@m to hide all plugins

    @broambox.hide  Hides it
    @broambox.show  Shows it
    @broambox.toggle  Toggles visibility
    @broambox.focus  Focuses it (very useful if you map a key to it!)
    @broambox.relay  Relays any command (also useful for mapping keys to)
    @broambox.showAliases  Shows list of Aliases
    @broambox.reload  Make uberbox reload its settings
    @broambox.editAliases  Open the aliases.rc file with your preferred editor
    @broambox.editRC  Open the uberbox.rc file with your preferred editor
    @broambox.editHistory  Open the history.rc file with your preferred editor
    @broambox.loadDocs  Load the documentation file in your browser
    @broambox.about  Display message box about the plugin

    Value & True|False bro@ms can also be set for most of the uberbox.rc entries:
    @broambox.width   @broambox.toggleSlit   @broambox.alpha   @broambox.sameBorder   @broambox.visible   @broambox.location

    commands supported

    @xx - posted as a bro@m to bb4win
    xx - processed as command line
    ?xx - sent as a query to Google
    [xx] - processed as an internal command - see below
    *xx - redirected as std. out to a file & opened in the default blackbox editor
    #xx - opened as a text file in the default blackbox editor
    x.x - processed as a web address - if not command line

    bb4win internal commands
    [exit]  Quit BB4Win
    [quit]  Quit BB4Win
    [shutdown]  Shutdown Computer
    [reboot]  Reboot Computer
    [logoff]  Logoff Computer
    [hibernate]  Hibernate
    [suspend]  Suspend
    [lock]  Lock Workstation
    [run]  Show Run dialog
    [reconfig]  Reconfigure BB4Win
    [restart]  Restart BB4Win
    [editstyle]  Edit current style
    [editmenu]  Edit menu.rc
    [editplugins]  Edit plugins.rc
    [editextensions]  Edit extensions.rc