Atelier Queue Bridge

A native foobar2000 component that mirrors the core playback queue to a playlist named 'Up Next' bidirectionally, enabling scripting panels (JScript Panel 3, Spider Monkey, etc.) to read and edit the queue solely via the playlist API.

It also adds a main menu command, Playback > Atelier: Play From Queue Point, which plays a selected queued track and clears preceding tracks - an operation panels cannot perform independently.

Why this exists

JSP3 3.8.5 exposes playlists but not the playback queue. Panels can read and edit playlists, but cannot view, remove, reorder, or jump to queued tracks.

This component bridges that gap by keeping a normal playlist (Up Next) synchronised with the queue:

• Queue changes - update Up Next
• Up Next changes - rebuild the queue

Panels can then treat Up Next as the queue, enabling full queue control (view, clear, remove, reorder, jump) without any new scripting API.

What you get

Operation	Playlist action
View queue	Read items of the Up Next playlist
Clear queue	Clear the Up Next playlist
Remove one track	Remove that item from Up Next
Reorder	Move items within Up Next
Jump-to-point	Focus the row, then run the Atelier: Play From Queue Point command 1

The full reference is in docs/REFERENCE.md.

Install (users)

1. Download foo_atelier_queuebridge.fb2k-component.
2. In foobar2000, open Preferences > Components, click Install..., and select the file (or drag it onto that window). Click Apply; foobar2000 restarts to finish.
3. An Up Next playlist appears and tracks your queue.
4. Add a panel that reads/edits Up Next. A complete, dependency-free example is in docs/example-panel/.

This component is non-UI: it adds no windows or preferences pages of its own. It is just the bridge; the user interface is whatever panel you point at Up Next.

Documentation

• docs/REFERENCE.md - the integration reference: the Up Next playlist, each operation with examples, the jump command, the identifiers, and a section on how the two-way mirror works internally.
• docs/example-panel/ - a self-contained JSP3 example panel.

Compatibility

• foobar2000 v2.x, x64.
• Built against the foobar2000 SDK (2023+), Visual Studio 2022 (toolset v143).
• Panel side tested with JScript Panel 3 (JSP3) 3.8.5.

Licence

MIT - see LICENSE.

Footnotes

1. The only row that is not a playlist edit: it focuses the row and runs a bridge-provided menu command. ↩