FAQ

Frequently Asked Questions

Is DarkOneJSP3 an official DarkOne release?

No. It is an unofficial community continuation and does not imply endorsement by the original theme, component or sample authors.

Which foobar2000 architecture is required?

DarkOneJSP3 targets foobar2000 v2 x64 with Columns UI. The v0.9.29 documentation baseline uses JScript Panel 3.8.5 and JSplitter 4.1.12.

Should I import the included FCL?

The FCL is optional. The authoritative setup reference is the Layout and Panel Map. Manual layout construction is recommended because it creates component instances for the local installation and makes every title and script assignment visible.

Does an upgrade require a factory reset?

Normally, no. Persistent JScript Panel and JSplitter properties are retained. Use a factory reset only when intentionally restoring defaults or when troubleshooting a configuration-specific issue.

Do I need to re-import the JScript Panel entries after upgrading?

Not normally. Older saved entries are supported through compatibility helpers and reset adapters. Re-importing supplied entries is useful when you want the newest displayed sample metadata and import structure.

Can the enhanced samples be used by other themes?

Yes. From v0.9.17 onward, the enhanced sample tree is standalone and no longer requires the DarkOneJSP3 project directory. See Enhanced Sample Library.

Will the sample library overwrite files used by another theme?

It may replace matching files in foo_jscript_panel3\samples and helpers.txt. Back them up first, especially when another theme includes locally modified versions.

Why does Album Art wheel navigation no longer load every intermediate image?

The enhanced Album Art implementation deliberately waits 80 ms after the final wheel event, then loads only the selected artwork type. This prevents rapid wheel movement from synchronously decoding several images and stalling the interface. Keyboard and menu selection remain immediate.

How do the shared bottom-area colours work?

Bottom area background is one setting shared by the bottom-left control panel, bottom-right control panel, centre Display panel, Bottom Controls backing and—when Automatic is selected—the Display/Waveform host.

Bottom area side divider colour controls both lower vertical divider strips. The Quick Search border and native edit-control background remain independent.

Why does Transparent / inherit parent use #181818?

JScript Panel and JSplitter child windows expose different native backings when they literally paint nothing. DarkOneJSP3 therefore resolves the composite bottom area's inherited colour to DOJSP3.colours.separator (#181818) across every participating surface, producing a uniform result.

What does Automatic mean for the Display/Waveform Host background?

Automatic follows the effective shared Bottom area background. It is the default for new configurations and appearance resets. Existing explicitly stored fixed Host background modes remain fixed until Automatic is selected.

What are the files in js_data beginning with darkonejsp3.?

darkonejsp3.bottom-area-state.txt stores shared bottom appearance across the separate JScript Panel and JSplitter hosts. darkonejsp3.reset-command.txt is a short-lived command bridge used during coordinated factory reset. They are generated at runtime, excluded from releases and should not be edited manually.

Which Queue Viewer should I use?

The native Queue Viewer component is recommended because it can add, remove, reorder and clear queue entries. The scripted fallback provides DarkOne styling, selection, navigation and source-item commands, but JScript Panel 3 does not expose the mutation APIs needed for complete queue editing.

Why does Album Notes report an AllMusic HTTP 403?

AllMusic may reject scripted requests even when the page works in a normal browser. Album Notes can attempt a MusicBrainz relationship lookup as an AllMusic URL resolver. Some albums still require Fetch from manual AllMusic URL... or another enabled source.

Why does Album Notes say MusicBrainz could not match an album?

The automatic search could not confidently identify the release. Supply a MusicBrainz release-group or release MBID, correct the tags, forget the saved identity and resolve again, or use a manual AllMusic URL where appropriate.

Why are there many “Playlist loaded” console lines?

foobar2000 reports each restored playlist during startup. These lines are informational unless accompanied by an actual error or failed script initialisation.

Why does the theme briefly show a native grey or black surface at startup?

With Startup set to Off, native Columns UI or JSplitter backing surfaces may briefly appear before every child completes its first paint. Use Black reveal when this is noticeable. Optional reveal modes intentionally coordinate nested controller readiness.

Why does JS Playlist use more CPU at 8 ms?

An 8 ms refresh interval targets very smooth animation but performs more frequent work. Select 10, 12 or 16 ms when lower CPU usage is more important.

Why can’t I find a setting mentioned in the guide?

Right-click location matters. Playlist rows, empty panel areas, scrollbars, the volume knob, centre display, narrow waveform host and InfoStack tab strip expose different menus. See the Configuration Guide.

What should I include in a bug report?

Include component versions, the exact panel or script, reproduction steps, console output, screenshots when useful, and confirmation that the issue occurs on the current stable release. Run the validator where possible.

How do I roll back?

Close foobar2000 and restore the backed-up DarkOneJSP3 folder and JScript Panel sample files. Re-import the backed-up Columns UI layout only when the layout itself changed.