Script should be installed as package, using the package manager at the SMP Configuration window. Old method is still supported anyway.
REQUIRES SMP OR JSPLITTER
Download below clicking at '[...]-package.zip'. Check installation instructions here.
See full changelog here.
4.0.0 - 2025-09-20
Added
- Data: added support for multi-value artist tags, now enabled by default. Can be tweaked at the 'Tags' submenu. If a track has multiple artists, the panel will try to draw a point per artist (similar to how multiple selection works). Biography integration remains the same, i.e. it will try to only match the first artist found. Note this change implies that some artists may now be missing a country (since they were previously merged into a single value); you may use the 'Find artists without locale tag...' entry to tag them.
- Data: added menu entry to add/remove an artist to a black list for splitting. So above functionality can be easily tweaked for specific artists which should never be split (like 'Crosby, Stills & Nash').
- Statistics: X-Axis shown values at display menu now allows any custom value.
- Statistics: Y-Axis filter at display menu now allows any custom value for 'greater than'/'lower than' filters.
- Statistics: option to filter data between 2 custom values on Y-Axis at display menu.
- Installation: new panel menu, accessed through 'Ctrl + Win + R. Click' (which works globally on any script and panel, at any position), used to export/import panel settings and any other associated data. These entries may be used to fully backup the panel data, help when moving between different JS components (JSplitter <-> SMP) or even foobar2000 installations, without needing to manually backup the panel properties or other external files (like .json, countries databases, etc.).
- UI: new menu entry to share current UI settings across all available World Map panels within foobar2000. It can be found at the settings menu 'UI' submenu (and also at the panel menu, see above). Every other panel will be highlighted and show a popup asking to import or ignore the new settings.
- UI: added dynamic colors support based on track's artwork. It follows the background cover mode settings and must be enabled on 'colors' submenu.
- UI: exposed background gradient focus setting, i.e. where the center color will be at its highest intensity.
- UI: added tooltip on blank panel.
- UI: toolbar tooltip now shows 'Ctrl + Win + R. Click' shortcut to script panel menu (see above at 'installation').
- UI: added option to apply a gradient mask at borders (so they mix better with the background). Enabled by default.
- UI: exposed color settings via window.NotifyOthers() method for themes/multi-panel support. You may pass a color scheme -size 6 recommended- (output from GetColourScheme()) at 'Colors: set color scheme' (applies to all compatible panels) or 'World Map: set color scheme' (applies only to this script), which will set appropriate colors following panel's color logic; alternatively you may set direct color settings at 'World Map: set colors' which needs an array of 4 colors or an object {background, text, default, shape}. Panel has also independent settings to listen to colors from other panels or sending colors (as a color-server) to others. Additionally, local color processing from art may be disabled (in case colors are meant to be set only by server). See this and this.
- Configuration: added user configurable file at '[FOOBAR PROFILE FOLDER]\js_data\presets\global\globNoSplitArtist.json' with a list of artists which should not be split. This list can be modified by directly editing the file or using the menu entry (see above).
Changed
- Tagging: Shift + R. Click on a country now always shows the tagging menu in case an artist from selection is not tagged, even if clicking on a currently displayed point. Previously it would create a playlist (since the click was over a point). This applies to both multiple selection and multi-valued artist tracks (if enabled). Note there is not any special handling of file tags for multi-value artists, i.e. if a track with 2 artists has 2 associated countries, they will be properly handled at the JSON database but if using the 'Write to track files' option, there is no way to know to which artist every country value is associated to. In such case it's assumed that all countries apply to all artists.
- Tagging: tagging menu will now show submenus per country in case of multiple artists being selected. Clicking on an artist will only tag tracks/database associated to it.
- Installation: added popup warnings when scripts are installed outside foobar2000 profile folder. These checks can be tweaked at globSettings.json.
- Installation: script may now be installed at any path within the foobar profile folder, no longer limited to '[FOOBAR PROFILE FOLDER]\scripts\SMP\xxx-scripts' folder. Obviously it may still be installed at such place, which may be preferred if updating an older version.
- Installation: multiple improvements to path handling for portable and non-portable installations. By default scripts will always try to use only relative paths to the profile folder, so scripts will work without any change when exporting the profile to any other installation. This change obviously doesn't apply to already existing installations unless restoring defaults.
- JSplitter (SMP) support for locked playlists.
- Statistics: scrolling cursor is displayed when scrolling using mouse + dragging.
- Statistics: added horizontal (x) scrolling using the mouse wheel (for mouses with horizontal moves).
- Statistics: 'fill' chart type.
- Statistics: settings button tooltip now shows 'Shift + Win + R. Click' shortcut to open SMP/JSpliter panel menu (which works globally on any script and panel, at any position).
- Statistics: settings button tooltip now shows 'Double Click' shortcut to force data update (see above).
- Statistics: general improvements and optimizations of point statistics. Now also show the total number of tracks before deduplication.
- Statistics: axis legend is now shown at tooltip and point statistics popup.
- Statistics: X-axis keys are now shown even when not all keys can be displayed, omitting some of the values. This ensures that charts displaying numbers at the axis at least show the initial and some middle values. This applies for bars, lines, scatter, fill and timeline charts.
- Statistics: left scrolling button position is now adjusted following Y-Axis display (except for doughnut and pie charts).
- Statistics: scrolling buttons are now shown only when the chart is not showing all data (no zoom).
- Statistics: multiple menu entries at 'Display settings' have been renamed for clarity's sake.
- Statistics: buttons are now smoothly hidden when panel is not on focus. Transparency may be adjusted from 0 to 255 by setting buttons.alpha, timer to hide them by setting buttons.timer.
- Data: it's now possible to use some of the database tools when using tags/JSON sources on read-only mode.
- Data: 'Find artists without locale tags' tool now checks both file tags and JSON database in case the tags/JSON sources are on read-only mode.
- UI: it's now possible to use the different statistics modes when using tags/JSON sources on read-only mode. Note some data may be missing since artists without country tags will never be automatically tagged. In case the library has never been analyzed, the panel will do it automatically on first run of any of those modes.
- UI: cleanup of menu entries and popups, settings should now be better explained.
- UI: unified script updates settings across all my scripts, look for 'Updates' submenu.
- UI: 'shapes' map images are inverted if the contrast is not great enough against the background color set.
- UI: header now shows the list of currently displayed countries instead of 'Multiple countries'. List is cut at 30 chars.
- Helpers: updated helpers.
- Helpers: general code cleanup on menus internal code. Please report any bug on extra separators or menu entries not working as expected.
Removed
Fixed
- Biography Integration: unnecessary panel and data update when the artist already had a country set. This change also ensures manually set countries (either by tag or JSON) are not overridden by the Biography tag.
- Data: 'Find artists without locale tags' tool was not checking the read tag TF setting but the write tag setting, which would lead to wrong results if the tag was sourced from Biography (since it writes multiple values).
- Statistics: minor fixes.
- Statistics: background not being updated on playback/selection change.
- Statistics: panel not being completely repainted when exiting statistics mode.
- UI: '&' being displayed as '_' on tooltips.
- UI: wrong position on second background gradient using bigradient mode.
- UI: workaround for DPI checking under multiple OSes, specially for Wine (Unix).
- Fixed some misspelled terms on UI and variables (which also lead to some minor bugs).