Bookmark (.bmark) file format

[alewbail]

Is there a description of the '.bmark' file format somewhere?  I want to build a '.bmark' file using my own home-built utility, but can't find a description.  I can see that each line describes one bookmark, and have been able to figure out some of the entries on the line.  Each line is of the form

<a>;<b>;<c>;<d>;<e>;<f>;<g>;<h>;<i>

where

<a> is the item number in the playlist (starting from zero)
<b> is ?
<c> is ?
<d> is ?
<e> is the timestamp of the bookmark, in milliseconds
<f> is ?
<g> is ?
<h> is the playlist name or folder path
<i> is the filename

I'm looking for help with the remaining "?" items.  Thanks.

[P.S. Is there documentation showing the format of all the various RockBox-related files?  Is it all in one place?  I know there are such descriptions of the '.cfg' and '.wps' files in the User's Manual, but I'm wondering about the more obscure ones, like '.m3u8', '.bmark', and '.tcd'.]

[AlexP]

m3u8 is a utf8 encoded m3u file, and is a standard playlist format.

The others aren't documented that I know of, except for in the code.

[mc2739]

Is there a description of the '.bmark' file format somewhere?

If you want to look at the code, you might try apps/bookmark.c around line 208.

[alewbail]

After reviewing "bookmark.c" and a couple other routines, here is an updated definition:

<a>;<b>;<c>;<d>;<e>;<f>;<g>;<h>;<i>

where

<a> is the item number in the playlist or folder (starting from zero)
<b> is the "resume offset": bookmark 'time' in bytes
                                     (bytes from the beginning of the file)
<c> is the "resume seed": (?)
<d> is the "resume first index": (?)
<e> is the timestamp of the bookmark, in milliseconds
<f> is the repeat mode flag (0=no,1=?,2=?,...)
<g> is the shuffle flag (0=no,1=yes)
<h> is the playlist name or folder path
<i> is the filename

Although there are still a couple items I don't understand ("resume seed", "resume first index"), this should give me enough information to proceed.

Thanks for the help.

[torne]

Resume seed will be the seed value used for the shuffle, so that the playlist remains in the same shuffled order on resume.

[alewbail]

And I suppose "resume first index" might be the track on which the shuffled playlist started?  Just a guess.

[JdGordon]

what do you actually want to do?
you can probably get away with c,d being 0's as long as shuffle mode is off...
the repeat mode order will be the same as in the setting


edit: .m3u8 is just a m3u saved in utf-8 encoding.
.tcd is magic... I think there is some documentation on the wiki thugh for it.. otherwsie apps/tagcache.c

[Lear]

"Resume first index" is no longer used and is always saved as 0.

And no, I don't know what it was used for.