multiamp bb3
description
multiamp is a Blackbox for Windows plugin that provides convenient and stylish access to common media player controls. It can be set to use either horizontal or vertical display mode, and true to its Blackbox heritage the graphics are rendered on-the-fly according to the current Blackbox style settings, as well as updated automatically on style change. And, just as its name implies, multiamp supports Winamp, CoolPlayer, K-Jöfol and Winamp3! :D

Please note that multiamp bb3 requires Blackbox for Windows 0.0.60 or later.

Enjoy! :D

Today is yesterday's tomorrow.

qwilk

revision history
multiamp bb3 (2002-09-07) / qwilk
  • Uses the updated API in Blackbox for Windows 0.0.60
  • Displays the song title in the Blackbox toolbar
          on track change (Winamp and K-Jöfol only)
  • Added bro@m support: @maPrev, @maPlay,
          @maPause, @maStop, @maNext, @maOpenFile,
          @maMenu, @maPower, @maVolumeUp,
          @maVolumeDown
  • Added *experimental* support for Winamp3 (requires       Nick Schweitzer's Winamp 2.x plugin manager)
  • multiamp now checks if it is inside the visible screen
          at startup
  • Minor bug fixes
  • multiamp bb2 (2002-06-29) / qwilk

  • Added support for CoolPlayer and K-Jöfol v0.51
  • Click and hold now works on the volume buttons
  • multiamp bb1 (2002-06-24) / qwilk

  • Original release
  • future releases?
  • Support for more media players...? <vbg>
  • [your wish goes here - send me your ideas! :D ]
  • license information
    © 2002 Karl-Henrik Henriksson [qwilk]

    MULTIAMP 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.

    initial setup

    To load multiamp you simply 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 multiamp.dll is located in c:\Blackbox\plugins\multiamp, you should add the line...

    plugins\multiamp\multiamp.dll

    ...to plugins.rc. Simple, eh? :)

    how to use multiamp...

    The multiamp buttons (in left-right (horizontal) or top-bottom (vertical) order)...

    Winamp mode:
    Previous track, Play, Pause, Stop, Next track,
    Open file(s), Show menu, Power on/off, Volume up, Volume down
    CoolPlayer mode:
    Previous track, Play, Pause, Stop, Next track,
    Open file(s), Playlist, Power on/off, Volume up, Volume down
    K-Jöfol mode:
    Previous track, Play, Pause, Stop, Next track,
    Open file(s), Preferences, Power on/off, Fwd 5 seconds, Rew 5 seconds
    Winamp3 mode:
    Previous track, Play, Pause, Stop, Next track,
    Open file(s), Playlist, Power on/off, Volume up, Volume down

    ...and their equivalent broadcast messages (bro@ms):

    @maPrev, @maPlay, @maPause, @maStop, @maNext,
    @maOpenFile, @maMenu, @maPower, @maVolumeUp, @maVolumeDown

    You can also use the following mouse commands to control the multiamp window etc.:

  • Left click and hold to drag the window
  • Right click to toggle between horizontal and vertical mode
  • Shift + Right click to select control mode (Winamp, CoolPlayer, K-Jöfol, Winamp3)
  • Mid click to toggle AlwaysOnTop
  • X1 click to toggle SnapWindowToEdge
  • X2 click to show the "About" information...
  • Please note that due to some odd Windows behaviour, the drag area (= window edges outsite the "button area") does not pass any other mouse clicks through, so please right/mid/X1/X2 click within the "button area" for them to work... you'll get used to it eventually... =]

    multiamp.rc settings

    I have included a default configuration file (multiamp.rc) in the .zip, but if a configuration file for some reason (e.g. you deleted it <g>) can not be found at startup (multiamp will first search for it in the same directory as the plugin, then in the Blackbox directory), multiamp will automatically create one for you in the same directory as the plugin. Normally, you do not need to edit this file manually, however there are some settings such as paths to executables (see below) that may need to be edited for multiamp to work correctly.

    multiamp.x: 1    X position
    multiamp.y: 1    Y position
    multiamp.alwaysontop: true    AlwaysOnTop?
    multiamp.vertical: false    Horizontal or vertical mode?
    multiamp.snapwindow: true    Snap multiamp window to screen edges?
    multiamp.selectedplayer: winamp    Selected control mode
    multiamp.path.winamp: c:\Progra~1\Winamp\winamp.exe    Path to the Winamp executable...
    multiamp.path.coolplayer: c:\Progra~1\CoolPlayer\coolplayer.exe    ...CoolPlayer...
    multiamp.path.k-jofol: c:\Progra~1\Kjofol\kjofol.exe    ...K-Jöfol...
    multiamp.path.winamp3: c:\Progra~1\Winamp3\Studio.exe    ...and Winamp3

    Please note that multiamp automatically saves the current running configuration when you quit or restart Blackbox, overwriting the previous contents of the file. The solution is to restart Blackbox from the menu while holding down the Shift key, which will unload all plugins and display a message box telling you that the restart has been paused. Now make your edits to the file and save, then click OK to continue the restart. multiamp will now read your manually edited settings.