tagnavi.config v2.0 syntax

[rADo]

Having upgraded my iPod 60G to latest CVS code, I have found that tagcache does not work anymore. Only later I realized that my heavily modified tagnavi.config now need a different syntax.

Is there any documentation that describes v2.0 tagnavi.config format in detail?

Thanks.

This is what I am using right now:

Code: [Select]

#! rockbox/tagbrowser/2.0
# ^ Version header must be the first line of every file

# Define the search sub menu
%menu_start "search" "Search by..."
"Artist" -> artist ? artist ~ "" -> album -> title = "%02d. %s" tracknum title
"Album" -> album ? album ~ "" -> title = "%02d. %s" tracknum title
"Title" -> title ? title ~ ""
"Filename" -> filename ? filename ~ ""
"Score" -> title = "(%3d) %s" autoscore title ? autoscore > ""

# ^ An empy line ends the (sub)menu

# Define the title of the main menu
%menu_start "main" "Browse by..."
"Artist"   -> artist   -> album  -> title = "%02d. %s" tracknum title
"Album"    -> album    -> title = "%02d. %s" tracknum title
"Genre"    -> genre    -> artist -> album -> title = "%02d. %s" tracknum title
"Year"     -> year ? year > "1000" & year < "2008" -> artist -> album -> title = "%02d. %s" tracknum title
"Search..." ==> "search"
"Most played tracks" -> title = "(%3d) %s" playcount title %sort = "inverse" %limit = "100" ? playcount > "0"
"Never played tracks" -> artist ? playcount == "0" -> album -> title = "%02d. %s" tracknum title
"Best tracks" -> artist ? playcount > "1" & autoscore > "85" -> album -> title = "%02d. %s (%3d)" tracknum title autoscore
"List played tracks" -> title = "(%3d/%d) %s" autoscore playcount title ? playcount > "0"
"Artist @ A" -> artist ? artist ^ "A"  -> album -> title = "%02d. %s" tracknum title
"Artist @ B" -> artist ? artist ^ "B"  -> album -> title = "%02d. %s" tracknum title
"Artist @ C" -> artist ? artist ^ "C"  -> album -> title = "%02d. %s" tracknum title
"Artist @ D" -> artist ? artist ^ "D"  -> album -> title = "%02d. %s" tracknum title
"Artist @ E" -> artist ? artist ^ "E"  -> album -> title = "%02d. %s" tracknum title
"Artist @ F" -> artist ? artist ^ "F"  -> album -> title = "%02d. %s" tracknum title
"Artist @ G" -> artist ? artist ^ "G"  -> album -> title = "%02d. %s" tracknum title
"Artist @ H" -> artist ? artist ^ "H"  -> album -> title = "%02d. %s" tracknum title
"Artist @ I" -> artist ? artist ^ "I"  -> album -> title = "%02d. %s" tracknum title
"Artist @ J" -> artist ? artist ^ "J"  -> album -> title = "%02d. %s" tracknum title
"Artist @ K" -> artist ? artist ^ "K"  -> album -> title = "%02d. %s" tracknum title
"Artist @ L" -> artist ? artist ^ "L"  -> album -> title = "%02d. %s" tracknum title
"Artist @ M" -> artist ? artist ^ "M"  -> album -> title = "%02d. %s" tracknum title
"Artist @ N" -> artist ? artist ^ "N"  -> album -> title = "%02d. %s" tracknum title
"Artist @ O" -> artist ? artist ^ "O"  -> album -> title = "%02d. %s" tracknum title
"Artist @ P" -> artist ? artist ^ "P"  -> album -> title = "%02d. %s" tracknum title
"Artist @ Q" -> artist ? artist ^ "Q"  -> album -> title = "%02d. %s" tracknum title
"Artist @ R" -> artist ? artist ^ "R"  -> album -> title = "%02d. %s" tracknum title
"Artist @ S" -> artist ? artist ^ "S"  -> album -> title = "%02d. %s" tracknum title
"Artist @ T" -> artist ? artist ^ "T"  -> album -> title = "%02d. %s" tracknum title
"Artist @ U" -> artist ? artist ^ "U"  -> album -> title = "%02d. %s" tracknum title
"Artist @ V" -> artist ? artist ^ "V"  -> album -> title = "%02d. %s" tracknum title
"Artist @ W" -> artist ? artist ^ "W"  -> album -> title = "%02d. %s" tracknum title
"Artist @ X" -> artist ? artist ^ "X"  -> album -> title = "%02d. %s" tracknum title
"Artist @ Y" -> artist ? artist ^ "Y"  -> album -> title = "%02d. %s" tracknum title
"Artist @ Z" -> artist ? artist ^ "Z"  -> album -> title = "%02d. %s" tracknum title

# And finally set main menu as our root menu
%root_menu "main"

[roolku]

Only later I realized that my heavily modified tagnavi.config

'"heavily"? Don't you mean "slightly" ?  

Just kidding - thanks for sharing.

I have attached my work in progress.

now need a different syntax.

Yes, I am not to fond of the "-->", but the submenus are a blessing.

Is there any documentation that describes v2.0 tagnavi.config format in detail?

When I am having more time next month I was planning to update the wiki (unless someone beats me to it).

[attachment deleted by admin, too old]

[rADo]

'"heavily"? Don't you mean "slightly" ?  

Yes, this one is very light mod Previous one was way better, but I have no docs for v2.0 syntax, that is why I am asking for it..

Btw, I like your menu. Thank you!

[rADo]

Ok, I am happy with this file:

Code: [Select]

#! rockbox/tagbrowser/2.0
# ^ Version header must be the first line of every file

# search sub menu
%menu_start "search" "Search by..."
"Artist" -> artist ? artist ~ "" -> album -> title = "%02d. %s" tracknum title
"Album" -> album ? album ~ "" -> title = "%02d. %s" tracknum title
"Title" -> title ? title ~ ""
"Filename" -> filename ? filename ~ ""
"Score" -> title = "(%3d) %s" autoscore title ? autoscore > ""

# artists sub menu
%menu_start "byartist" "Artists A-Z"
"Artist @ A" -> artist ? artist ^ "A"  -> album -> title = "%02d. %s" tracknum title
"Artist @ B" -> artist ? artist ^ "B"  -> album -> title = "%02d. %s" tracknum title
"Artist @ C" -> artist ? artist ^ "C"  -> album -> title = "%02d. %s" tracknum title
"Artist @ D" -> artist ? artist ^ "D"  -> album -> title = "%02d. %s" tracknum title
"Artist @ E" -> artist ? artist ^ "E"  -> album -> title = "%02d. %s" tracknum title
"Artist @ F" -> artist ? artist ^ "F"  -> album -> title = "%02d. %s" tracknum title
"Artist @ G" -> artist ? artist ^ "G"  -> album -> title = "%02d. %s" tracknum title
"Artist @ H" -> artist ? artist ^ "H"  -> album -> title = "%02d. %s" tracknum title
"Artist @ I" -> artist ? artist ^ "I"  -> album -> title = "%02d. %s" tracknum title
"Artist @ J" -> artist ? artist ^ "J"  -> album -> title = "%02d. %s" tracknum title
"Artist @ K" -> artist ? artist ^ "K"  -> album -> title = "%02d. %s" tracknum title
"Artist @ L" -> artist ? artist ^ "L"  -> album -> title = "%02d. %s" tracknum title
"Artist @ M" -> artist ? artist ^ "M"  -> album -> title = "%02d. %s" tracknum title
"Artist @ N" -> artist ? artist ^ "N"  -> album -> title = "%02d. %s" tracknum title
"Artist @ O" -> artist ? artist ^ "O"  -> album -> title = "%02d. %s" tracknum title
"Artist @ P" -> artist ? artist ^ "P"  -> album -> title = "%02d. %s" tracknum title
"Artist @ Q" -> artist ? artist ^ "Q"  -> album -> title = "%02d. %s" tracknum title
"Artist @ R" -> artist ? artist ^ "R"  -> album -> title = "%02d. %s" tracknum title
"Artist @ S" -> artist ? artist ^ "S"  -> album -> title = "%02d. %s" tracknum title
"Artist @ T" -> artist ? artist ^ "T"  -> album -> title = "%02d. %s" tracknum title
"Artist @ U" -> artist ? artist ^ "U"  -> album -> title = "%02d. %s" tracknum title
"Artist @ V" -> artist ? artist ^ "V"  -> album -> title = "%02d. %s" tracknum title
"Artist @ W" -> artist ? artist ^ "W"  -> album -> title = "%02d. %s" tracknum title
"Artist @ X" -> artist ? artist ^ "X"  -> album -> title = "%02d. %s" tracknum title
"Artist @ Y" -> artist ? artist ^ "Y"  -> album -> title = "%02d. %s" tracknum title
"Artist @ Z" -> artist ? artist ^ "Z"  -> album -> title = "%02d. %s" tracknum title

# albums sub menu
%menu_start "byalbum" "Albums A-Z"
"Album @ A" -> album ? album ^ "A"  -> title = "%02d. %s" tracknum title
"Album @ B" -> album ? album ^ "B"  -> title = "%02d. %s" tracknum title
"Album @ C" -> album ? album ^ "C"  -> title = "%02d. %s" tracknum title
"Album @ D" -> album ? album ^ "D"  -> title = "%02d. %s" tracknum title
"Album @ E" -> album ? album ^ "E"  -> title = "%02d. %s" tracknum title
"Album @ F" -> album ? album ^ "F"  -> title = "%02d. %s" tracknum title
"Album @ G" -> album ? album ^ "G"  -> title = "%02d. %s" tracknum title
"Album @ H" -> album ? album ^ "H"  -> title = "%02d. %s" tracknum title
"Album @ I" -> album ? album ^ "I"  -> title = "%02d. %s" tracknum title
"Album @ J" -> album ? album ^ "J"  -> title = "%02d. %s" tracknum title
"Album @ K" -> album ? album ^ "K"  -> title = "%02d. %s" tracknum title
"Album @ L" -> album ? album ^ "L"  -> title = "%02d. %s" tracknum title
"Album @ M" -> album ? album ^ "M"  -> title = "%02d. %s" tracknum title
"Album @ N" -> album ? album ^ "N"  -> title = "%02d. %s" tracknum title
"Album @ O" -> album ? album ^ "O"  -> title = "%02d. %s" tracknum title
"Album @ P" -> album ? album ^ "P"  -> title = "%02d. %s" tracknum title
"Album @ Q" -> album ? album ^ "Q"  -> title = "%02d. %s" tracknum title
"Album @ R" -> album ? album ^ "R"  -> title = "%02d. %s" tracknum title
"Album @ S" -> album ? album ^ "S"  -> title = "%02d. %s" tracknum title
"Album @ T" -> album ? album ^ "T"  -> title = "%02d. %s" tracknum title
"Album @ U" -> album ? album ^ "U"  -> title = "%02d. %s" tracknum title
"Album @ V" -> album ? album ^ "V"  -> title = "%02d. %s" tracknum title
"Album @ W" -> album ? album ^ "W"  -> title = "%02d. %s" tracknum title
"Album @ X" -> album ? album ^ "X"  -> title = "%02d. %s" tracknum title
"Album @ Y" -> album ? album ^ "Y"  -> title = "%02d. %s" tracknum title
"Album @ Z" -> album ? album ^ "Z"  -> title = "%02d. %s" tracknum title

# titles sub menu
%menu_start "bytitle" "Titles A-Z"
"Title @ A" -> title ? title ^ "A"
"Title @ B" -> title ? title ^ "B"
"Title @ C" -> title ? title ^ "C"
"Title @ D" -> title ? title ^ "D"
"Title @ E" -> title ? title ^ "E"
"Title @ F" -> title ? title ^ "F"
"Title @ G" -> title ? title ^ "G"
"Title @ H" -> title ? title ^ "H"
"Title @ I" -> title ? title ^ "I"
"Title @ J" -> title ? title ^ "J"
"Title @ K" -> title ? title ^ "K"
"Title @ L" -> title ? title ^ "L"
"Title @ M" -> title ? title ^ "M"
"Title @ N" -> title ? title ^ "N"
"Title @ O" -> title ? title ^ "O"
"Title @ P" -> title ? title ^ "P"
"Title @ Q" -> title ? title ^ "Q"
"Title @ R" -> title ? title ^ "R"
"Title @ S" -> title ? title ^ "S"
"Title @ T" -> title ? title ^ "T"
"Title @ U" -> title ? title ^ "U"
"Title @ V" -> title ? title ^ "V"
"Title @ W" -> title ? title ^ "W"
"Title @ X" -> title ? title ^ "X"
"Title @ Y" -> title ? title ^ "Y"
"Title @ Z" -> title ? title ^ "Z"

# decades sub menu
%menu_start "bydecades" "Decades"
""-> artist ? year == "0"                    -> album -> title = "%02d %s" tracknum title
"sixties"   -> artist ? year >= "1960" & year < "1970" -> album -> title = "%02d %s" tracknum title
"seventies" -> artist ? year >= "1970" & year < "1980" -> album -> title = "%02d %s" tracknum title
"eighties"  -> artist ? year >= "1980" & year < "1990" -> album -> title = "%02d %s" tracknum title
"nineties"  -> artist ? year >= "1990" & year < "2000" -> album -> title = "%02d %s" tracknum title
"2000ties"  -> artist ? year >= "2000" & year < "2010" -> album -> title = "%02d %s" tracknum title

# main menu
%menu_start "main" "Browse by..."
"Artists A-Z" ==> "byartist"
"Albums A-Z" ==> "byalbum"
"Titles A-Z" ==> "bytitle"
"Genres"    -> genre    -> artist -> album -> title = "%02d. %s" tracknum title
"Decades" ==> "bydecades"
"All Artists"   -> artist   -> album  -> title = "%02d. %s" tracknum title
"All Albums"    -> album    -> title = "%02d. %s" tracknum title
"Browse by Year"     -> year ? year > "1000" & year < "2008" -> artist -> album -> title = "%02d. %s" tracknum title
"Most played tracks" -> title = "(%3d) %s" playcount title %sort = "inverse" %limit = "100" ? playcount > "0"
"Never played tracks" -> artist ? playcount == "0" -> album -> title = "%02d. %s" tracknum title
"Best tracks" -> artist ? playcount > "1" & autoscore > "85" -> album -> title = "%02d. %s (%3d)" tracknum title autoscore
"List played tracks" -> title = "(%3d/%d) %s" autoscore playcount title ? playcount > "0"
"Search..." ==> "search"

# And finally set main menu as our root menu
%root_menu "main"

[xlarge]

...I have attached my work in progress...

Just FYI my x5 doesn't boot with your tagnavi.config.

Don't know why yet...


edit; it does boot, but doesn't show me any interface... just freezes at the logotype.

[roolku]

...I have attached my work in progress...

Just FYI my x5 doesn't boot with your tagnavi.config.

Don't know why yet...


edit; it does boot, but doesn't show me any interface... just freezes at the logotype.

I suspect you are running an old build? Slasheri fixed the hang if there are more then 8 menus.

21 Sep 17:16   Miika Pekkarinen   apps/tagtree.c 1.41
apps/tagtree.h 1.11    Increased maximum number of menus to 16 and avoiding a crash.

[xlarge]

Haha.. So true!

For the first time since may i've NOT updated my x5 to bleeding edge every day (was partying in denmark during weekend instead) and i was running cvs: 060920-2007... Now i'm running 060925-1955 - and i'm delighted by your way of thinking and organizing menues - thank you.

[nugget]

does  your tagnavi also include numbers as i can only see letters (but im prob blind  )

[bascule]

Well, I'm really struggling getting this to work and would really appreciate some help...

I using build CVS-060927-0216 on an H120 with the default version of tagnavi.config

It contains this line:

Code: [Select]

"Custom view..."  ==> "custom"

However, this option does not appear in my Tag Cache menu. Thinking it might be smart enough to display only if the 'custom' menu exists, I created the following simple tagnavi_custom.config file (using Notepad, saving as UTF-8) from roolku's example above:

Code: [Select]

#! rockbox/tagbrowser/2.0
# roolku v0.1

%menu_start "artist_initial" "artist initial"
"A"   -> artist ? artist ^ "A" -> album  -> title = "%02d %s" tracknum title
"B"   -> artist ? artist ^ "B" -> album  -> title = "%02d %s" tracknum title
"C"   -> artist ? artist ^ "C" -> album  -> title = "%02d %s" tracknum title
"X"   -> artist ? artist ^ "X" -> album  -> title = "%02d %s" tracknum title
"Y"   -> artist ? artist ^ "Y" -> album  -> title = "%02d %s" tracknum title
"Z"   -> artist ? artist ^ "Z" -> album  -> title = "%02d %s" tracknum title

%menu_start "other" "other"
"find file"    -> title ? filename ~ ""
"ogg"          -> album ? filename $ ".ogg" -> title = "%02d %s" tracknum title
"not mp3/ogg"  -> album ? filename !$ ".ogg" & filename !$ ".mp3"-> title = "%02d %s" tracknum title 
"low Bitrate"  -> title = "%03d %s" bitrate title %sort = "inverse" ? bitrate < "128"
"high Bitrate" -> title = "%03d %s" bitrate title ? bitrate > "256"
"bad year"     -> title = "%04d %s" year title ? year > "0" & year < "1960"

%menu_start "custom" "Custom"
"Artist by initial"  ==> "artist_initial" 
"other"  ==> "other"

# EOF

Still no joy. I just cannot get a custom menu to display at all. I've modified previous versions of tagnavi.config without problems, so I don't think it's a file format issue. I have also modified the new default tagnavi.config and can see the changes I've made having an effect on the menu.

It's just that the custom menu line will not work for me  

Can anyone shed some light on this?

[xlarge]

# And finally set custom menu as our root menu
%root_menu "custom"



?


stole it from example far above

[bluebrother]

I just tried your example. Works for me, but:
when saving the file as utf-8 with BOM it doesn't work. You need to make sure to save without a BOM. Apart from that, as long as your file doesn't include characters outside of the ASCII set utf-8 is identical to ASCII, so there's no need to save it as utf-8. (Edit: the lower 127 characters of ASCII that is.)

Just remove the BOM, that worked fine for me. Notepad is really ugly when it comes to utf-8 files. I suggest using a different editor which can handle utf-8 better (I used vim and Crimson Editor).

[bascule]

# And finally set custom menu as our root menu
%root_menu "custom"

I took that option off roolku's file, because, AFAICT, that option completely replaces the default Tag Cache menu with the custom one. ATM all I am trying to do is add a custom menu to the existing list. Once I get that working I'll branch out into more esoteric stuff. I'm just frustrated that it doesn't seem to work as simply as it appears it should do.

I just tried your example. Works for me, but:
when saving the file as utf-8 with BOM it doesn't work. You need to make sure to save without a BOM. Apart from that, as long as your file doesn't include characters outside of the ASCII set utf-8 is identical to ASCII, so there's no need to save it as utf-8. (Edit: the lower 127 characters of ASCII that is.)

Just remove the BOM, that worked fine for me. Notepad is really ugly when it comes to utf-8 files. I suggest using a different editor which can handle utf-8 better (I used vim and Crimson Editor).

So, using the magic of Wikipedia, I now know what BOM is, but not yet how to remove it  Is there an easy way to do this?

I am also aware that Notepad is not the best text editor out there, but my previous dabblings in this area have always worked OK, so I made the assumption that it would be OK this time. I'll try Notepad++ or Notepad2. EDIT: Well I got it working by copying my config text into a copy of the default config file and re-saving it. I presume I got the BOM issue by copying and pasting from the forum into a new Notepad file? Not something I've come across before, but hey, you need to learn something new every day...

@ roolku - your config rocks!

As for the UTF-8, I used that because I thought, (probably incorrectly) that it fixed the LF/CR vs LF-only issue.

[bluebrother]

To remove the BOM you need to get a decent editor. In my case, I used Crimson Editor in which I can change the document encoding (Document / Encoding Type / UTF-8 w/o BOM). Of course you can also use a hex-editor and delete the first three bytes ;-) The problem is (afaik) that windows notepad simply always adds a BOM if a file is saved as utf-8. But if you don't need utf-8 you can simply save files as ASCII (which also works with notepad).
The CR/LF issue is something completely different.

[bascule]

To remove the BOM you need to get a decent editor. In my case, I used Crimson Editor in which I can change the document encoding (Document / Encoding Type / UTF-8 w/o BOM). Of course you can also use a hex-editor and delete the first three bytes ;-) The problem is (afaik) that windows notepad simply always adds a BOM if a file is saved as utf-8. But if you don't need utf-8 you can simply save files as ASCII (which also works with notepad).
The CR/LF issue is something completely different.

Our posts crossed in the ether and you can see I have managed to get it working now, but thanks for those explanations, you have been very helpful

[roolku]

@ roolku - your config rocks!

Thanks, I have attached a slightly improved version (v0.2). Also I have some more ideas, but no time to try them.


[attachment deleted by admin, too old]