collection_resource_size

🟢 Stable

This API is stable since festivald v1.0.0.


View the size of the current Collection's underlying resources (audio files and art).

The output of this method reflects the live audio file size, not the one at the time of the Collection creation. For example, if an underlying audio file is changed:

my_song_file.flac (5MB) -> my_song_file.flac (33MB)

Then this method will reflect that change.

However, Art is cached by festivald and only updated upon a Collection reset.

Inputs

None

Outputs

FieldTypeDescription
audiounsigned integerTotal size of the Collection's underlying audio files in bytes
artunsigned integerTotal size of the Collection's underlying Album art in bytes

Example Request

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

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "audio": 315060491209,
    "art": 877030803
  },
  "id": 0
}