SwiftAppsBavaria

← All apps → · Mac App Store

sCollectPlay Manual

Player for sCollect libraries, folders, and iTunes XML exports

1. Getting Started

What is sCollectPlay?

sCollectPlay is a companion app to sCollect. It focuses purely on playback: no importing, no metadata editing, no synchronization. In return, it reads from three sources: folders, iTunes/Apple Music XML, and sCollect libraries.

First Launch

On first launch, sCollectPlay shows a welcome dialog with notes on playing special formats (see section 4). Afterwards, the source picker appears, where you can choose a library.

2. Choosing a Source

sCollectPlay supports three source types, available at startup or later via the File menu:

Scan a Folder

Pick any folder – sCollectPlay scans it recursively for media files and reads metadata directly from the files (AVFoundation for audio/video, EbookTagKit for EPUB/PDF). This is the easiest way to get started without a sCollect library.

Under Settings > Library > Scanned Folders, Refresh reads in only what has changed since the last read: new, modified and removed files. Use Remove to take a folder out again together with its tracks. Faster: File > Refresh Scanned Folders (⌘R) or the ↻ button to the right of the search field. Both refresh all folders one after another; in Settings, Refresh All does the same. At the end, a message tells you what is new, changed or removed.

sCollect Library

Choose the main folder of a sCollect library (the folder that contains the .scollect bundle; for older libraries, the folder with settings.json). sCollectPlay reads the library files, playlists, and settings directly – including configurable field labels and smart playlists. Selecting a sCollect library replaces an active folder scan. You can also double-click the .scollect bundle in the Finder to open the library.

sCollectPlay changes nothing in the library itself. When you rate a track or play music, an audiobook or a film to the end, it notes this with date and time in the file rueckmeldungen.json in the library folder – whether you opened the master or a copy. sCollect takes it over when the master is opened, before Project, and before Resolve Sync Errors…: for the rating the newer one wins, plays are added up. sCollect then writes the rating into the file and passes everything on to all copies. Until then, sCollectPlay already shows its own ratings and plays.

iTunes/Apple Music XML

Choose a Library.xml file or a .musiclibrary bundle. sCollectPlay parses tracks and playlists (standard and smart). System playlists (Master, Distinguished Kind) are skipped. sCollectPlay takes the media types from the XML itself: Music, Audiobook, Podcast, Home Video, Feature Film, Series and Music Video. On open, you’re asked once for access to the corresponding media folder so sCollectPlay can reach the files.

Recently Used Sources

In the File menu, each command is followed by the most recently used sources of that kind: Recent Folders, Recent Libraries, and Recent XML Libraries, up to ten each. A click opens the source again; if it can no longer be reached, it disappears from the list. Clear List empties a list. On the next launch, sCollectPlay loads the most recently used source by itself. If it is on a network volume, the app asks first – you can turn this off under Settings > General > Warn about network library at startup. Settings > Library shows the same lists, with Load for each entry.

3. Browsing Your Library

Sidebar

The sidebar shows categories and media types as a two-level accordion (e.g. Audio > Music / Audiobook / Podcast); next to each media type is the number of its items. The playlists of an sCollect library appear with their category under Playlists, and folders can be expanded. Playlists without a category – and all playlists from a scanned folder or an XML library – appear in the Playlists section below. Switching between media types or playlists updates the track list on the right; the window title shows how many tracks it currently contains and, for a selection, their number and total duration.

Track List

Column Browser

The column browser adds several selection columns above the track list – similar to the column browser in Apple Music. The button with the three columns on the right of the toolbar shows and hides it. It is available in the media type views and in playlists; in a playlist it shows the values of its tracks.

Selection, column widths, and height are remembered by sCollectPlay on this Mac. The sCollect library is left untouched – sCollectPlay never writes to its settings.

Search

The search field in the toolbar filters by title, artist, album artist, album, composer, genre, comment, grouping, work, movement name, and year. In playlists, the search additionally applies to the playlist contents.

4. Playback

Playing Audio

Select an audio entry and press Space or the play button in the player bar. The player bar shows:

Playing Video

Movies open in a separate video window; at the end of a movie, playback continues with the next track, provided Continue playing at end is turned on for its media type. Audio tracks and subtitles can be switched in the Playback menu. Use ⌘⌃F to toggle full-screen mode.

External Playback

Some formats are not natively supported by macOS / AVFoundation. sCollectPlay detects this and opens these files automatically in an external player:

The preferred player is detected automatically: VLC, IINA, or MPV (in that order). You can override the choice in Settings > Playback/Playlist > External player for unsupported codecs. If none of these players are installed, the default app for the format is used – we recommend VLC Media Player (free, open source).

Playback Controls

SpacePlay / Pause
→Skip forward 10 seconds
←Skip back 10 seconds
⌘→Next track
⌘←Previous track
⌘↑Volume up
⌘↓Volume down
⌘⌃FToggle video full-screen

Playback Modes

Continue playing at end

Whether playback continues with the next track after one ends is set per media type under Settings > Playback/Playlist > Continue playing at end. By default it is on for all audio types and for music videos, and off for feature films, series, home videos and camera videos – a movie then stops at its end (or at its stop marker). Repeat (Track) repeats regardless. sCollectPlay remembers what you change here; for all other media types, the library’s setting applies.

Apple Music Export

Playlists or a selection of tracks can be sent to Apple Music:

sCollectPlay creates the playlist in Apple Music and adds the tracks. Tracks in formats Apple Music does not accept are not sent and are listed in a message. If you have sent the playlist before and it still exists in Apple Music, sCollectPlay asks whether to update it or create a new one; with «Don’t ask again» or the Apple Music export setting (see Settings) it is updated without asking.

5. Playlists

sCollectPlay shows all playlists from the loaded library – both standard and smart playlists. Smart playlists are re-evaluated against their stored criteria whenever the item set changes; a smart playlist created in sCollect under a category only evaluates that category’s tracks. They can only be changed in sCollect; in addition, you can create your own playlists.

When loading an XML library, both standard and smart playlists are imported. System playlists (Master, Distinguished Kind) are skipped.

My Playlists

Under My Playlists in the sidebar, you create your own playlists – regardless of whether a folder, an XML, or a library is loaded:

sCollectPlay stores your own playlists on this Mac, never in the library or the XML; it finds their tracks again by file path, even after a new scan.

Playlists on iPhone or iPod

sCollectPlay does not transfer anything to a device directly. The way leads through Apple Music and the Finder:

  1. Send to Apple Music: Right-click the playlist in the sidebar and choose Send Playlist to Apple Music, or select it and choose File > Send Playlist to Apple Music… To send selected tracks, choose Send as Playlist to Apple Music from the track list's context menu.
  2. Connect the device: Connect your iPhone, iPad or iPod to the Mac with a cable and select it in the Finder sidebar under «Locations».
  3. Tick the playlist: In the «Music» tab, turn on «Sync music onto [device]», choose «Selected artists, albums, genres, and playlists» and tick the list under «Playlists».
  4. Click «Apply».

Apple Music accepts MP3, AAC and ALAC (.m4a), AIFF and WAV. sCollectPlay does not send tracks in other formats (such as FLAC, OGG/Opus, raw .aac or MKV) and lists them in a message – they need to be converted first, for example with «Convert Format» in sCollect.

If the playlist changes, send it again: sCollectPlay asks whether to update the existing list in Apple Music or create a new one. Then sync again in the Finder.

Playlists on Android (VLC)

Right-click the playlist in the sidebar and choose Export for VLC/Device…, or select it and choose File > Export Playlist for VLC/Device… This works with every playlist, including those under My Playlists. As the destination, choose an SD card, a USB stick or any folder. sCollectPlay creates a folder named after the playlist there, containing the files, sorted by artist and album, and the playlist as an .m3u8 file with relative paths.

Then move the whole folder to the Android device: insert the card or stick, or copy it over a cable with an MTP app (macOS does not show an Android phone as a drive). Do not split the folder up – the list finds its tracks only relative to its own location. VLC shows the playlist among its playlists once it has scanned the storage; if the folder lies outside the scanned locations, add it to the media library in VLC.

The folder also works with VLC on another Mac or PC and with any player that reads M3U8 lists.

6. Deleting Media Files

The track context menu has a Delete media file entry. By default, a confirmation dialog appears beforehand (can be disabled in Settings). The file is moved to the Trash, and the entry is removed from the library.

With Edit > Undo (⌘Z) you bring the file back from the Trash, together with its entry; Edit > Redo (⇧⌘Z) deletes it again.

7. Settings

Open Preferences via sCollectPlay > Settings… (⌘,). They are organized into several tabs; some fields are read-only (showing values from the loaded sCollect library or defaults) – they indicate what would be available in sCollect.

General

Below these, grayed out, are the settings that only sCollect can change (such as album covers, books & PDFs, multiple values, duplicates).

Library

At the top, the three sources are listed one below the other: Scanned Folders, XML Library, and sCollect Library. Only one is active at a time – its circle is filled. Clicking another circle switches to the most recently used source of that kind; scanned folders come back with their saved state, without a new scan. If there is none yet, the selection dialog opens.

Below these, grayed out, are the fields that only sCollect offers (Import, Media Folder, Actions).

Playback/Playlist

Category Labels and Field Labels

These two tabs show the names of the categories and media types, and of the fields, as the loaded sCollect library defines them. They can only be changed in sCollect.

Statistics

The number of tracks per media type and of playlists per category, plus the total number of tracks.

8. Keyboard Shortcuts

General

⌘,Open Settings
⌘⇧OChoose sCollect Library…
⌘RRefresh Scanned Folders
⌘QQuit sCollectPlay
⌘ZUndo (for example, bring back a deleted file)
⇧⌘ZRedo
⌘/sCollectPlay Help

Playback

SpacePlay / Pause
→Skip forward 10 seconds
←Skip back 10 seconds
⌘→Next track
⌘←Previous track
⌘↑Volume up
⌘↓Volume down
⌘⌃FToggle video full-screen

← All apps → · Mac App Store