🟢 Stable

This API is stable since festivald v1.0.0.

Retrieve the health of the current Collection.

This method tells you how many Song's referenced by the current Collection have a missing underlying file, i.e, there is no file at the PATH the Collection points to for a particular Song.

Missing Song's will be returned in Entry form.

The returned array of missing Entry's is in incrementing Song key order, as in:

Entry 10 (Song key 10),
Entry 13 (Song key 13),
Entry 75 (Song key 75),
Entry 76 (Song key 76),

[... etc ...]




all_okbooleanIf the underlying file for every single Song exists, this is true, else if even 1 is missing, it is false
song_lenunsigned integerThe total count of Song's in the Collection
missing_lenunsigned integerThe total count of Song's with missing underlying files
missingarray of Entry objectsAn array of each Song that is missing, in Entry object form

Example Request

festival-cli collection_health
curl http://localhost:18425 -d '{"jsonrpc":"2.0","id":0,"method":"collection_health"}'

Example Response

  "jsonrpc": "2.0",
  "result": {
    "all_ok": false,
    "song_len": 24,
    "missing_len": 2,
    "missing": [
        "path": "/home/hinto/Music/song.flac",
        "key_artist": 0,
        "key_album": 0,
        "key_song": 0,
        "artist": "Artist Name",
        "album": "Album Title",
        "song": "Song Title"
        "path": "/home/hinto/Music/song2.flac",
        "key_artist": 1,
        "key_album": 1,
        "key_song": 1,
        "artist": "Artist Name 2",
        "album": "Album Title 2",
        "song": "Song Title 2"
  "id": 0