Gitiles
Code Review Sign In
gerrit.rockbox.org / rockbox / eb94e0bdd761cedeb84b4eab5b55e8cb48e45ddc / . / docs / CUSTOM_WPS_FORMAT
blob: e5ce8e6026d6806b05e609d01a748f53008d2a14 [file] [log] [blame]
Justin Heiner43e7cb82002-08-22 02:26:08 +0000[diff] [blame]1Custom WPS Display
Justin Heiner52681472002-09-05 16:52:47 +0000[diff] [blame]2File Format Specifications
Justin Heiner43e7cb82002-08-22 02:26:08 +0000[diff] [blame]3
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]4Description / General Info
5--------------------------
Justin Heiner7189bf22002-08-29 05:58:23 +0000[diff] [blame]6* The Custom WPS Display is used on both the Rockbox Player and Recorder,
7 as a means to customize the WPS to the user's likings.
Justin Heinereb94e0b2002-09-06 06:14:52 +0000[diff] [blame^]8* After editing the .wps file, you may need to reboot your Rockbox.
Justin Heiner7189bf22002-08-29 05:58:23 +0000[diff] [blame]9* The file may be 2 lines long for the Player, and 6 lines for the Recorder.
10* The line that has the time displayed on it MUST NOT be the line that
11 is scrolled, or the time will not be updated.
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]12* All characters not preceded by % are displayed as typed.
13
Justin Heiner43e7cb82002-08-22 02:26:08 +0000[diff] [blame]14File Location
15-------------
Justin Heiner52681472002-09-05 16:52:47 +0000[diff] [blame]16The default configuration file must be located in the /.rockbox folder
17of the evice and must be named default.wps (lowercase). Any other Custom
18WPS files may be located anywhere on the drive. The only restriction
19is that they must end in .wps
Justin Heiner43e7cb82002-08-22 02:26:08 +0000[diff] [blame]20
21Tags
22----
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]23ID3 Info Tags:
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]24 %ia : ID3 Artist
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]25 %it : ID3 Track Title
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]26 %in : ID3 Track Number
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]27 %id : ID3 Album Name
28
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]29File Info Tags:
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]30 %fb : File Bitrate (in kbps)
31 %ff : File Frequency (in Hz)
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]32 %fp : File Path
Mats Lidell09ae8cb2002-09-01 21:13:07 +0000[diff] [blame]33 %fn : File Name (without extension)
34 %fm : File Name
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]35 %fs : File Size (In Kilobytes)
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]36 %fv : "(vbr)" if variable bit rate or "" if constant bit rate
37 %d1 : First directory from end of file path.
38 %d2 : Second directory from end of file path.
39 %d2 : Third directory from end of file path.
40
41Example for the the %dN commands: If the path is "/Rock/Kent/Isola/11 -
42747.mp3", %d1 is "Isola", %d2 is "Kent"... You get the picture.
43
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]44Playlist/Song Info Tags:
Justin Heiner44a0b5d2002-08-31 04:59:57 +0000[diff] [blame]45 %pb : Progress Bar (Player ONLY)
46 This will display a 1 character "cup" that empties as the song goes
47 forward.
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]48 %pp : Playlist Position
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]49 %pe : Total Number of Playlist Entries
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]50 %pc : Current Time In Song
Justin Heiner87f53242002-08-30 03:08:02 +0000[diff] [blame]51 %pr : Remaining Time In Song
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]52 %pt : Total Track Time
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]53
54Conditional Tags (If/Else block):
55 %?xx<|> : Conditional: if the tag specified by "xx" has a value, the
56 text between the "<" and the "|" is displayed, else the text
57 between the "|" and the ">" is displayed.
58 The else part is optional, so the "|" does not have to be
59 specified if no else part is desired. The conditionals nest,
60 so the text in the if and else part can contain all %
61 commands, including conditionals.
62
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]63Other Tags:
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]64 %% : Display a '%'
65 %< : Display a '<'
66 %| : Display a '|'
67 %> : Display a '>'
68 %s : Indicate that the line should scroll. Can occur anywhere in
69 a line (given that the text is displayed; see conditional
70 below). Only the first line with a %s will actually scroll.
71 %s is ignored if combined with %pb, %pc or %pr on the same
72 line (the result wouldn't be good anyway).
Justin Heiner43e7cb82002-08-22 02:26:08 +0000[diff] [blame]73
Justin Heinereb94e0b2002-09-06 06:14:52 +0000[diff] [blame^]74Example File
75------------
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]76%s%?in<%in - >%?it<%it|%fn> %?ia<[%ia%?id<, %id>]>
77%pb%pc/%pt
Justin Heinera7a46c72002-08-27 01:05:19 +0000[diff] [blame]78
Björn Stenberg862813d2002-09-01 20:00:05 +0000[diff] [blame]79That is, "tracknum - title [artist, album]", where most fields are only
80displayed if available. Could also be rendered as "filename" or
81"tracknum - title [artist]".