Layout

Look-up button

Fallback text: Heading|NoHeading

Scroll

Bar:

Overlay

Flat & rounded support custom colours. As an alternative for lyrics, try menu > layout > full overlay with: flat style,

Extra menu items

Click to reset window size

Metrics

Main margins (px)

Text

Theme

Highlight

Items disabled if custom colour set. Line option disabled if dark lines enabled.

Line style

Image and filmStrip size

Press Ctrl and drag lines to adjust image:text ratio or filmstrip size (panel needs focus, e.g. click it).

Album rating

Show

Location

Text name

Summary items

*Locale setting controls last.fm & wikipedia. Allmusic locale is integral to the date.

Main Title format

Track Title format

Source

Site names are used (not known for lyrics)

Main

Format

Button Style

Line

Country flag

Flag display requires heading format set to left

Padding +/-

Main image

Filter

Applies to last.fm photo download folder

Type

Size

Filmstrip

Seeker & counter

Image+text		Image only		Filmstrip

Reflection

Stub

Stubs are normally set in fb2k preferences>display. They can also be set in panel properties ("Stub..."), which is checked first. If neither are set, a biography-styled stub is used.

Displays text, lyrics, item properties and nowplaying info. Uses first found for each view.

Artist view

Use Name Full path or tag* Lyrics source

Album view

Use Name Full path or tag* Lyrics source

*Evaluated as a path if backslash present, else as a tag.
Filename & extension support wildcards.

Lyrics:

Item properties:

Nowplaying:

Help

General

Usage has to be enabled (top left)
Check "lyrics sources" to identify which sources require lyrics handling
Images and other sources are all available, so text, lyrics and item properties can be viewed in more interesting ways

Lyrics

- Autoscroll existing & newly downloaded lyrics - Default is to fallback to showing biography or review if no lyrics are found - Supports lyrics offset + on the fly adjustment with mouse wheel (not saved)

Download integration

Biography doesn't download lyrics, but can synchronise with lyrics plug-ins as follows.

Check "synchronise..." above
Ensure a lyric show 3 or ESLyric panel is in the layout (can be hidden) & that lyric saving is enabled
Ensure save settings in the lyrics panel match load settings above

If lyric show 3 is used, install veksha's multi-source for lyrics. Disable the default lyrics 3 sources as mostly they don't work anymore. Enable NEW DB: Minilyrics, NEW DB: QQ Music & NEW DB: Netease for synced lyrics or others as required. Although lyrics obtained by openlyrics can be displayed, that plug-in isn't suited to download integration.

Fade height

Increase if fade effect is too close to top / bottom, e.g. try 0.5.

Lyrics in tags

If lyrics display as ".", LargeFieldsConfig.txt needs to be edited:

Increase the defaultMetaMax size limit
For %lyrics% or %unsynced lyrics% tags, comment out or remove those specific entries under "fieldSpam"

Scroll

Scroll time is the milliseconds taken to scroll a line. The recommended range is 400-1500. Lyrics cannot be autoscrolled if text sources are amalgamated

Item properties

Item properties can be displayed by pasting in one of the paths below. Both display the same information, but use different groupings.

item_properties splits metadata into organised groups
item_properties_alternative_grouping shows metadata in a single group
both show other groups like youtube, statistics, location, general and replaygain
either can be edited in a text editor to add, remove or re-order groups and properties
other files can be used provided item_properties is present in the name

Nowplaying

Nowplaying info can be displayed by pasting in the path below.

for ease of editing the nowplaying source uses a saved file
other files can be used provided nowplaying is present in the name
alignment N/A if text sources are amalgamated

Look-up (drop down menu)

Usage is optional
Textreader would need to load info for artists (artist view) or albums (album view). Use %BIO_ARTIST%, %BIO_ALBUMARTIST% or %BIO_ALBUM%, as appropriate
Lyrics, item properties and nowplaying info, if displayed, automatically show for the current track

Colours and fonts

User interface or theme settings are used by default. Enable & configure custom items if required. Ctrl+wheel over text or buttons can also be used to change their size [reset: menu\layout\reset zoom].

Fonts

Name,Size,Style(0-4)

Colours (R,G,B):

Selected colours and fonts will be used. Font style codes: 0 regular, 1 bold, 2 italic, 3 bold italic, 4 underline

Colour picker

Colours: flexible entry, e.g. 255,0,0 or 0-255-0 or rgba(255,0,0,64) Alpha: 0-255 or 0-1 scale Transparent: background N/A; transparent fill can be used

Colours (R,G,B or R,G,B,A):

Scrolling

Behaviour

Scrollbar

*Select in 'Behaviour Tab' under 'Scroll: Arrows' (N/A if windows scrollbar set). Ensure icon is supported by font.

Miscellaneous

Theme blur

Image: Smooth transition level

Playlist interaction (follow selected item)

Server name

This option enables the server to be set per panel. Panels having the same server name use the same server. The OK button must be clicked after changing the server name.

Title format

The variables are used in searching, & should be used in save folder paths and headings to ensure correct functionality. An advanced radio stream parser designed for use with streams that contain the artist name and song title in a non-standard format is located in foo_spider_monkey_panel\package_data\{BA9557CE-7B4B-4E0E-9373-99F511E81252}. It's user configurable (open in a text editor).

Classical music extension

Extends auto-download of allmusic & wikipedia reviews to compositions. N/A for last.fm. Enable and set tag below. To display, per panel, use sources\text sub-menu. If preferred, composer can be used by changing %BIO_ALBUMARTIST% above so $meta(composer,0) is the first item.

Auto-download

Cache location

Hide folders

AllMusic Save folder

Last.fm Save folder

Wikipedia Save folder

File names are auto-generated

Supplementary cache

Look-up items like similar artists and top albums can be saved separately. Find and replace is applied to the save folders above. Preview shows result for last.fm biography.

Preview

Configure custom cache

Default cache is auto-managed:

Initial download number (1-20)

Auto-add new

Disable for a fixed number of images per artist

Limit per artist

Limit is designed for use with auto-add new. If set, new images replace old. Excess are moved to the recycler. 0 = No limit.

Auto-add new doesn't operate if items are cached for 28 days or less.

Custom load folder

An alternative load folder for artist photos (load only: no images are saved here). Enable on menu > sources > photo. If enabled, the custom folder is checked first. If no images are found, the last.fm photo download folder is checked.

Display of downloaded artist photos in other artwork viewers and playlists

Covers: Music files

Covers for music files are normally obtained through fb2k (Preferences: Display) or from saved locations. Enabling auto-download can obtain missing covers.

Covers: cycle folder

Folder that enables cycling through images in album view. Default loads artist photos. Select on menu > sources > cover.

Covers: custom paths

Most users should not need this feature as covers are auto-loaded by fb2k (Preferences: Display) or from save locations. Enable if required. Use full path minus extension.

Preview

AllMusic tags Tag name

Last.fm tags Tag name

Wikipedia tags Tag name

Last.fm genres

To add to the whitelist, enter comma separated genres below:

Notify tags

Show confirm popup before tagging files

Tagger help

General

All tag writing is from saved sources (i.e. only existing info in already saved bios and reviews is written). This is to comply with constraints of certain sites. The tagger should work best if Biography has been used for a while & items are cached for a sufficient time. Tags are multi-value except rating.

Last.fm genres

A whitelist can be used to remove any non-standard genre tags. Translate is also available if the whitelist is used. These aren't needed with other genre sources. The whitelist is downloaded and updated automatically.

Statistics

Tagging statistics requires files created or updated with biography v1.2.0 or later. Last.fm playcount (scrobbles), listeners & a combined score (1-100) are written as a multi-value tag.

Scores rank the long-term popularity of artists and albums on a 1-100 scale using total scrobbles and listeners. The highest scoring artist or album at last.fm is set to a score of 100.

Access tags as e.g:

For album statistics, change artist to album.

Remove punctuation from playcount & listeners if used in queries, sorting or arithmetic title formatting functions, e.g.

Notify tags

If checked, enabled tags for the current track are notified to other Spider Monkey Panels. This includes artist data for radio streams. Notifications are sent on track change and when new or updated data is received. The current track will be the playing track or selected track depending on the panel display mode. Default tag names are used instead of any custom names, so third party scripts know what to expect. Additionally, third party scripts can use window.NotifyOthers('bio_syncTags', focus) when the current track changes where focus is either false (prefer nowplaying) or true (follow selected track). This overrides biography tag settings so that biography always notifies the tags, that the notified tags include a core set of tags and that the notified tags include the correct selection mode. Use on_notify_data(name, info) in the receiving panel to process the notification, where: name is 'biographyTags' info is an object: { artist: 'ARTIST NAME', album: 'ALBUM NAME', handle: handle of current track, selectionMode: biography selectionMode - string either 'Prefer nowplaying' or 'Follow selected track (playlist)' tags: { {name: value}, {name: value}... } } Third party scripts can set the biography selection mode* by using window.NotifyOthers('bio_followSelectedTrack', boolean), where boolean is either true [Follow selected track (playlist)] or false [Prefer nowplaying]. *N/A if a lyrics or nowplaying source is enabled as panel has to be in prefer nowplaying mode.

Site display names

Miscellaneous

Partial match settings apply to allmusic & wikipedia. Last.fm matches are as provided by the site.

Album name auto-clean shouldn't be needed if album version info is in its own tag. If enabled, key words are stripped from the album name, as required, before web searching, e.g. "Deluxe Version", "[2011 - Remaster]", "Expanded Edition" + many more. Improves search results if such phrases are used in album names.