Skip to content

Installation

regorxxx edited this page Dec 1, 2023 · 9 revisions

As package (recommended)

Spider Monkey Panel 1.6.1 or higher is required. Only stable releases are supported.

Download the package zip file at the releases page, and import the file 'as is' using the package manager at the Spider Monkey Panel Configuration window. If any popup is shown, take your time reading them. They must be closed before closing the Spider Monkey related windows. Then, after managing all popups, close all Spider Monkey Panel windows by clicking 'ok'. Not following this exact order may lead to crashes.

image

As script file (not recommended)

Spider Monkey Panel 1.6.1 or higher is required. Only stable releases are supported.

Copy all files from the zip into ’YOUR FOOBAR PROFILE PATH\scripts\SMP\xxx-scripts´. If the folders don’t exist, create them. Any other path WILL NOT work without editing the scripts. (see ’_TIPS_and_INSTALLATION_vX.X.jpg’). Multiple scripts may share some files (specially helpers) so overwrite if asked to do so. Then load the script named ’world_map.js’ into a SMP panel within foobar.

  • For standard installations: ’C:\Users\yourUser\AppData\Roaming\foobar2000\scripts\SMP\xxx-scripts...’
  • For portable installations >= 1.6: ’.\foobar2000\profile\scripts\SMP\xxx-scripts...’
  • For portable installations <= 1.5: ’.\foobar2000\scripts\SMP\xxx-scripts˙..’

Note on upgraded 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, where they should reside (instead of the root of foobar2000 installation path). If you don’t move all the configuration folders/files, then, on startup, default values will be used for things not found, probably ”losing” the theme or other customization. You may ”fix” it later moving the missing files which still reside in the root. May take some tries to do them all.

  • Some native folders and files which must be moved include: index-data, js_data, component-updates, configuration, crash_reports, user-components, foo_spider-monkey_panel, library, playlists, theme.fth, LargeFieldsConfig.txt, version.txt
  • Some extra folders from other components which must be moved include (non extensive list): autobackup, dvda_metabase, foo_httpcontrol data, foo_youtube, images, lastfm, python, sacd_metabase, vst-presets, yttm, minibar.db, playlist-tree-0.pts, playlist-tree-1.pts

Portable installations tip

When the script finds it’s being loaded within a portable installation, it will set the default paths using relative paths. It will also warn with popups and/or the console about the -non recommended use of absolute paths on portable installations.

Multiple panels

Multiple panels are allowed without any special requisite. Note all panels will use by default the same country database (unless set to not do so). Usage: A panel may be set in Library mode (to show library statistics) and another one in Standard mode (to follow playback).

Updating from older script versions

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.