REST API - jukeboxControl confusion ...

[KMan]

I'm trying to use the rest api to control the jukebox mode.

What I want to do is just shuffle a playlist and play it, but I'm not sure how shuffle is supposed to work.

I can manually "clear" then "add" songs to the queue ... now I want to shuffle them and play them.

I send the "shuffle" action, and get back a response as follows:

Code: Select all

{
   "subsonic-response" : {
      "status" : "ok",
      "version" : "1.13.0",
      "jukeboxStatus" : {
         "currentIndex" : 258,
         "playing" : false,
         "gain" : 0.5,
         "position" : 10
      }
   }
}

But when I send the "start" action, it always seems to play at index 1 (first song in list). Shouldn't it start playing at 258?

Also, what does "position" mean?

Thanks!

[KMan]

So I played a little bit more ... and got it to work the way I want, but it isn't very intuitive.

I realized that "shuffle" actually shuffles the queue, but moves the currentIndex so it points to the song that was at index 0. So it is shuffled, but "start" will always start with the same song (the one that was previously at index 0).

I worked around this by doing "skip", "index=0" instead of start. But why does "skip", 0 go to index 0? Seems like skip should skip songs in the queue, not start playing at that index.

So I guess maybe my question is "Where is the jukeboxControl REST API documented?" I have been using this http://www.subsonic.org/pages/api.jsp#jukeboxControl, but it seems pretty thin.