Installation
First thing required is a component which will host the script files (in JS language) provided by this repository; this component adds new UI panels which may be added to any layout to load such scripts. In resume, these are the following steps:
- Download and install a compatible script host component.
- Add a script host panel to your UI layout.
- Download and install the script files (as package or file).
- Add buttons to toolbar.
Spider Monkey Panel 1.6.1+ or JSplitter 3.6.1.0+ is required. Scripts are compatible with both components and both may be installed at the same time. Different foobar2000 versions and architectures (x86 and x64) require different JS Host versions, check this page for more info.
Add the component to your foofar2000 installation at the Preferences\Components section. Then click install and load the component file.
An SMP or JSplitter panel must be added to the current layout anywhere on the UI. There are some minor differences between the Default UI (DUI) and Columns UI (CUI), but in both cases the layout can be edited using the menu ’View\Layout\Live editing’:
Multiple SMP or JSplitter panels can be added to a layout (being totally independent entities), therefore multiple script panels may be added.
After a panel has been added to the current UI, it must be configured to load the main script file (different for every script/package), either as package or file (as required on the next steps below). It can be done by right clicking on the blank SMP/JSplitter panel.
Set an unique name for the panel so popups can use it instead of panel UUIDs.
Download the package zip file at the releases or nightly page (*), and import the file 'as is' using the 'Package manager' at the Spider Monkey Panel/JSplitter Configuration window. The 'Package manager' can be found at the panel menu (Shift + Win + R. Click anywhere on the panel), at 'Configure panel...'.
(*) Note the nightly link may require to unzip the file first. Check the package is named like '*-SMP-*-*-*-package.zip'.
Click on 'Import' and load the package zip file previously downloaded. Then select it at the list (as shown on the right window).
Close all these SMP/JSplitter windows and follow the instructions at the UI. After that you can directly add buttons to the toolbar as explained here.
Some statistics may require additional components, but they are optional:
- Playback Statistics: Component required to retrieve playback statistics.
- Enhanced Playback Statistics: Component required to retrieve playback statistics.
Additionally, some fonts are required on the system: Font Awesome (v4.7.0+), Arial Unicode MS, Segoe UI and Tahoma.
They can be found here. Install them by double clicking on the ’.ttf’ files and then selecting the ’install’ option (requires Admin rights).
If any font is missing, warnings will be shown with popups and instructions to fix it.
When the script finds it’s being loaded within a portable installation, it will set the default paths using relative paths. It may also warn with popups and/or the console about the -non recommended use of absolute paths on portable installations.
If you upgraded to >1.6 from an older portable version then it may be possible that the ’profile’ folder does not exist. In such case you have to create it and move all the configuration folders/files to it (ask for support at the forum in this case).
Multiple panels are allowed without any special requisite.
There is nothing special to do but following the standard installation steps and overwriting all files as needed. In case an update changes something or requires an additional step, that will be warned on the release itself.