multiamp bb4
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 the classic Winamp, CoolPlayer, K-Jöfol, Winamp3 and foobar2000! :D

Please note that multiamp bb4 requires Blackbox for Windows 0.0.70 or later.

Enjoy! :D

Today is yesterday's tomorrow.

qwilk

revision history
multiamp bb4 (2003-02-08) / qwilk
  • Added support for foobar2000
  • Changed to configuration through plugin menus
  • Added transparency option
  • @maMode - new bro@m to change multiamp mode
  • multiamp.rc is now saved in DOS text format
  • Introducing IntelliMove(tm)... <g> (tries to reposition       the multiamp window automagically on screen       resolution change)
  • 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-2003 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...

    First of all, as of multiamp bb4 configuration is done using the right-click plugin menu (it should be pretty self-explanatory what each menu item does).

    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
    foobar2000 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

    Finally, you can use the @maMode bro@m to change multiamp mode:

    @maMode 1    Winamp mode
    @maMode 2    CoolPlayer mode
    @maMode 3    K-Jöfol mode
    @maMode 4    Winamp3 mode
    @maMode 5    foobar2000 mode

    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. You may also want to tweak the alpha transparency value (see below) to your liking.

    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.transparency: false    Enable transparency?
    multiamp.transparency.alpha: 60    Alpha transparency value
    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    ...Winamp3...
    multiamp.path.foobar2000: c:\Progra~1\foobar2000\foobar2000.exe    ...and foobar2000!

    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.