Files, folders or URLs; a |subsong:N suffix selects a subsong.
OptionalplaylistIndex of the playlist; omitted, the active playlist. An index past the last playlist fails with INVALID_INDEX; with this omitted and no active playlist the call fails with NO_ACTIVE_ITEM.
OptionalplaylistPersistent unique identifier of a playlist (bracketed GUID, case-insensitive), used in place of a mutable index. Mutually exclusive with playlist; passing both or an invalid format fails with INVALID_PARAMS. Fails with NOT_FOUND if the playlist does not exist, never falling back. Invalid-format and not-found failures return the given GUID in details.playlistGuid.
Parameters for
playlist.addPaths. Append files, folders or URLs to a playlist, saving an undo point first. foobar2000 resolves the batch as its own Add Files does: folders and playlist files are expanded, duplicates are dropped and the rows are sorted by the user's incoming-item order, so they do not keep the given order (playlist.addPathsSequentialdoes). Entries longer than 2048 characters, and entries that resolve to nothing, are counted ininvalidCount. When nothing is added the call fails withNOT_FOUND. A locked playlist fails withLOCKED. foobar2000 can show a progress dialog while it resolves the paths, and the playlist is looked up again afterwards: moved meanwhile, the tracks still go into it andplaylistin the result is its new index; removed meanwhile, the call fails withOPERATION_FAILED.