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
Field | Type | Description |
---|---|---|
audio | unsigned integer | Total size of the Collection 's underlying audio files in bytes |
art | unsigned integer | Total 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
}