new FbTitleFormat(expression)
Performance note: if you use the same query frequently,
try caching FbTitleFormat object (by storing it somewhere),
instead of creating it every time.
Parameters:
Name | Type | Description |
---|---|---|
expression |
string |
Methods
-
Eval(forceopt) → {string}
-
Always use Eval when you want dynamic info such as %playback_time%, %bitrate% etc.
FbTitleFormat#EvalWithMetadb(fb.GetNowplaying()) will not give the results you want.Parameters:
Name Type Attributes Default Description force
boolean <optional>
false If true, you can process text that doesn't contain title formatting even when foobar2000 isn't playing. When playing, you should always get a result. Returns:
stringExample
let tfo = fb.TitleFormat("%artist%"); console.log(tfo.Eval());
-
EvalWithMetadb(handle) → {string}
-
Parameters:
Name Type Description handle
FbMetadbHandle Returns:
stringExample
let tfo = fb.TitleFormat("%artist%"); console.log(tfo.EvalWithMetadb(fb.GetFocusItem()));
-
EvalWithMetadbs(handle_list) → {Array.<string>}
-
Parameters:
Name Type Description handle_list
FbMetadbHandleList Returns:
Array.<string>Example
let tfo = fb.TitleFormat("%artist%"); let handle_list = fb.GetLibraryItems(); let artists = tfo.EvalWithMetadbs(handle_list); console.log(handle_list.Count === artists.length); // should always be true!